Skip to content

master5d/evernote-enerv

Repository files navigation

evernote-enerv

Agent-first Evernote tool on the official EDAM API. No developer key needed — authorize once via OAuth in your real browser (the same path Notion's "Import from Evernote" uses), get a ~1-year token, and call the official NoteStore/UserStore API.

Built after Evernote (a) stopped issuing developer tokens / API keys and (b) started blocking automated-browser logins with bot-detection. OAuth from a real browser sidesteps both.

Install

pip install -e .

Auth (once)

evernote-enerv login      # opens your real browser; authorize; token saved to ~/.evernote-enerv/token (0600)

No password is ever handled by this tool — only the resulting OAuth token is stored. Alternatively set EVERNOTE_TOKEN=<token> in the environment.

Use

evernote-enerv account info
evernote-enerv notebook list
evernote-enerv note search "intitle:Q4" --limit 20
evernote-enerv note get <guid>
evernote-enerv note create --title "Idea" --content-text "..." [--notebook Work]

All output is JSON: {success, command, data|error, timestamp, requestId}. Exit code 0 = success, 1 = non-recoverable error, 2 = recoverable (retry).

MCP (Claude Code / Claude Desktop)

claude mcp add-json evernote-enerv '{"type":"stdio","command":"<abs-path>/.venv/Scripts/evernote-enerv-mcp.exe"}'

Tools: evernote_search, evernote_get_note, evernote_create_note, evernote_list_notebooks, evernote_account_info.

Scope

MVP: search, read, create notes; list notebooks; account info. Phase 2 (not yet): update/delete/move notes, tags, notebook CRUD, USN conflict handling.

How auth works

evernote-enerv login runs OAuth 1.0a using evernote-backup's bundled consumer key + a localhost callback server, opening the authorize URL in your default browser. See docs/superpowers/specs/2026-06-05-evernote-cli-oauth-edam-design.md.

License

MIT

About

Agent-first Python CLI for the Evernote Cloud API (EDAM) — JSON output and explicit error codes, built for AI agents and humans.

Topics

Resources

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages