MCP App Store
by KeenEthics
Caliu icon

Caliu MCP Server for Claude and ChatGPT

By Caliu

Overview

Caliu is a calm, local-first Markdown notes app for the web, iPhone, iPad, Mac, and Android. Connect it to Claude and your notes come with you into the chat. Ask Claude to find what you wrote about a project, save a conversation as a note, summarize this week's meeting notes, or add an item to a checklist. Claude can search, read, create, edit, archive, and trash notes, attach images and files, and see your tags. Tags come from #hashtags and links from [[Note Title]], so everything Claude writes lands in the right place in your sidebar. You approve the connection on Caliu's own page, and you can revoke it anytime under Connected apps. Free with a Caliu account.

How to connect

  1. Claude: Open the Caliu listing in the Claude connectors directory and choose Connect. Claude listing Caliu exposes 13 tools here.
  2. ChatGPT: Open the Caliu listing in the ChatGPT app directory and choose Connect. ChatGPT listing Caliu exposes 13 tools here.

Tools

archive_note

ChatGPT
Archive 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).

create_note

ChatGPT
Create a new note from markdown. The first line becomes the title. Tags are auto-detected from #hashtags in the content (including hierarchical #parent/child and multi-word tags written with a closing hash: #my project#) — 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.

delete_note

ChatGPT
Soft-delete a note (move to trash). Restorable with restore_note. Hard deletion is intentionally not exposed via MCP.

get_attachment

ChatGPT
Download 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.

get_current_user

ChatGPT
Get the currently authenticated user's profile (id, email, name).

get_note

ChatGPT
Get a single note by ID, with full content, tags, its content revision rev (pass it to update_note as base_rev), and backlinks (notes that link to it via [[wiki links]]) in one response. Works for active and archived notes, and for notes shared with the user, which carry role (editor or viewer) and ownerId: these are read-only here, since update_note and the other note-changing tools work on the user's own notes only (an editor changes a shared note in the Caliu apps); a trashed note returns not-found (restore it first).

list_tags

ChatGPT
List 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, #my project# for a multi-word tag, which is written with a closing #). Copy the handle verbatim into content. 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.

restore_note

ChatGPT
Restore a soft-deleted note from trash.

search_notes

ChatGPT
Search and filter notes. With query, runs full-text search over title and content, ranked by relevance (title matches weighted highest). Plain words match 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. The query can also narrow the results with the Caliu apps' search syntax: "exact phrase", -word to exclude, #tag (includes nested tags; !#tag for that tag only, #multi word# for a tag with spaces), @title (words match the title only), @todo (has an open checkbox), @done, @task, @pinned, @tagged, @untagged, @images, @files, @attachments, @code, @wikilinks, @readonly, @untitled, dates in UTC days (@today, @yesterday, @last7days, @ctoday, @created7days, @date(2026-10), @cdate(<2026-01-15); < before, > after), and or between alternatives that each carry their own filters. Every filter must hold; a query of only filters (#work @todo) lists every match. query cannot be combined with tag or untagged (use #tag / @untagged in the query instead); 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. Search also covers notes other people shared with the user (with the user's own pin, archive and tags); those hits carry role (editor or viewer) and ownerId.

unarchive_note

ChatGPT
Restore a note from the archive back to the active list.

update_note

ChatGPT
Update one of the user's own notes (a note shared with the user returns forbidden, whatever its role). 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. To change part of a note, prefer edits over content: send only the snippets to replace instead of the whole body.

upload_file

ChatGPT
Upload 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. Only for small files (up to a few MB): the whole file has to be written out as base64. For anything bigger (videos, large PDFs, archives) or a file on a disk you can reach with a shell, use create_upload_link instead.

archive_note

Claude

create_note

Claude

delete_note

Claude

get_attachment

Claude

get_current_user

Claude

get_note

Claude

list_tags

Claude

restore_note

Claude

search_notes

Claude

unarchive_note

Claude

update_note

Claude

upload_file

Claude

Similar Apps

Listed on MCP App Store

Listed on MCP App Store

Add this badge to your site or README. It links to this page.

HTML

<a href="https://mcp-app-store.keenethics-labs.com/app/caliu"><img src="https://mcp-app-store.keenethics-labs.com/badges/listed-on-mcp-app-store.svg" alt="Listed on MCP App Store" width="220" height="44"></a>

Markdown

[![Listed on MCP App Store](https://mcp-app-store.keenethics-labs.com/badges/listed-on-mcp-app-store.svg)](https://mcp-app-store.keenethics-labs.com/app/caliu)