Caliu Notes
Read and write your Caliu notes from any MCP client: search, create, tag, remind, attach files.
Open source Open in the app JSON README (API)
About
Read and write your Caliu notes from any MCP client: search, create, tag, remind, attach files.
Details
- Kind
- MCP servers
- Topic
- No topic detected
- Publisher
- com.caliuapp
- Origin
- official
- Category
- ferramentas
- Transport
- http
- Version
- 1.7.1
- Added
- 2026-09-09 19:05:57
- Updated
- 2026-09-13 17:05:05
- Origin id
com.caliuapp/caliu-notes
README
# @caliu-notes/mcp
Model Context Protocol server for [Caliu](https://caliuapp.com), a local-first, markdown-powered notes app.
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`.
```json
{
"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
1. Open Caliu → Settings → API keys
2. Create a new key (starts with `caliu_`)
3. 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.
## Links
- App: <https://web.caliuapp.com>
- Docs: <https://caliuapp.com/docs>
## License
MIT