开源MCP工具

Installation Requirements

Installation Methods

Option 1: Using NPX (No Installation Required)

The simplest way - no need to install anything globally:

```bash

Install globally

npm install -g @verygoodplugins/mcp-evernote

Clone and install

git clone https://github.com/verygoodplugins/mcp-evernote.git cd mcp-evernote npm install

Run setup wizard

npm run setup ```

Building from Source

npm install
npm run build

Quick Start

Configuration

2. Authentication Options

Interactive Setup (Recommended)

The auth script will prompt you for credentials if not found:

```bash

Create .env file (optional)

EVERNOTE_CONSUMER_KEY=your-consumer-key EVERNOTE_CONSUMER_SECRET=your-consumer-secret EVERNOTE_ENVIRONMENT=production # or 'sandbox' OAUTH_CALLBACK_PORT=3000 # Default: 3000

Polling configuration (optional)

EVERNOTE_POLLING_ENABLED=true # Auto-start polling EVERNOTE_POLL_INTERVAL=3600000 # 1 hour (min: 900000 = 15 min) EVERNOTE_WEBHOOK_URL=https://your-endpoint.com/webhooks/evernote # Webhook for change notifications ```

3. Configure Your Client

<details> <summary><b>Claude Code Configuration</b></summary>

#### Quick Setup (Using NPX)

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

#### OAuth Authentication 1. In Claude Code, type /mcp 2. Select "Evernote" 3. Choose "Authenticate" 4. Follow the browser OAuth flow 5. Tokens are stored and refreshed automatically by Claude Code

Note: Claude Code handles OAuth automatically - no manual token management needed!

</details>

<details> <summary><b>Claude Desktop Configuration</b></summary>

Step 1: Authenticate

Using NPX (no installation required):

npx -y -p @verygoodplugins/mcp-evernote mcp-evernote-auth

The auth script will: 1. Prompt for your API credentials (if not in environment) 2. Open your browser for OAuth authentication 3. Save a compatible token file to .evernote-token.json 4. Display the access token so you can use EVERNOTE_ACCESS_TOKEN instead

Or if installed globally:

mcp-evernote-auth

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": ["-y", "-p", "@verygoodplugins/mcp-evernote", "-c", "mcp-evernote"],
      "env": {
        "EVERNOTE_CONSUMER_KEY": "your-consumer-key",
        "EVERNOTE_CONSUMER_SECRET": "your-consumer-secret",
        "EVERNOTE_ACCESS_TOKEN": "your-access-token",
        "EVERNOTE_ENVIRONMENT": "production"
      }
    }
  }
}

Or if installed globally:

{
  "mcpServers": {
    "evernote": {
      "command": "mcp-evernote",
      "env": {
        "EVERNOTE_CONSUMER_KEY": "your-consumer-key",
        "EVERNOTE_CONSUMER_SECRET": "your-consumer-secret"
      }
    }
  }
}

</details>

3. Environment Variables (CI/CD)

EVERNOTE_ACCESS_TOKEN=your-token
EVERNOTE_NOTESTORE_URL=your-notestore-url
EVERNOTE_ALLOWED_FILE_ROOTS=/Users/you/Documents:/Users/you/Projects

1. Get Evernote API Credentials

1. Visit Evernote Developers
2. Create a new application
3. Copy your Consumer Key and Consumer Secret

Run authentication - prompts for API keys if needed

npx -p @verygoodplugins/mcp-evernote mcp-evernote-auth

#### Environment Variables (Optional)

For automation, you can set credentials via environment variables:

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:

1. Set the memory service URL in your environment:

MCP_MEMORY_SERVICE_URL=http://localhost:8765

2. Use the sync tools to persist important notes to memory:

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

Troubleshooting