MCP Evernote Server
A Model Context Protocol (MCP) server that provides seamless integration with Evernote for note management, organization, and knowledge capture. Works with both Claude Code and Claude Desktop.
Power your agent
पब्लिशर की अपनी कमांड। PlugMCP एंडपॉइंट नहीं।
Host a copy with our keys and logs.
npx -y @avinsonmassif/[email protected]Claude Code में लोकल कमांड के लिए इंस्टॉल लिंक नहीं है। नीचे दी गई कमांड कॉपी करें और टर्मिनल में चलाएँ।
claude mcp add avinsonmassif-mcp-evernote -- npx -y @avinsonmassif/mcp-evernote@1.3.1टर्मिनल में चलाएँ।
{ "mcpServers": { "avinsonmassif-mcp-evernote": { "command": "npx", "args": [ "-y", "@avinsonmassif/[email protected]" ] } }}claude_desktop_config.json
रिमोट URL या आपकी मशीन पर कमांड? दोनों इंस्टॉल में क्या अंतर है
PlugMCP पर चलाएँ
A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.
लॉन्चपब्लिशर से
This is a fork of verygoodplugins/mcp-evernote with two additions:
/mcp commandThe simplest way - no need to install anything globally:
# For Claude Desktop - Run authentication
npx -y -p @avinsonmassif/mcp-evernote mcp-evernote-auth
# For Claude Code - Just add the server
claude mcp add evernote "npx -y -p @avinsonmassif/mcp-evernote mcp-evernote"
The server can poll Evernote for changes and send webhook notifications when notes are created, updated, or deleted.
# Enable auto-start polling (default: false)
EVERNOTE_POLLING_ENABLED=true
# Poll interval in milliseconds (default: 3600000 = 1 hour, min: 900000 = 15 min)
EVERNOTE_POLL_INTERVAL=3600000
# Webhook URL to receive change notifications
EVERNOTE_WEBHOOK_URL=https://your-endpoint.com/webhooks/evernote
When changes are detected, a POST request is sent to your webhook URL:
{
"source": "mcp-evernote",
"timestamp": "2025-12-15T10:30:00.000Z",
"changes": [
{
"type": "note_created",
"guid": "abc123...",
"title": "My New Note",
"notebookGuid": "def456...",
"timestamp": "2025-12-15T10:29:55.000Z"
}
]
}
Use these tools to control polling:
evernote_start_polling - Start polling manuallyevernote_stop_polling - Stop pollingevernote_poll_now - Check for changes immediatelyevernote_polling_status - Get polling configuration and statusFor real-time notifications, Evernote supports webhooks but requires manual registration:
Email [email protected] with:
They'll configure your webhook to receive HTTP GET requests on note create/update events.
Install once, use anywhere:
# Install globally
npm install -g @avinsonmassif/mcp-evernote
# For Claude Desktop - Run authentication
mcp-evernote-auth
# For Claude Code - Add the server
claude mcp add evernote "mcp-evernote"
For contributing or customization:
# Clone and install
git clone https://github.com/avinsonmassif/mcp-evernote.git
cd mcp-evernote
npm install
# Run setup wizard
npm run setup
The auth script will prompt you for credentials if not found:
# Run authentication - prompts for API keys if needed
npx -p @avinsonmassif/mcp-evernote mcp-evernote-auth
For automation, you can set credentials via environment variables:
# Create .env file (optional)
EVERNOTE_CONSUMER_KEY=your-consumer-key
EVERNOTE_CONSUMER_SECRET=your-consumer-secret
EVERNOTE_ENVIRONMENT=production # or 'sandbox'
OAUTH_CALLBACK_PORT=3000 # Default: 3000
# Polling configuration (optional)
EVERNOTE_POLLING_ENABLED=true # Auto-start polling
EVERNOTE_POLL_INTERVAL=3600000 # 1 hour (min: 900000 = 15 min)
EVERNOTE_WEBHOOK_URL=https://your-endpoint.com/webhooks/evernote # Webhook for change notifications
claude mcp add evernote "npx -y -p @avinsonmassif/mcp-evernote -c mcp-evernote" \
--env EVERNOTE_CONSUMER_KEY=your-key \
--env EVERNOTE_CONSUMER_SECRET=your-secret
/mcpNote: Claude Code handles OAuth automatically - no manual token management needed!
Using NPX (no installation required):
npx -y -p @avinsonmassif/mcp-evernote mcp-evernote-auth
The auth script will:
.evernote-token.jsonOr if installed globally:
mcp-evernote-auth
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"evernote": {
"command": "npx",
"args": ["-y", "-p", "@avinsonmassif/mcp-evernote", "-c", "mcp-evernote"],
"env": {
"EVERNOTE_CONSUMER_KEY": "your-consumer-key",
"EVERNOTE_CONSUMER_SECRET": "your-consumer-secret",
"EVERNOTE_ENVIRONMENT": "production"
}
}
}
}
Or if installed globally:
{
"mcpServers": {
"evernote": {
"command": "mcp-evernote",
"env": {
"EVERNOTE_CONSUMER_KEY": "your-consumer-key",
"EVERNOTE_CONSUMER_SECRET": "your-consumer-secret"
}
}
}
}
Claude Code handles OAuth automatically via the /mcp command. Tokens are managed by Claude Code.
Run npx -y -p @avinsonmassif/mcp-evernote mcp-evernote-auth to authenticate via browser. Token saved to .evernote-token.json.
EVERNOTE_ACCESS_TOKEN=your-token
EVERNOTE_NOTESTORE_URL=your-notestore-url
{
"env": {
"EVERNOTE_ACCESS_TOKEN": "your-access-token",
"EVERNOTE_NOTESTORE_URL": "your-notestore-url"
}
}
Evernote stopped issuing new API developer keys. If you can't obtain a CONSUMER_KEY / CONSUMER_SECRET, use evertoken mode instead. It extracts a valid token directly from the Evernote desktop app's local encrypted storage — no developer key needed.
.\evertoken.exe new
Copy the Refresh Token (JWT) and Client ID values from the output.
{
"mcpServers": {
"evernote": {
"command": "node",
"args": ["/path/to/mcp-evernote/dist/index.js"],
"env": {
"EVERNOTE_AUTH_MODE": "evertoken",
"EVERNOTE_SEED_NRT": "<Refresh Token (JWT)>",
"EVERNOTE_SEED_NCI": "<Client ID>",
"EVERNOTE_DEVICE_ID": "<generate once: node -e \"console.log(require('crypto').randomUUID())\">"
}
}
}
}
*Can alternatively be stored in a JSON file at MCP_EVERNOTE_SEED_PATH with { "nrt": "...", "nci": "..." }.
The JWT refresh token rotates on every use. The current token is saved to state.json (MCP_EVERNOTE_STATE_PATH). If that file is lost, the server will attempt a fresh refresh using the original EVERNOTE_SEED_NRT — this works until that token has itself been rotated out. For Docker deployments, always mount a volume for the state path (see below).
This server automatically converts between Markdown and Evernote's ENML format:
<en-note>.
- [ ] map to Evernote checkboxes <en-todo/>.- [x] map to <en-todo checked="true"/>. or file://...) are uploaded as Evernote resources automatically.evernote-resource:<hash> in Markdown.http(s) images remain links (download locally if you want them embedded). and other files become [file](evernote-resource:<hash>) so you can round-trip them safely.Limitations:
evernote-resource:<hash> references in Markdown if you want existing attachments to survive edits.evernote_create_noteCreate a new note in Evernote.
Parameters:
title (required): Note titlecontent (required): Note content (plain text or markdown)notebookName (optional): Target notebook nametags (optional): Array of tag namesExample:
Create a note titled "Meeting Notes" with content "Discussed Q4 planning" in notebook "Work" with tags ["meetings", "planning"]
evernote_search_notesSearch for notes using Evernote's search syntax.
Parameters:
query (required): Search querynotebookName (optional): Limit to specific notebookmaxResults (optional): Maximum results (default: 20, max: 100)Example:
Search for notes containing "project roadmap" in the "Work" notebook
evernote_get_noteRetrieve a specific note by GUID.
Parameters:
guid (required): Note GUIDincludeContent (optional): Include note content (default: true)Returned Markdown represents embedded resources with
evernote-resource:<hash>URLs. Leave those references intact so attachments stay linked when you edit the note.
evernote_update_noteUpdate an existing note.
Parameters:
guid (required): Note GUIDtitle (optional): New titlecontent (optional): New contenttags (optional): New tags (replaces existing)evernote_delete_noteDelete a note.
Parameters:
guid (required): Note GUIDevernote_list_notebooksList all notebooks in your account.
evernote_create_notebookCreate a new notebook.
Parameters:
name (required): Notebook namestack (optional): Stack name for organizationevernote_list_tagsList all tags in your account.
evernote_create_tagCreate a new tag.
Parameters:
name (required): Tag nameparentTagName (optional): Parent tag for hierarchyevernote_get_user_infoGet current user information and quota usage.
evernote_revoke_authRevoke stored authentication token.
evernote_health_checkCheck the health and status of the Evernote MCP server.
Parameters:
verbose (optional): Include detailed diagnostic information (default: false)Returns:
Example:
Check Evernote connection health with verbose details
evernote_reconnectForce reconnection to Evernote. Useful when experiencing "Not connected" errors.
Use this when:
Example:
Reconnect to Evernote
evernote_start_pollingStart polling for Evernote changes. Checks for new/updated/deleted notes and sends notifications to the configured webhook URL.
Example:
Start polling for Evernote changes
evernote_stop_pollingStop the polling process.
evernote_poll_nowCheck for changes immediately without waiting for the next poll interval. Returns a list of detected changes.
Example:
Check for Evernote changes now
evernote_polling_statusGet the current polling configuration and status, including:
Evernote supports advanced search operators:
intitle:keyword - Search in titlesnotebook:name - Search in specific notebooktag:tagname - Search by tagcreated:20240101 - Search by creation dateupdated:day-1 - Recently updated notesresource:image/* - Notes with imagestodo:true - Notes with checkboxes-tag:archive - Exclude archived notesThis MCP server works seamlessly with the Claude Automation Hub for workflow automation:
// Example workflow tool
export default {
name: 'capture-idea',
description: 'Capture an idea to Evernote',
handler: async ({ idea, category }) => {
// The MCP server handles the Evernote integration
return {
tool: 'evernote_create_note',
args: {
title: `Idea: ${new Date().toISOString().split('T')[0]}`,
content: idea,
notebookName: 'Ideas',
tags: [category, 'automated']
}
};
}
};
To enable synchronization with MCP memory service:
MCP_MEMORY_SERVICE_URL=http://localhost:8765
Sync my "Important Concepts" notebook to memory for long-term retention
The server includes automatic recovery from connection issues:
If you see "Not connected" errors, the server will usually recover automatically. You can also:
Try the reconnect tool (fastest):
Reconnect to Evernote
Check server health:
Check Evernote connection health with verbose details
Re-authenticate if needed:
/mcp → Evernote → Authenticatenpx -p @avinsonmassif/mcp-evernote mcp-evernote-authFor detailed information about connection issues and recovery, see CONNECTION_TROUBLESHOOTING.md.
This means you haven't authenticated yet. Run the authentication script:
npx -p @avinsonmassif/mcp-evernote mcp-evernote-auth
Or if installed globally:
mcp-evernote-auth
If the OAuth callback doesn't work:
OAUTH_CALLBACK_PORT in .env)If your token expires, the server will now detect this automatically and prompt you to re-authenticate:
/mcp command to re-authenticatenpx -p @avinsonmassif/mcp-evernote mcp-evernote-authOr use the reconnect tool to force immediate retry:
Reconnect to Evernote
The server now handles most connection errors automatically:
If issues persist:
Evernote API has rate limits. If you encounter limits:
Run the server in a Docker container behind mcp-auth-proxy, which handles HTTPS and authentication for you. This is the recommended approach for self-hosted setups — no Evernote developer key required.
.\evertoken.exe new
Copy Refresh Token (JWT) → EVERNOTE_SEED_NRT and Client ID → EVERNOTE_SEED_NCI.
cp .env.example .env
Fill in your .env:
# mcp-auth-proxy
MCP_PASSWORD=your-strong-password
MCP_EXTERNAL_URL=https://mcp-evernote.yourdomain.com
# Evertoken seed (from evertoken.exe new)
EVERNOTE_SEED_NRT=eyJ...
EVERNOTE_SEED_NCI=3FE74DA6-...
# Device ID — generate once, keep stable
# node -e "console.log(require('crypto').randomUUID())"
EVERNOTE_DEVICE_ID=xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
docker compose up -d --build
The Dockerfile builds both mcp-auth-proxy (from source) and mcp-evernote in a single image. The entrypoint wrapper passes your docker compose command: flags to the proxy and appends -- node /app/dist/index.js automatically.
Point your Claude Desktop or Claude Code config at the proxy URL:
{
"mcpServers": {
"evernote": {
"type": "sse",
"url": "https://mcp-evernote.yourdomain.com/sse",
"headers": {
"Authorization": "Bearer your-strong-password"
}
}
}
}
The rotating JWT refresh token is saved to /data/mcp-evernote/state.json inside the container. The docker-compose.yml mounts a named volume (evernote-state) at that path so the token survives container restarts and image upgrades.
If the volume is lost, the server recovers automatically on next start using
EVERNOTE_SEED_NRT— as long as that token hasn't been rotated out since the volume was last written.
npm install
npm run build
npm run dev
npm test
npm run lint
npm run format
.evernote-token.jsonContributions are welcome! Please:
develop; main is kept stable for Railway template deployments)GPL-3.0 - See LICENSE file for details.
MCP server for Evernote integration with note management and synchronization
{ "mcpServers": { "avinsonmassif-mcp-evernote": { "command": "npx", "args": [ "-y", "@avinsonmassif/[email protected]" ] } }}टूल
अभी टूल सूची नहीं है। रिमोट सर्वर को पहले हेल्थ चेक के बाद सूची मिलती है।
FAQ
इस पेज पर Cursor, Claude Desktop, Claude Code या VS Code के लिए stdio कॉन्फ़िग कॉपी करें। यह पब्लिशर का इंस्टॉल इस्तेमाल करता है, PlugMCP प्रॉक्सी नहीं।
इस रिकॉर्ड में कोई ज़रूरी एनवायरनमेंट वेरिएबल दर्ज नहीं है।
@avinsonmassif/mcp Evernote stdio पर लोकल चलता है।
पिछली जाँच 2026-11-16 को हुई। MCP server for Evernote integration with note management and synchronization