evernote

This MCP server provides a set of Evernote-related tools that can be accessed through the MCP protocol. It exposes commands to list notebooks, list and read notes, count notes, and create or update notes in Evernote. The available tools are: list_evernote_notebooks to enumerate notebooks, list_evernote_notes to list notes within a specific notebook, count_evernote_notes to get a total of notes in a notebook or account, read_evernote_note to fetch the content of a single note, read_evernote_notes to fetch multiple note contents, create_evernote_note to create a new note, and update_evernote_note to modify the content of an existing note. To use them, you connect a MCP client to this server and issue the corresponding tool commands with the required identifiers (like notebook IDs or note IDs) and content payloads as defined by the MCP protocol. Ensure you provide the EVERNOTE_API_TOKEN environment variable to authorize requests. The server will respond with the requested data or confirmation of actions performed on Evernote.

Prerequisites:

• Node.js and npm (to use npx and run MCP server via GitHub package)
• An Evernote API token (from the Evernote Developer Tokens page)

Installation steps:

1. Install Node.js and npm from the official website or via your package manager.
2. Create a project directory for the MCP server and navigate into it.
3. Create the configuration file (mcp.json) at the repository root with the following content:

{
  "evernote": {
    "command": "npx",
    "args": [
      "-y",
      "github:yasuhiroki/evernote-mcp-server"
    ],
    "env": {
      "EVERNOTE_API_TOKEN": "YOUR EVERNOTE API TOKEN"
    }
  }
}

4. Set the environment variable EVERNOTE_API_TOKEN to your Evernote API token (or include it in the mcp.json as shown).
5. Run the MCP server using your MCP client which supports the MCP protocol (the exact run command depends on your MCP client). For example, you can trigger the server via npx as configured in mcp.json, or let your MCP runner initialize using this configuration.
6. Once started, connect your MCP client to the server and begin issuing the available tools (list_evernote_notebooks, list_evernote_notes, etc.).

Notes and tips:

• Administrative scope is controlled by the EVERNOTE_API_TOKEN; ensure the token has the necessary permissions.
• If you encounter authentication or rate-limit errors from Evernote, double-check the token validity and token scope, and consider adding retry logic in your client.
• The mcp.json example shows a single server named 'evernote'; you can add additional servers under mcpServers if needed.
• If you modify the configuration, restart the MCP server to apply changes.
• Ensure your environment supports network access to Evernote services from the host running the MCP server.