Enables interaction with Evernote, allowing for creating, searching, reading, and managing notes. Provides tools to search notes, retrieve note content, create new notes with title and tags, update existing notes, and create new notebooks for organization.
🗃️ Evernote MCP Server
A comprehensive Model Context Protocol (MCP) server for Evernote integration with Claude Desktop.
🚀 Features
- ✅ Full MCP Integration - Works seamlessly with Claude Desktop
- ✅ Secure Token Management - Uses environment variables (no hardcoded tokens)
- ✅ Rich Note Creation - Create formatted notes with HTML, tables, lists
- ✅ Search & Organization - Search notes, list notebooks, manage tags
- ✅ Professional Templates - Generate well-structured notes automatically
- ✅ Easy Setup - One-command setup script for security
- ✅ Comprehensive Testing - Full test suite with 100% success rate
🔧 Quick Start
1. Clone the Repository
2. Install Dependencies
3. Secure Setup
This will:
- Create your
.env
file from the template - Prompt you for your Evernote token
- Configure Claude Desktop integration
- Set up all security measures
4. Get Your Evernote Token
- Go to Evernote Developer Tokens
- Log in with your Evernote account
- Generate a new token
- Use it in the setup script
🛠️ Available Tools
Your MCP server provides these tools for Claude Desktop:
📋 configure_evernote
Configure your Evernote connection settings
🔗 test_connection
Test your API connection
📚 list_notebooks
List all your Evernote notebooks
🔍 search_notes
Search for notes by content
📝 create_note
Create new notes with rich formatting
📄 get_note
Retrieve specific notes by ID
ℹ️ get_server_info
Get server status and information
🎯 Usage with Claude Desktop
Once set up, you can use natural language with Claude Desktop:
Creating Notes:
- "Create a meeting note for today's team standup"
- "Write a note about weekend plans with tags 'personal' and 'weekend'"
- "Make a shopping list note with groceries and household items"
Searching & Managing:
- "Find all notes about project planning"
- "Show me my notebook list"
- "Search for notes containing 'budget'"
Getting Information:
- "What's the status of my Evernote connection?"
- "Show me available MCP tools"
📁 Project Structure
🔒 Security Features
- ✅ No Hardcoded Tokens - All tokens use environment variables
- ✅ Secure .env Setup - Automatic environment configuration
- ✅ Gitignore Protection - Sensitive files excluded from version control
- ✅ Token Validation - Automatic token testing and validation
- ✅ Error Handling - Robust error handling for API failures
🧪 Testing
Run the comprehensive test suite:
📊 Test Results
Latest test results show 100% success rate:
- ✅ 15/15 features tested successfully
- ✅ All API connections working
- ✅ Token validation passed
- ✅ Claude Desktop integration ready
🎨 Note Templates
The server creates professional notes with:
- Rich HTML formatting
- Tables and lists
- Professional styling
- Metadata and timestamps
- Tag organization
- Import instructions
🚀 Example Notes Created
- 📋 Meeting Notes - Structured agendas, action items, decisions
- 💡 Project Ideas - Brainstorming with priority matrices
- 📚 Learning Resources - Study plans with resources and schedules
- 🛒 Shopping Lists - Categorized items with budget estimates
- 🎨 Creative Writing - Story outlines with character development
🔧 Troubleshooting
Common Issues
"Token not found"
- Run
python setup_secure.py
to configure your token - Check that
.env
file exists and contains your token
"Connection failed"
- Verify your internet connection
- Test your token at Evernote Developer Console
- Try running the connection test tool
"Claude Desktop not finding MCP server"
- Ensure
working_mcp_server.py
exists in the correct directory - Check Claude Desktop configuration file location
- Restart Claude Desktop after configuration
Getting Help
- Check the Issues page
- Review the troubleshooting guide in the docs
- Run the diagnostic tools:
python test_all_mcp_features.py
📝 Contributing
- Fork the repository
- Create a feature branch
- Make your changes
- Run the test suite
- Submit a pull request
📄 License
This project is licensed under the MIT License - see the LICENSE file for details.
🙏 Acknowledgments
- Evernote API for the excellent documentation
- Claude Desktop for MCP integration
- Model Context Protocol for the framework
📈 Status
- Version: 1.0.0
- Status: Production Ready
- Test Coverage: 100%
- Claude Desktop: ✅ Compatible
- Security: ✅ Secure (no hardcoded tokens)
🎉 Ready to create and manage your Evernote notes with AI assistance!
For detailed usage instructions, see Claude Desktop Usage Instructions
This server cannot be installed
hybrid server
The server is able to function both locally and remotely, depending on the configuration or use case.
A Model Context Protocol server that allows AI assistants like Claude to interact with Evernote, enabling them to create, search, read, and manage notes through natural language.
Related MCP Servers
- AsecurityFlicenseAqualityA Model Context Protocol server that connects Claude and other AI assistants to your Notion workspace, allowing AIs to interact with databases, pages, and blocks.Last updated -12111JavaScript
- -securityAlicense-qualityA Model Context Protocol server that allows AI assistants like Claude to read notes from the Bear note-taking app in a safe, read-only mode.Last updated -2JavaScriptMIT License
- AsecurityFlicenseAqualityA Model Context Protocol server that connects AI assistants like Claude to Notion workspaces, enabling them to view, search, create, and update Notion databases, pages, and content blocks.Last updated -12734JavaScript
- AsecurityAlicenseAqualityA Model Context Protocol server that enables AI assistants like Claude to interact with Outline document services, supporting document searching, reading, creation, editing, and comment management.Last updated -2529PythonMIT License