@verygoodplugins/mcp-evernote

MCP Evernote Server

A Model Context Protocol (MCP) server that provides seamless integration with Evernote for note management, organization, and knowledge capture. Works with both Claude Code and Claude Desktop.

Features

• 🔐 OAuth Authentication - Secure OAuth flow with automatic handling in Claude Code
• 📝 Note Management - Create, read, update, and delete notes
• 📚 Notebook Organization - Manage notebooks and stacks
• 🏷️ Tag System - Create and manage tags for better organization
• 🔍 Advanced Search - Search notes using Evernote's powerful search syntax
• 💾 Memory Integration - Optional sync with MCP memory service for knowledge persistence
• 🔄 Real-time Sync - Keep your notes synchronized across all devices
• 🤖 Smart Setup - Automatic environment detection and configuration

Quick Start

Automatic Setup (Recommended)

npm install @verygoodplugins/mcp-evernote
npm run setup

The setup wizard will:

• Detect your environment (Claude Code or Claude Desktop)
• Guide you through the appropriate installation
• Handle authentication automatically

Manual Installation

For Claude Code

# Install globally
npm install -g @verygoodplugins/mcp-evernote

# Add to Claude Code
claude mcp add evernote "npx @verygoodplugins/mcp-evernote"

# Authenticate using /mcp command in Claude Code

For Claude Desktop

# Install
npm install @verygoodplugins/mcp-evernote

# Authenticate
npm run auth

# Configure in Claude Desktop settings

Configuration

1. Get Evernote API Credentials

• Visit Evernote Developers
• Create a new application
• Note your Consumer Key and Consumer Secret

2. Set Environment Variables

Create a .env file in your project directory:

# Required
EVERNOTE_CONSUMER_KEY=your-consumer-key
EVERNOTE_CONSUMER_SECRET=your-consumer-secret

# Optional
EVERNOTE_ENVIRONMENT=production  # or 'sandbox' for testing
OAUTH_CALLBACK_PORT=3000        # Port for OAuth callback

3. Configure Your Client

Claude Code Configuration

Automatic Installation

npm run setup:claude

Manual Installation

claude mcp add evernote "npx @verygoodplugins/mcp-evernote" \
  --env EVERNOTE_CONSUMER_KEY=your-key \
  --env EVERNOTE_CONSUMER_SECRET=your-secret

OAuth Authentication

• In Claude Code, type /mcp
• Select "Evernote"
• Choose "Authenticate"
• Follow the browser OAuth flow
• Tokens are stored and refreshed automatically by Claude Code

Claude Desktop Configuration

Step 1: Authenticate

npm run auth

This opens your browser for OAuth and saves the token locally.

Step 2: Add to Configuration

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

{
  "mcpServers": {
    "evernote": {
      "command": "npx",
      "args": ["@verygoodplugins/mcp-evernote"],
      "env": {
        "EVERNOTE_CONSUMER_KEY": "your-consumer-key",
        "EVERNOTE_CONSUMER_SECRET": "your-consumer-secret",
        "EVERNOTE_ENVIRONMENT": "production"
      }
    }
  }
}

Authentication Methods

1. Claude Code (Automatic)

Claude Code handles OAuth automatically via the /mcp command. Tokens are managed by Claude Code.

2. Claude Desktop (Manual)

Run npm run auth to authenticate via browser. Token saved to .evernote-token.json.

3. Environment Variables (CI/CD)

EVERNOTE_ACCESS_TOKEN=your-token
EVERNOTE_NOTESTORE_URL=your-notestore-url

4. Direct Token (Advanced)

{
  "env": {
    "EVERNOTE_ACCESS_TOKEN": "your-access-token",
    "EVERNOTE_NOTESTORE_URL": "your-notestore-url"
  }
}

Available Tools

Note Operations

evernote_create_note

Create a new note in Evernote.

Parameters:

• title (required): Note title
• content (required): Note content (plain text or markdown)
• notebookName (optional): Target notebook name
• tags (optional): Array of tag names

Example:

Create a note titled "Meeting Notes" with content "Discussed Q4 planning" in notebook "Work" with tags ["meetings", "planning"]

evernote_search_notes

Search for notes using Evernote's search syntax.

Parameters:

• query (required): Search query
• notebookName (optional): Limit to specific notebook
• maxResults (optional): Maximum results (default: 20, max: 100)

Example:

Search for notes containing "project roadmap" in the "Work" notebook

evernote_get_note

Retrieve a specific note by GUID.

Parameters:

• guid (required): Note GUID
• includeContent (optional): Include note content (default: true)

evernote_update_note

Update an existing note.

Parameters:

• guid (required): Note GUID
• title (optional): New title
• content (optional): New content
• tags (optional): New tags (replaces existing)

evernote_delete_note

Delete a note.

Parameters:

• guid (required): Note GUID

Notebook Operations

evernote_list_notebooks

List all notebooks in your account.

evernote_create_notebook

Create a new notebook.

Parameters:

• name (required): Notebook name
• stack (optional): Stack name for organization

Tag Operations

evernote_list_tags

List all tags in your account.

evernote_create_tag

Create a new tag.

Parameters:

• name (required): Tag name
• parentTagName (optional): Parent tag for hierarchy

Account Operations

evernote_get_user_info

Get current user information and quota usage.

evernote_revoke_auth

Revoke stored authentication token.

Search Syntax

Evernote supports advanced search operators:

• intitle:keyword - Search in titles
• notebook:name - Search in specific notebook
• tag:tagname - Search by tag
• created:20240101 - Search by creation date
• updated:day-1 - Recently updated notes
• resource:image/* - Notes with images
• todo:true - Notes with checkboxes
• -tag:archive - Exclude archived notes

Integration with Claude Automation Hub

This MCP server works seamlessly with the Claude Automation Hub for workflow automation:

// Example workflow tool
export default {
  name: 'capture-idea',
  description: 'Capture an idea to Evernote',
  handler: async ({ idea, category }) => {
    // The MCP server handles the Evernote integration
    return {
      tool: 'evernote_create_note',
      args: {
        title: `Idea: ${new Date().toISOString().split('T')[0]}`,
        content: idea,
        notebookName: 'Ideas',
        tags: [category, 'automated']
      }
    };
  }
};

Memory Service Integration

To enable synchronization with MCP memory service:

• Set the memory service URL in your environment:

MCP_MEMORY_SERVICE_URL=http://localhost:8765

• Use the sync tools to persist important notes to memory:

Sync my "Important Concepts" notebook to memory for long-term retention

Troubleshooting

Authentication Issues

"Authentication required" error in Claude Desktop

This means you haven't authenticated yet. Run the authentication script:

npm run auth

OAuth callback fails

If the OAuth callback doesn't work:

• Make sure port 3000 is available (or set OAUTH_CALLBACK_PORT in .env)
• Check your firewall settings
• Try using a different browser

Token expired

If your token expires:

• Delete .evernote-token.json
• Run npm run auth again
• Restart Claude Desktop

Connection Errors

• Verify your API credentials are correct
• Check if you're using the right environment (sandbox vs production)
• Ensure your firewall allows the OAuth callback port

Rate Limiting

Evernote API has rate limits. If you encounter limits:

• Reduce the frequency of requests
• Use batch operations where possible
• Implement caching for frequently accessed data

Development

Building from Source

npm install
npm run build

Running in Development Mode

npm run dev

Testing

npm test

Linting

npm run lint
npm run format

Security

• OAuth tokens are stored locally in .evernote-token.json
• Never commit token files to version control
• Use environment variables for sensitive configuration
• Tokens expire after one year by default

Contributing

Contributions are welcome! Please:

• Fork the repository
• Create a feature branch
• Make your changes
• Add tests if applicable
• Submit a pull request

License

GPL-3.0 - See LICENSE file for details.

Support

• Issues: GitHub Issues
• Discussions: GitHub Discussions
• Documentation: Wiki

Acknowledgments

• Built with Model Context Protocol SDK
• Powered by Evernote API
• Part of the Very Good Plugins ecosystem

Roadmap

• Web clipper functionality
• Rich text editing support
• File attachment handling
• Shared notebook support
• Business account features
• Template system
• Bulk operations
• Export/Import tools
• Advanced filtering options
• Reminder management