Exposes your Caliu notes, tags, and reminders as a small set of agent-shaped MCP tools that any MCP-compatible client (Claude Desktop, Cursor, Windsurf, …) can call.

Install

No install needed — run it on demand with npx.

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

Drop that into your client's MCP config (e.g. claude_desktop_config.json).

Getting an API key

Open Caliu → Settings → API keys
Create a new key (starts with caliu_)
Paste it into the CALIU_API_KEY env var above

Environment

Variable	Required	Default	Description
`CALIU_API_KEY`	Yes	—	API key from Caliu → Settings → API keys
`CALIU_API_URL`	No	`https://api.caliuapp.com`	Override the API base URL

Tools

10 thoughtful tools, designed for agents (not a 1:1 mirror of the REST API):

search_notes — full-text search and filtering (tag, pinned, untagged, backlinks, trash)
get_note — single note with content, tags, and backlinks
create_note, update_note — write markdown; tags auto-derive from #hashtags in the content
delete_note, restore_note — soft delete and restore
list_tags — discover existing tags before writing
set_reminder (upsert), delete_reminder — reminder management
get_current_user — authenticated profile

Tags are managed automatically: write #work #urgent in note content and the tags get linked. There are no add_tag_to_note / sync_note_tags helpers — agents just write markdown.