Skip to content
AI apps

Connect your notes, calls and calendar to your AI apps

In Koi's Settings, Connections, AI apps, click Connect next to Claude, Cursor or Codex, or copy the command for Claude Code, then reopen the app. It can then search and read your notes, recorded calls and calendar over MCP, answered by Koi on your Mac.

By Irakli, founder ·

How do I let Claude or Cursor read my notes on a Mac?

Give the AI app an MCP server that can reach your notes. MCP, the Model Context Protocol, is the open standard Claude, Cursor, Claude Code and Codex use to plug into other tools. Koi, a Mac app for dictation, recorded calls, documents and a calendar, has one built in. In Koi's Settings, Connections, AI apps, click Connect next to the app (or Copy command for Claude Code), reopen it, and ask about your week.

We make Koi. This page is how to wire it up, what the AI app can then do, and where your data goes. The setup is also on Koi's help page, connect your AI apps.

Connect Claude, Cursor, Claude Code or Codex

  1. Open Koi's Settings and go to Connections. AI apps is under your calendars.
  2. Click Connect next to Claude, Cursor or Codex. An app that isn't installed says Not on this Mac.
  3. For Claude Code, click Copy command and paste it into your terminal once.
  4. Quit and reopen that app, or start a new session in it. The row in Koi now says Connected.
  5. Ask something only your notes know: “what did Sam say about pricing on Tuesday's call?”

Connect adds Koi to the app's own MCP settings and leaves everything else in them as it was. Here is where it goes, so you know what changed:

AppWhere Koi is addedThen
Claude (Mac app)~/Library/Application Support/Claude/claude_desktop_config.jsonQuit and reopen Claude
Cursor~/.cursor/mcp.json, for every projectReopen Cursor
Claude CodeIts user settings, through the copied claude mcp add --scope user commandRun /mcp in a session to check
Codex~/.codex/config.toml, as [mcp_servers.koi]Start a new session

Those are the files each app's own docs name: the MCP guide for Claude's Mac app, Cursor's MCP docs, Claude Code's and Codex's, checked October 21, 2026. Codex's docs say its CLI and IDE extension share that file. Cursor asks before it runs an MCP tool, unless you change that.

Another app that runs MCP servers on your Mac can use Koi too: give it Koi's own program as the command, /Applications/Koi.app/Contents/MacOS/Koi when Koi is in Applications, with --mcp as its one argument.

What your AI app can do with Koi

Once connected, the app gets thirty of Koi's tools. In practice that means you can type things like these and the app does them in Koi:

  • “Find what we decided about the onboarding flow in last week's calls and turn it into a page.” It searches your documents, calls, dictations and chats, reads the ones that match, and makes a new page in Koi.
  • “Summarize my notes from the Acme calls into a list of open questions.” It reads the transcripts on your Mac and writes the list where you are.
  • “Add the dentist on Thursday at 3, and remind me to send the invoice on Friday.” It adds them to Koi's calendar, or your Google or Apple calendar if you say so.
  • “What do I spend a month on subscriptions?” It reads your expense tracker.
  • “Make flashcards from my biology notes.” The cards go onto that page, ready to study.
  • “Transcribe ~/Downloads/interview.m4a.” It's written down on your Mac as a new document with timestamps.
  • “Start recording this meeting.” It starts a recording, as the keys would.

The full set: documents (search, list, read, make, edit, rename, move, archive, delete to Recently Deleted, restore, open), folders, export to Markdown or Word, importing a file, transcribing audio or video, study notes, Koi's file actions, flashcards, the calendar with your connected Google and Apple ones, expenses, Koi's memory, your dictation snippets and dictionary, your dictation numbers, starting dictation, a recording, a call or the chat, and Study mode. See Koi's documents and calendar for what lives there.

It runs on your Mac

The AI app starts Koi's own program with --mcp. That program holds nothing: each request goes over a private socket in Koi's data folder, which only your user account can open and which only answers Koi's own program, to the Koi that's running. If Koi isn't running, it opens in the background first. The work is done there, on the Mac, the way you would do it by hand.

  • Reading and changing your documents, calendar, expenses, memory, snippets and dictionary goes through no server of ours.
  • Study notes and Koi's file actions (explain, translate, add an expense, add to the calendar) send the document's or file's words to Koi's AI, as they do from Koi itself.
  • What the AI app reads, it sends to its own AI under its own terms. Connect only the apps you'd trust with your notes.

What it can't do without you

  • A page it deletes goes to Recently Deleted and waits there for 30 days.
  • Events on your Google or Apple calendars are never deleted by it, and they only change with “Let Koi use my Mac for me” on, in Settings, under Koi.
  • An event with guests opens in Koi's calendar for you to check and send with Done. Nothing emails anyone by itself.
  • Koi refuses to keep a card number, wherever it comes from.

To disconnect an app, remove the koi entry from its MCP settings. In Claude Code, that's claude mcp remove koi.

If the AI app can't see Koi

  • Koi doesn't show up in the app: quit it completely and open it again. Claude's Mac app and Cursor read their MCP settings when they start.
  • Koi says it couldn't read Claude's or Cursor's settings file: the file isn't valid JSON, so Koi left it alone. Fix or remove the broken part, then click Connect again.
  • The app says Koi isn't running and couldn't be opened: open Koi yourself once, then ask again.
  • Claude Code doesn't list it: run claude mcp list in your terminal. If koi is missing, paste the copied command again.
  • A search misses a call you know exists: search matches words, not meaning. Ask again with a name or a word that was said.

What it doesn't do

  • It's one Mac. An AI app on another computer can't reach your Koi.
  • It works with apps that run MCP servers on your Mac. A chat in a browser tab can't connect.
  • Koi is Mac only.

AI apps come with every Koi plan. Pro is $20 a month, or $192 a year, after a 3-day free trial that needs a card. Lifetime is paid once, from $59. See pricing, and our launch post, Claude and Cursor can now use Koi. To get more into those notes in the first place, record your calls and see how to get a brief before a meeting.

Keep exploring

Your AI apps can use Koi now

Connect Claude, Cursor, Claude Code or Codex to Koi over MCP: they search your calls and notes, write pages, and fill in your calendar and expenses.

Notes on your Mac, with tables, charts and math

Koi for Mac is an offline notes app with tables, 11 chart types, LaTeX, to-dos and flashcards. Export to Word or PDF, and start by typing or by talking.

How to dictate in Cursor on a Mac

How to dictate in Cursor on a Mac: Cursor's own voice input for the Agent, Apple Dictation for the editor and terminal, and one key that types prompts anywhere.

Frequently asked questions

Try Koi on your Mac

Try Pro free for 3 days, card needed. Dictation and recorded calls are unlimited on every plan.