All guides
AI agents

Let an AI agent use your notes

On the computer, Fast Memo can answer AI agents through MCP: they search, read and add notes for you. It's off until you turn it on, and locked and hidden notes stay out of reach.

  • Published
  • 6 min read

What is it?

MCP (Model Context Protocol) is how AI agents use other programs. With it on, an agent you use on your computer, such as Claude Code, Codex, Claude Desktop or Cursor, can find a note, read it or write a new one while you work with it.

What an agent reads is sent to the provider of the model it uses. Turn it on only for agents you trust, and keep private notes locked or hidden.

  • Only on this computer

    Agents reach Fast Memo through a private connection on the computer, with no network port.

  • Off by default

    Nothing answers until you turn it on, and one switch turns it off.

  • Locked notes stay locked

    Locked and hidden notes are never found, read or changed.

  • A version before every edit

    Fast Memo keeps the note as it was before an agent changes it.

What an agent can do

Each thing an agent can do is a switch in the settings. Editing and the trash start off.

SwitchWhat it doesAt first
Create notesAdds a text, to-do, kanban or code note.On
List categoriesReads the names of your categories, so a new note can go in the right one.On
Search notesFinds notes by their words.On
Read notesReads a note's title and content.On
Set note flagsMarks a note as important, read-only or locked.On
Read the helpReads Fast Memo's help, to answer questions about the app.On
Check for updatesSays whether a new version is out. It installs nothing.On
Edit notesChanges the notes it can read. While it's off, an agent can only edit the notes it created in the same session.Off
Move notes to the trashMoves a note to the trash, where you can restore it.Off

What an agent can never do

Find, read or change a locked or hidden note; remove a lock or read-only, or unhide a note; delete a note for good or empty the trash; change settings, sync, backups or categories; install updates; use the AI assistant.

How to turn it on

  1. In Fast Memo on Windows, macOS or Linux, go to “Settings” → “Advanced” → “MCP”.

  2. Turn on “Let AI agents use Fast Memo”.

  3. Under “Tools”, leave on only what you want agents to do. A change applies from the agent's next request.

Connect your agent

Under “Connect an agent”, the same screen has the text to add for each agent, with a “Copy” button. It already holds the path of Fast Memo on your computer: copy it from there rather than typing it. The examples below show the path on a Mac.

Claude Code

Run it in a terminal.

claude mcp add fastmemo -- "/Applications/Fast Memo.app/Contents/MacOS/Fast Memo" --mcp

Codex

Run it in a terminal.

codex mcp add fastmemo -- "/Applications/Fast Memo.app/Contents/MacOS/Fast Memo" --mcp

Claude Desktop and Cursor

{
  "mcpServers": {
    "fastmemo": {
      "command": "/Applications/Fast Memo.app/Contents/MacOS/Fast Memo",
      "args": [
        "--mcp"
      ]
    }
  }
}

Save it in claude_desktop_config.json for Claude Desktop (Settings → Developer → Edit Config), or in ~/.cursor/mcp.json for Cursor. If the file already has other servers, add only the fastmemo entry inside mcpServers.

On a Mac, keep Fast Memo in the Applications folder: if you move it, the connection stops working.

Then ask your agent something like “find my shopping list in Fast Memo”.

When the window is closed

  • macOS: closing the window leaves Fast Memo running in the Dock, so agents still reach it. Quitting with ⌘Q stops it.
  • Windows and Linux: with “Keep running in the background” on (the default), closing the window leaves Fast Memo in the tray, with “Open Fast Memo” and “Quit”. With it off, closing the window quits.

If Fast Memo isn't open, the agent hears “Fast Memo isn't reachable: check it's open and that MCP is on in its settings.” Open it: the agent doesn't need a restart.

Limits and safety

  • With “Edit notes” off, an agent can change only the notes it created on its current connection. In Claude Code that's one session; the right ends when the connection or Fast Memo closes.
  • An agent can write up to 30 times a minute and 300 times an hour.
  • Read-only notes can be read, never changed or moved to the trash.
  • Before an agent edits a note, Fast Memo keeps a version (“Before an AI agent” in the note's history). Agent edits sync and fire webhooks like yours.
  • Markdown an agent writes arrives as plain text, and pictures are left out when it reads a note.

Turn it off

Turn off “Let AI agents use Fast Memo” and every connected agent is cut off at once: there's no key to revoke. To remove Fast Memo from an agent's list, delete its entry in that agent's settings.