Evernote MCP Server

A local MCP server that connects Claude Desktop (or any MCP-compatible LLM) with your Evernote account, allowing contextual queries and searches over your notes using natural language.

🎯 Project Goal

Enable local, secure AI-assisted access to your Evernote notes. For example:

"Summarize all my Evernotes regarding my Sea Pro boat."

This project allows the LLM to send MCP calls like createSearch, getNote, and getNoteContent, which are translated into API calls to Evernote. The response is returned to the LLM in a structured format.

🚀 What's New in v2.0+

v2.0.0: Production-Ready Docker Deployment

• 🐳 One-command setup: docker-compose up for instant deployment
• 🔐 Persistent authentication: OAuth tokens survive container restarts
• 🛡️ Security-first: Red Hat Hummingbird minimal base images with zero CVEs
• ⚡ Optimized builds: Multi-stage Docker builds for minimal production footprint
• 🔧 Auto-configuration: SSL certificates and environment setup handled automatically

v2.0.1: Enhanced MCP Protocol Support

• 🌐 Remote MCP Server: HTTP/JSON-RPC 2.0 support for containerized Claude Desktop integration
• 🔄 Dual Integration Modes: Choose between local stdin/stdout or remote HTTPS integration
• 📋 MCP Specification Compliance: Updated tool definitions and method names to match official MCP spec
• 🎯 Intelligent Responses: Human-readable summaries instead of raw JSON dumps
• 🌍 Cross-Platform Compatibility: Overcomes Docker stdin/stdout limitations for Windows/Linux

v2.1.0: Container Stability and Error Resilience

• 🛡️ Global Error Handling: Added uncaught exception and unhandled rejection handlers to prevent process crashes
• 🔄 Container Stability: Eliminated 2-3 minute restart cycles in containerized deployments (Podman/Docker)
• 📊 Enhanced Error Logging: Improved production error visibility with timestamps and PID tracking
• 🎯 Graceful Degradation: Server continues running even with authentication or API failures
• 🚫 Removed Process Exits: Replaced fatal process.exit() calls with graceful error handling
• ⚡ Production Tested: Container stability verified in production mode without DEV_MODE debug logging

v2.1.1: Production Logging Optimization

• 🧹 Minimal Production Logging: Cleaned up verbose debugging code for production deployments
• 🎯 Essential Stability Components: Maintained critical signal handlers and global error handling
• 📝 DEV_MODE Conditional Logging: Optional debug output only appears when DEV_MODE=true
• ⚡ Event Loop Stability: Minimal keepalive prevents Node.js from becoming inactive in containers
• ✅ Verified Container Stability: 10+ minute stability testing confirmed no restart cycles in production mode

✅ Features

• Supports read-only Evernote access (searching, reading, and listing notes)
• OAuth 1.0a authentication with browser auto-launch for secure authorization
• Automatic token persistence in .env file for seamless re-authentication
• 🆕 v1.1.0: Automatic token expiration detection - Server checks token validity on startup
• 🆕 v1.1.0: Interactive re-authentication prompts - User-friendly prompts when tokens expire
• 🆕 v1.1.0: Enhanced error handling - Specific EDAMUserException error code reporting
• **🆕 v1.1.0: Proactiv

... View full README on GitHub