@caliu-notes/mcp
v1.2.1
Published
MCP server for Caliu — interact with your notes, tags, and more from any MCP-compatible client
Maintainers
Readme
@caliu-notes/mcp
Model Context Protocol server for Caliu — a local-first, markdown-powered notes app.
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_KEYenv 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 backlinkscreate_note,update_note— write markdown; tags auto-derive from#hashtagsin the contentdelete_note,restore_note— soft delete and restorelist_tags— discover existing tags before writingset_reminder(upsert),delete_reminder— reminder managementget_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.
Links
License
MIT
