🗃️ 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

Related MCP server: Bear MCP Server

🔧 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 .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

1. Go to Evernote Developer Tokens

2. Log in with your Evernote account

3. Generate a new token

4. 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.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

1. Check the Issues page

2. Review the troubleshooting guide in the docs

3. Run the diagnostic tools: python test_all_mcp_features.py

📝 Contributing

1. Fork the repository

2. Create a feature branch

3. Make your changes

4. Run the test suite

5. 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