Skip to main content
Glama

Evernote MCP Server

by Ak-9647
README.mdโ€ข6.71 kB
# ๐Ÿ—ƒ๏ธ 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 ```bash git clone https://github.com/your-username/evernote-mcp-server.git cd evernote-mcp-server ``` ### 2. Install Dependencies ```bash pip install -r requirements.txt ``` ### 3. Secure Setup ```bash 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](https://dev.evernote.com/doc/articles/dev_tokens.php) 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: ```bash # 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](https://dev.evernote.com) - 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](https://github.com/your-username/evernote-mcp-server/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](LICENSE) file for details. ## ๐Ÿ™ Acknowledgments - [Evernote API](https://dev.evernote.com) for the excellent documentation - [Claude Desktop](https://claude.ai) for MCP integration - [Model Context Protocol](https://modelcontextprotocol.io) 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](docs/Claude_Desktop_Usage_Instructions.md)*

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/Ak-9647/Evernote-MCP'

If you have feedback or need assistance with the MCP directory API, please join our Discord server