{
  "markdown": "# @caliu-notes/mcp\n\nModel Context Protocol server for [Caliu](https://caliuapp.com), a local-first, markdown-powered notes app.\n\nExposes 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.\n\n## Install\n\nNo install needed. Run it on demand with `npx`.\n\n```json\n{\n  \"mcpServers\": {\n    \"caliu\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@caliu-notes/mcp\"],\n      \"env\": {\n        \"CALIU_API_KEY\": \"caliu_your_api_key_here\"\n      }\n    }\n  }\n}\n```\n\nDrop that into your client's MCP config (e.g. `claude_desktop_config.json`).\n\n### Claude on the web\n\nClaude.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.\n\n## Getting an API key\n\n1. Open Caliu → Settings → API keys\n2. Create a new key (starts with `caliu_`)\n3. Paste it into the `CALIU_API_KEY` env var above\n\n## Environment\n\n| Variable        | Required | Default                    | Description                              |\n| --------------- | -------- | -------------------------- | ---------------------------------------- |\n| `CALIU_API_KEY` | Yes      | none                       | API key from Caliu → Settings → API keys |\n| `CALIU_API_URL` | No       | `https://api.caliuapp.com` | Override the API base URL                |\n\n## Tools\n\n14 tools, designed for agents rather than as a 1:1 mirror of the REST API:\n\n**Notes**\n- **`search_notes`**: full-text search and filtering (tag, pinned, untagged, backlinks, trash)\n- **`get_note`**: single note with content, tags, and backlinks\n- **`create_note`**, **`update_note`**: write markdown; tags auto-derive from `#hashtags` in the content\n- **`delete_note`**, **`restore_note`**: soft delete and restore\n- **`archive_note`**, **`unarchive_note`**: archive without deleting, tags preserved\n\n**Tags**\n- **`list_tags`**: discover existing tags before writing\n\n**Reminders**\n- **`set_reminder`** (upsert), **`delete_reminder`**\n\n**Attachments**\n- **`upload_file`**: attach an image or file to a note\n- **`get_attachment`**: fetch an existing attachment\n\n**User**\n- **`get_current_user`**: authenticated profile\n\nTags 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.\n\n## Links\n\n- App: <https://web.caliuapp.com>\n- Docs: <https://caliuapp.com/docs>\n\n## License\n\nMIT",
  "bytes": 2687,
  "sha": "72bc7c554b2ee592a7ac8eeb2c55d8183d2e2590c011d314e38939b4e07c7596",
  "repo_slug": "",
  "fonte": "npm",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_com_caliuapp_caliu_notes_ed45c5d2/readme"
}