evernote-mcp 0.2.0

Model Context Protocol (MCP) server for Evernote operations

Evernote MCP Server

English | 简体中文

Model Context Protocol (MCP) server for Evernote - enables Claude Code to interact with your Evernote notes.

Supports both International Evernote and Yinxiang Biji (印象笔记)

Features

• Notebook operations (create, update, delete, list)
• Note operations (create, read, update, delete, copy, move)
• Full-text search using Evernote's search syntax
• Multiple output formats (ENML, text, markdown, JSON)

Installation

npm install -g @anthropic/claude-code
uvx evernote-mcp

Configuration

1. Get Evernote Developer Token

International Evernote: https://evernote.com/api/DeveloperToken.action

Yinxiang Biji (印象笔记): https://app.yinxiang.com/api/DeveloperToken.action

2. Configure Claude Code

Edit ~/.config/claude-code/config.json:

For International Evernote:

{
  "mcpServers": {
    "evernote": {
      "command": "uvx",
      "args": ["evernote-mcp"],
      "env": {
        "EVERNOTE_AUTH_TOKEN": "your_token_here",
        "EVERNOTE_BACKEND": "evernote"
      }
    }
  }
}

For Yinxiang Biji (印象笔记):

{
  "mcpServers": {
    "evernote": {
      "command": "uvx",
      "args": ["evernote-mcp"],
      "env": {
        "EVERNOTE_AUTH_TOKEN": "your_token_here",
        "EVERNOTE_BACKEND": "china"
      }
    }
  }
}

Usage Examples

claude-code

User: Create a note in my "Project Notes" notebook summarizing the current TODO items from src/todo.py

Claude: I'll read the TODO file and create a note for you.
[Creates note with extracted TODOs]

User: Search my Evernote for notes about "API design" and summarize the key points

Claude: Let me search for those notes and analyze them.
[Searches and summarizes findings]

User: Create a notebook called "Code Reviews" and add a note template

Claude: I'll set that up for you.
[Creates notebook and template note]

Environment Variables

Variable	Default	Description
EVERNOTE_AUTH_TOKEN	-	Your developer token (required)
EVERNOTE_BACKEND	evernote	evernote (International) or china (印象笔记)

Available Tools

Notebooks

• create_notebook(name, stack) - Create notebook
• list_notebooks() - List all notebooks
• get_notebook(guid) - Get notebook details
• update_notebook(guid, name, stack) - Update notebook
• delete_notebook(guid) - Delete notebook

Notes

• create_note(title, content, notebook_guid, tags) - Create note
• get_note(guid, output_format) - Get note (enml/text/markdown/json)
• update_note(guid, title, content) - Update note
• delete_note(guid) - Move to trash
• copy_note(guid, target_notebook_guid) - Copy note
• move_note(guid, target_notebook_guid) - Move note
• list_notes(notebook_guid, limit) - List notes

Search

• search_notes(query, notebook_guid) - Search notes
• list_tags() - List all tags

License

MIT