evernote

This MCP server exposes an Evernote integration that lets Claude Desktop (or any MCP-compatible LLM) query your Evernote data locally. It supports read-only access to your notes via MCP methods such as createSearch, getNote, and getNoteContent, enabling natural language queries like “Show me notes about Project X” or “Summarize notes from last month.” The server runs with HTTPS for secure local communication and persists OAuth tokens in a .env file for seamless re-authentication. To connect an LLM, point your MCP client at the local server endpoint and use the defined MCP methods to perform searches, fetch note metadata, or retrieve full note content. The Docker-based setup also supports remote integration modes and automatic SSL handling if you opt for containerized deployment.

Prerequisites

• Node.js 18+ installed on your machine
• Docker and/or Docker Compose (recommended for production deployment)
• Evernote developer account with API credentials (Consumer Key and Consumer Secret)
• Optional: OpenSSL for local SSL certificates during development

Initial setup (local development)

1. Clone the repository and install dependencies

git clone https://github.com/brentmid/evernote-mcp-server.git
cd evernote-mcp-server
npm install

2. Create a local .env file and populate your Evernote credentials

cp .env.example .env
# Edit .env and insert your EVERNOTE_CONSUMER_KEY and EVERNOTE_CONSUMER_SECRET

3. Start the server locally (HTTPS)

npm run start

Docker deployment (recommended for production)

1. Ensure Docker is installed and docker-compose is available
2. Copy example env and adjust credentials

cp .env.example .env

3. Build and start the container stack

docker-compose up --build

Prerequisites recap

• Have Evernote API credentials ready
• Ensure SSL certificates or auto-generated certs for HTTPS
• Ensure the MCP server can reach the Evernote API from your environment

Tips and common considerations:

• Secure credentials: Tokens are stored in the .env file; ensure this file is not committed to version control.
• DEV_MODE can be enabled to output debug information; ensure sensitive data is redacted in logs.
• If using Docker, Chainguard base images are used for a minimal attack surface; ensure your host can access the required ports (default HTTPS port 443 or container-mapped port).
• The MCP endpoints you’ll use with Claude Desktop include createSearch (to perform natural-language searches over notes), getNote (to retrieve note metadata), and getNoteContent (to fetch full note content).
• If you encounter OAuth token expiration, the server supports interactive re-authentication prompts and automatic token refresh/persistence to .env.
• For production, restrict endpoint exposure to localhost or a trusted network and consider adding your own reverse proxy in front of the MCP server.