Fixitdaz/evernote-mcp-server

Evernote MCP Server

A Model Context Protocol (MCP) server that enables Claude Desktop to directly interact with your Evernote account. This integration allows AI-powered note management, search, and organization of your Evernote content.

🚀 Features

• 📝 List Notebooks - Browse all your Evernote notebooks with metadata
• 📋 List Notes - View notes from specific notebooks or across your entire account
• 🔍 Search Notes - Use Evernote's powerful search syntax to find specific content
• 📖 Read Notes - Get full content of any note including formatting and metadata
• ✏️ Create Notes - Generate new notes with tags and notebook organization

🛠️ Installation

Prerequisites

• Node.js (v16 or higher)
• Claude Desktop application
• Evernote account with API access

Setup Steps

1. Clone this repository:

   git clone https://github.com/yourusername/evernote-mcp-server.git
   cd evernote-mcp-server
   

2. Install dependencies:

   npm install
   

3. Configure authentication:

   • Update the accessToken in src/index.js with your Evernote OAuth token
   • Ensure your token has proper permissions for production Evernote API

4. Test the server:

   npm start
   

5. Configure Claude Desktop:

   Edit your Claude Desktop config file:

   • Windows: %APPDATA%\Claude\claude_desktop_config.json
   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

   Add this configuration:

   {
     "mcpServers": {
       "evernote": {
         "command": "node",
         "args": ["path/to/your/evernote-mcp-server/src/index.js"]
       }
     }
   }
   

6. Restart Claude Desktop to load the new integration

🎯 Usage Examples

List All Notebooks

Show me all my Evernote notebooks using evernote_list_notebooks

Search for Notes

Search my Evernote for notes about "meeting" from last week using evernote_search_notes

Create a New Note

Create a note titled "Project Ideas" with content "AI integration possibilities" using evernote_create_note

Browse Notes in a Notebook

Show me notes in my "Work" notebook using evernote_list_notes

Get Specific Note Content

Retrieve the full content of note with GUID "abc123" using evernote_get_note

🔧 Available Tools

📋 Evernote Search Syntax

The evernote_search_notes tool supports Evernote's full search syntax:

• By notebook: notebook:"Work Notes"
• By tag: tag:important
• By date: created:day-1 (yesterday), updated:week-1 (last week)
• By content: recipe ingredients (search text)
• Combined: tag:meeting created:day-7 notebook:Work

🏗️ Technical Architecture

MCP Compliance

• Follows MCP specification v2024-11-05
• Uses proper tool naming convention: ^[a-zA-Z0-9_-]{1,64}$
• Implements standard MCP server patterns with JSON-RPC 2.0

Authentication

• Uses Evernote OAuth 1.0 authentication
• Connects to production Evernote API (not sandbox)
• Requires valid access token with read/write permissions

Error Handling

• Proper MCP error responses
• Graceful handling of Evernote API limitations
• Detailed error logging for debugging

🔐 Security Considerations

• Token Security: Never commit your access token to version control
• Permissions: Token should have minimal required permissions
• Rate Limiting: Evernote API has rate limits - use responsibly
• Data Privacy: All data stays between your Evernote account and Claude Desktop

🚨 Troubleshooting

Common Issues

1. "Tool not found" error:

   • Restart Claude Desktop after configuration changes
   • Verify config file path and syntax
   • Check server logs in Claude Desktop logs directory

2. Authentication errors:

   • Verify your access token is valid and has proper permissions
   • Ensure you're using production API (not sandbox)
   • Check token expiration

3. Server startup issues:

   • Run npm install to ensure dependencies are installed
   • Test server independently: node src/index.js
   • Check Node.js version compatibility

Debug Logs

Claude Desktop logs are located at:

• Windows: %APPDATA%\Claude\logs\mcp-server-evernote.log
• macOS: ~/Library/Application Support/Claude/logs/mcp-server-evernote.log

🤝 Contributing

1. Fork the repository
2. Create a feature branch: git checkout -b feature-name
3. Make your changes following the existing code style
4. Test thoroughly with your Evernote account
5. Submit a pull request with detailed description

📄 License

MIT License - see LICENSE file for details

🙏 Acknowledgments

• Built using the Model Context Protocol SDK
• Powered by Evernote SDK for JavaScript
• Follows MCP specification guidelines

---

Status: ✅ Production Ready - Successfully tested with Claude Desktop and production Evernote API