Your AI, if you want it
Cairn keeps your notes as plain files you own, and it lets the AI assistant you choose work with them. On your terms.
Reading this through an AI? Plain-text version: cairn-notes.com/ai.md
Bring your own AI
Cairn’s Mac app includes a built-in MCP server. MCP (Model Context Protocol) is the open standard AI assistants use to work with your tools. Turn it on, and the assistant you choose can:
- search your notes
- read pages and follow your links and backlinks
- add to a page or to today’s journal
It works with Claude Code, Claude Desktop, Cursor and VS Code, and other assistants that can connect to an MCP server on your Mac. (Claude Desktop needs Node.js for a small bridge; ChatGPT can’t connect to local servers yet.)
What you can ask it
The idea is simple: an assistant does better when the tool handles the parts it tends to get wrong, like what day it is, or which of your to-dos actually matter, instead of guessing from a folder of files. Some things you can ask:
- “Add this to today’s journal.” Your assistant just says “today”; Cairn owns the clock. AI assistants often get the date wrong, so Cairn works out today, yesterday and last week from your Mac’s clock, and the entry lands on the right day.
- “What’s still open this week?” This week’s to-dos from across all your notes, not every unchecked box you’ve ever written.
- “Move yesterday’s unfinished to-dos to today.” Cairn moves them with everything nested under them, and can show the plan before it changes anything.
- “Summarize my journal from last week.” Your assistant reads a run of days at once, by the date each entry was written.
- “What have I written about the garden?” Ranked search, then the pages themselves along with everything that links to them.
- “Start a page for this project and link it from today.” A new page, linked where you’ll find it.
It works only with your notes. It can’t open other files, reach other apps or run anything on your Mac.
Why not point your AI at the files?
Your notes are Markdown, so an agent can read the files directly, and for a quick look that’s fine. The MCP server is better when your AI does real work:
- It edits safely. Changes go through Cairn itself, so they sync cleanly to your other devices. If you’re typing in a block, Cairn refuses the AI’s edit to it rather than overwrite you; if you both change the same note, you get a clear conflict prompt, never a silent overwrite. Editing the files behind Cairn’s back skips all of that.
- It understands structure. Blocks with stable IDs, backlinks, embeds, journals and to-dos come through as structure, not text to search. One call returns a page with its embeds resolved and everything that links to it.
- It keeps your links intact. Renaming a page through Cairn rewrites every link to it. Deleting one requires proof the note hasn’t changed since your AI last read it.
- It’s efficient. Ranked search, to-dos across your whole vault filtered by date, today’s journal by name: your assistant reads what matters instead of every file.
Off until you turn it on
- Off by default. Nothing listens until you turn it on in Settings → Cairn MCP Server, and Cairn tells you plainly what that allows.
- Local only. It runs inside Cairn on your Mac and accepts connections only from that Mac, and only with the access token shown in Settings.
- Cairn never sends your notes anywhere on its own. If you connect an assistant, what it reads may go to its provider, under that provider’s privacy policy.
Why files matter for AI
Your notes are plain Markdown files in your own iCloud. Any tool can read them today, and they’ll outlast any single app or model. Cairn doesn’t lock your thinking inside a database only it can open; it gives you a better way to write it, and a safe way to let AI help.
How to connect
- On your Mac, open Settings → Cairn MCP Server and turn it on.
- Under Connect an assistant, pick yours and click Copy: the setup comes with your address and token filled in.
- Paste it where your assistant asks, and keep Cairn running while you work.
Step-by-step setup for Claude Code, Claude Desktop, Cursor and VS Code →
Questions? Email support@cairn-notes.com.
This page will grow. We have a lot to say about notes and AI.