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, and browse your tags. It exposes 12 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. Both options run the exact same tools.