AgentMarketMCP / SKILL 资产档案馆

目录 / Caliu

MCP 鉴权未知 未评级 已上架

Caliu

Read and write your Caliu notes from any MCP client. Caliu is a local-first markdown notes app for web, iPhone, iPad and Mac. It works fully offline, and an account only adds sync. 14 tools across notes, tags, reminders and attachments: search, create, update, archive, set reminders, upload and read files. Tags are derived from `#hashtags` in the markdown and `[[Note Title]]` links resolve automatically, so agents just write markdown instead of calling tag-attachment tools. Connect with no API key: add `https://api.caliuapp.com/mcp` as a remote server and sign in to Caliu when prompted (OAuth 2.1 with dynamic client registration). Or run it locally with `npx @caliu-notes/mcp` and a `CALIU_API_KEY`. Docs: https://caliuapp.com/docs

该来源不提供完整文件导出（国内平台多为平台内托管），仅存元数据与原链

接入信息

传输形态
http
鉴权方式
鉴权未知
端点
https://caliuapp.run.tools
鉴权方式未标注，请核对官方文档后再接入——不要直接使用以下片段
{
  "mcpServers": {
    "Caliu": {
      "url": "https://caliuapp.run.tools"
    }
  }
}

能力清单

工具说明
search_notesSearch and filter notes. With `query`, runs full-text search over title and content, ranked by relevance (title matches weighted highest). It matches whole words with light English stemming (plurals and verb forms), OR-combined so a note matching more of the query words ranks higher; it is NOT substring or prefix search, so prefer a few distinctive keywords over a full sentence. `query` cannot be combined with `tag` or `untagged` (the text search wins and those filters are ignored); `pinned` still applies. Without `query`, lists notes filtered by the other params, most-recently-updated first. Use `linksTo` to find notes that reference a given note via [[wiki links]]. `includeTrashed: true` lists trashed notes and `includeArchived: true` lists archived notes; both are plain listings that ignore `query` and all other filters. Pagination via `cursor`. Results carry note metadata and a short `contentPreview` (not the full body or tags) — call get_note to read a note's content and tags.
get_noteGet a single note by ID, with full content, tags, backlinks (notes that link to it via [[wiki links]]), and any reminders on it, in one response. Works for active and archived notes; a trashed note returns not-found (restore it first).
create_noteCreate a new note from markdown. The first line becomes the title. Tags are auto-detected from #hashtags in the content (including hierarchical #parent/child) — no separate tag tools needed. Reuse the user's existing tags: call list_tags first and match an existing handle exactly (same casing and hierarchy), e.g. write #todo rather than coining #todos or #task when #todo already exists. Only invent a new hashtag when no existing tag fits; if you're unsure which tag the user wants, ask them instead of guessing. Link to another note by writing [[Note Title]] with the exact title of an existing note — the server resolves it into a real note link (clickable in the apps, counted in backlinks). Titles that don't match an existing note stay as plain text.
update_noteUpdate a note. Only provided fields change. When `content` is provided, tags are re-derived from #hashtags in the new content (a tag is removed if its hashtag is gone). Reuse the user's existing tags: call list_tags first and match an existing handle exactly rather than coining a near-duplicate; only invent a new hashtag when none fits, and ask the user if you're unsure. Link to another note by writing [[Note Title]] with the exact title of an existing note — the server resolves it into a real note link. When rewriting content that already contains [[id|Title]] links, preserve them verbatim.
delete_noteSoft-delete a note (move to trash). Restorable with restore_note. Hard deletion is intentionally not exposed via MCP.
restore_noteRestore a soft-deleted note from trash.
archive_noteArchive a note. Archived notes are hidden from all listings (and tag/folder views) but are never auto-removed and keep their tags. Reverse with unarchive_note. Distinct from delete_note (trash, auto-purged after 30 days).
unarchive_noteRestore a note from the archive back to the active list.
list_tagsList all tags with note counts. Each tag includes a `handle` — the full hierarchical path as you'd write it in note content (e.g. `#work/project/subtask` for nested tags, `#work` for a root tag). Call this before writing #hashtags in create_note or update_note so you reuse the user's existing tags (matching handle and casing exactly) instead of scattering near-duplicates like #todo vs #todos vs #task.
set_reminderCreate or update a reminder on a note. Pass `reminderId` to update an existing one (e.g. snooze by setting a new `triggerAt`); omit it to create a new one. Updating changes only the fields you pass: omitting `recurrence` keeps the existing recurrence, it does not clear it. A note can have multiple reminders. Reminder IDs come from get_note (its `reminders` array) or the response of a previous set_reminder.
delete_reminderRemove a reminder from a note.
get_current_userGet the currently authenticated user's profile (id, email, name).
upload_fileUpload a file of any type (image, PDF, audio, archive, ...) to the user's Caliu storage so it can be embedded in notes. Returns the stored attachment plus a ready-to-use `markdown` snippet — put that snippet into note content via create_note or update_note to make it appear in the note: images render inline, other files render as a downloadable file chip (you may change the link/alt text, but keep the URL exactly as returned). Images are recompressed server-side, so the returned filename/type may differ from the input. Uploading alone does not attach the file to any note. Best for files up to a few MB; base64 inflates payloads by ~33%.
get_attachmentDownload an attachment from the user's Caliu storage so you can view or process it. Accepts the attachment id or the full download URL found in note markdown (https://.../attachments/<id>/download). Images come back as viewable image content, text-based files (txt, md, csv, json, svg, ...) as text, audio as audio content, and other binaries as a base64 resource. Refuses files over 10MB.
纠错与举报（发现条目失效、署名有误或涉及侵权？）
提交举报 / 纠错

侵权举报经核验成立后，我们会即时下线该条目并删除已存的内容副本。