← Back to notes

Connect to Claude (MCP)

notelog ships an MCP (Model Context Protocol) server: connect Claude to your account and save notes, search them, and ask questions about them right from a chat. Setup takes two steps: create a token, add it to Claude.

1. Create an API token

After signing in, open API tokens from the profile menu, give it a name (e.g. “Claude Desktop”) and create it. The token starts with nl_pat_… and is shown only once — copy it right away.

2. Connect Claude

The server URL is https://getnotelog.com/api/mcp (Streamable HTTP). Authentication uses the Authorization: Bearer <token> header.

Claude Code (CLI) — one command in your terminal (paste your token):

claude mcp add --transport http notelog https://getnotelog.com/api/mcp \
  --header "Authorization: Bearer nl_pat_XXXXXXXX"

Claude Desktop — Settings → Developer → “Edit Config”, then add this to claude_desktop_config.json (it bridges to the remote server via mcp-remote; requires Node.js):

{
  "mcpServers": {
    "notelog": {
      "command": "npx",
      "args": [
        "-y", "mcp-remote", "https://getnotelog.com/api/mcp",
        "--header", "Authorization:${AUTH_HEADER}"
      ],
      "env": { "AUTH_HEADER": "Bearer nl_pat_XXXXXXXX" }
    }
  }
}

Restart Claude Desktop after saving; "notelog" appears in the tool list. Any other MCP client that supports Streamable HTTP with custom headers connects with the same URL and header.

3. Available tools

Once connected, just tell Claude what you want — "save this to notelog", "search my notes for X". The tools:

  • save_note — saves a new note (auto-embedded); optionally into a workspace.
  • search_notes — semantic + keyword search over your notes.
  • ask_notes — answers a question grounded in your notes, with sources (Pro only).
  • list_workspaces — lists the workspaces you belong to.
  • create_workspace — creates a new workspace (Pro only).
  • add_workspace_member — adds a member to your workspace by email (owner only; they must have a notelog account).

Everything except photo upload works over MCP. Tools act only on your own account; a token only ever sees its owner's notes.

Limits

  • ask_notesis Pro-only with a quota of 300 questions per month — shared with “Ask your notes” on the web.
  • Saving and searching work on every plan.

Security

  • Treat the token like a password: don't share or publish it. notelog stores only a hash of it.
  • If you suspect a leak, revoke it instantly on the API tokens page and create a new one.

Stuck somewhere? Write to us: info@getnotelog.com.