← Back to Help
NEW · MCP

Setting up MCP (Model Context Protocol)

How to access Memol notes directly from MCP-enabled AI assistants like Claude Desktop

What is MCP?

MCP (Model Context Protocol) is an open standard from Anthropic that connects AI assistants with external tools. Connecting Memol as an MCP server lets Claude and other AI assistants search, read, create, and edit your Memol notes.

1. Create an API key

Go to your workspace's Settings → API / MCP integration section, enter a key name (e.g. "Claude Desktop") and click "Create". Copy the displayed key (it won't be shown again).

2. Open the Claude Desktop config file

On macOS, open ~/Library/Application Support/Claude/claude_desktop_config.json. On Windows, open %APPDATA%\Claude\claude_desktop_config.json. Create the file if it doesn't exist.

3. Add the configuration

Paste the configuration below, replacing YOUR_API_KEY with the key you created.

Claude Desktop (app)

You can open the config file from Claude Desktop here:

Settings → Developer → Edit Config

Add the following to the claude_desktop_config.json that opens:

{
  "mcpServers": {
    "memol": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://memol.app/api/mcp",
        "--header",
        "Authorization: Bearer YOUR_API_KEY"
      ]
    }
  }
}

Claude Code (CLI)

claude mcp add --transport http memol \
  https://memol.app/api/mcp \
  --header "Authorization: Bearer YOUR_API_KEY"

Replace YOUR_API_KEY with the API key you created.

4. Restart Claude Desktop

Fully quit and reopen Claude Desktop. Memol's tools should appear.

5. Try it out

Ask Claude things like "Search Memol for last week's meeting notes" or "Create a note in Memol called 'Shopping list'".

Cursor / other MCP clients

Any MCP client that supports the Streamable HTTP transport can connect with the URL and Bearer header above. Protocol 2025-06-18 (older revisions also supported). Clients that take a URL + headers directly (e.g. Cursor) can use this form:

{
  "mcpServers": {
    "memol": {
      "url": "https://memol.app/api/mcp",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}

Replace YOUR_API_KEY with the API key you created.

Available tools

  • search_notes — Search notes by keyword
  • list_notes — List recent notes
  • get_note — Fetch the full content of a note
  • list_folders — List all folders
  • create_note — Create a new note
  • update_note — Update an existing note
  • list_tasks — list tasks
  • create_task — create a task
  • update_task — update a task (status, etc.)

Pricing

MCP integration is free on all plans, including Free. You can create up to 5 API keys per user.

Troubleshooting

Memol tools don't appear in Claude Desktop

Fully quit Claude Desktop (including from the menu bar/tray) and reopen it. Also check that your config file is valid JSON.

Getting an "Unauthorized" error

Verify the API key is copied correctly — it should start with "memol_". Re-creating the key in settings is the most reliable fix.

Notes not found / empty search results

Make sure the API key was created in the correct workspace. Each key is tied to one workspace.

← Back to Help
Setting up MCP (Model Context Protocol) | Memol