Connect AI agents with MCP

Caliu ships an MCP (Model Context Protocol) server, so AI agents like Claude Desktop, Claude Code, Cursor, and Windsurf can search, read, create, and update your notes, manage reminders, upload and read back images and files, and browse your tags. It exposes 14 focused tools rather than mirroring every API endpoint.

Option 1: local server with an API key

Create an API key (see the API keys article), then add this to your MCP client's configuration:

{
  "mcpServers": {
    "caliu": {
      "command": "npx",
      "args": ["-y", "@caliu-notes/mcp"],
      "env": {
        "CALIU_API_KEY": "caliu_your_api_key_here"
      }
    }
  }
}

Option 2: remote server with OAuth

Web-based clients such as claude.ai connectors can use the remote endpoint at https://api.caliuapp.com/mcp. No key to copy: the client sends you to a consent screen where you sign in to Caliu and approve access. Approved clients appear under Connected apps in the web app's user menu, where you can revoke them anytime.

Agents just write Markdown

There are no tag-management tools on purpose. Tags in Caliu derive from #hashtags in note content, so an agent that writes #work/ideas in a note has already tagged it. The same goes for links: write [[Note Title]] in a note and Caliu resolves it to a real note link automatically. Both options run the exact same tools.