Exposes your Caliu notes, tags, reminders and attachments 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).

Claude on the web

Claude.ai can connect to Caliu directly, with no API key and no npm package: add https://api.caliuapp.com/mcp as a Custom Connector and sign in to Caliu when prompted. It speaks OAuth 2.1 with dynamic client registration.

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	none	API key from Caliu → Settings → API keys
`CALIU_API_URL`	No	`https://api.caliuapp.com`	Override the API base URL

Tools

14 tools, designed for agents rather than as a 1:1 mirror of the REST API:

Notes

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
archive_note, unarchive_note: archive without deleting, tags preserved

Tags

list_tags: discover existing tags before writing

Reminders

set_reminder (upsert), delete_reminder

Attachments

upload_file: attach an image or file to a note
get_attachment: fetch an existing attachment

User

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. Note links work the same way: write [[Note Title]] and the server resolves it to a canonical link.