Summy
Download for Mac

summy is a notepad your coding agent can write to.

A local MCP server for Claude Code, Codex and other MCP clients. It is opt-in, stays on your machine, and you can always take over.

Download for Mac

What can an agent do with summy?

It can list and read your notes, create new ones, append to or edit them, and have summy calculate the results, the same as typed text. It can also work with your My Numbers, the named live values in your notes, and see the names and hosts of your secrets, never their values.

Tool names
  • list_notes
  • read_note
  • create_note
  • lock_note
  • unlock_note
  • append
  • edit
  • edit_lines
  • evaluate
  • list_numbers
  • get_number
  • create_number
  • update_number
  • refresh_number
  • list_secrets

How do I connect Claude Code or Codex to summy?

Open summy, choose More, then "Agent access (MCP)", and turn on "Let agents use my notes". Copy the row for your client (Claude Code, Codex or .mcp.json) and run it.

  1. Open summy on your Mac, Windows or Linux computer.
  2. More menu, then Agent access (MCP).
  3. Turn on “Let agents use my notes”.
  4. Copy the row for your client and run it. For Claude Code it looks like this:
claude mcp add --transport http summy http://127.0.0.1:7766/mcp --header "Authorization: Bearer <token>"

Replace <token> with the token summy shows you. The server listens at http://127.0.0.1:7766/mcp.

Is it safe?

The server is local only (127.0.0.1), off by default, protected by a bearer token, and runs only while summy is open. Note text, tool arguments and results are never logged. While an agent holds a note's lock, the note is read-only for you, and you can always take over.

What does it cost?

Agents can read your notes for free. Letting agents create and edit notes needs summy Pro, a one-time $19 purchase with no subscription.

Which platforms does the MCP server run on?

The macOS, Windows and Linux desktop apps. It is not available on iPhone or Android.