A
securityF
licenseA
qualityA 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 -
12
011
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
git clone https://github.com/your-username/evernote-mcp-server.git
cd evernote-mcp-server
2. Install Dependencies
pip install -r requirements.txt
3. Secure Setup
python setup_secure.py
This will:
Create your
.envfile from the templatePrompt you for your Evernote token
Configure Claude Desktop integration
Set up all security measures
4. Get Your Evernote Token
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
Configure my Evernote connection
🔗 test_connection
Test your API connection
Test my Evernote connection
📚 list_notebooks
List all your Evernote notebooks
Show me all my notebooks
🔍 search_notes
Search for notes by content
Search for notes about "project planning"
📝 create_note
Create new notes with rich formatting
Create a meeting note for today's standup
📄 get_note
Retrieve specific notes by ID
Get note details for ID abc-123
ℹ️ get_server_info
Get server status and information
Show me server 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
evernote-mcp-server/
├── working_mcp_server.py # Main MCP server (production ready)
├── setup_secure.py # Secure setup script
├── .env.example # Environment template
├── requirements.txt # Python dependencies
├── README.md # This file
├── LICENSE # MIT License
├── .gitignore # Git ignore rules
├── tests/ # Test files
│ ├── test_all_mcp_features.py
│ ├── test_working_mcp_server.py
│ └── simple_mcp_demo.py
├── examples/ # Example scripts
│ ├── create_test_notes.py
│ ├── read_actual_notes.py
│ └── simple_evernote_test.py
└── docs/ # Documentation
├── EVERNOTE_MCP_GUIDE.md
└── Claude_Desktop_Usage_Instructions.md
🔒 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 all MCP features
python test_all_mcp_features.py
# Test individual tools
python test_working_mcp_server.py
# Simple demo
python simple_mcp_demo.py
📊 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.pyto configure your tokenCheck that
.envfile 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.pyexists in the correct directoryCheck 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
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
- -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 -213MIT 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 -122081
- 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 -2538MIT License