← 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 — and manage your tasks too.

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'".

Connect from claude.ai (custom connector)

claude.ai (web) can connect to Memol as a custom connector. No API key — you just sign in and approve via OAuth. Each workspace has its own URL, so you can add multiple workspaces as separate connectors.

  1. In Memol, go to Settings → API / MCP and copy the "This workspace's URL" for the workspace you want to connect.
  2. In claude.ai, open Settings → Add connector → Custom connector, and paste the URL.
  3. On the Memol approval screen, choose the permission (read-only / read & write) and click Approve. The workspace is fixed automatically based on the URL.

URL format:

https://memol.app/api/mcp/<workspaceId>

To connect another workspace, repeat the steps from that workspace's settings — it appears as a separate connector in claude.ai.

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