HushNotes
MCP

Connect your coding tool
to your notes.

Claude Code, Claude Desktop, Codex and Cursor can search and read your notes, over a connection that never leaves this Mac.

HushNotes127.0.0.1
Claude CodeClaude DesktopCodexCursor

Local endpointOff by defaultThis Mac only

Pick your tool
01 / Turn it on

Switch it on,
copy one URL.

The connection is off until you turn it on. Everything a tool needs is in that one address.

  1. 01Open Settings › ConnectionsOpen the HushNotes settings and go to Connections.
  2. 02Switch it onTurn on Let apps read your notes. It answers only on this Mac, and only while HushNotes is running.
  3. 03Copy the addressClick Copy next to Address for apps. It ends in your own token:http://127.0.0.1:48219/mcp/YOUR-TOKENBelow, wherever you see YOUR-TOKEN, use the address you copied.
HushNotes Settings, Connections: Let apps read your notes switched on, They can set to Read, the Address for apps on 127.0.0.1:48219 with a Copy button, Make a new address with Regenerate, and two allowed apps, claude-code and cursor, each with Remove.
A longer walk-through, with prompts that work
02 / Pick your tool

A minute per tool.

Pick yours. Each tab is a short recipe, with a copy button on every block.

  1. 01

    Open a terminal

    Use Terminal, in Applications › Utilities, or the terminal you already run Claude Code in.

  2. 02

    Add HushNotes

    Paste this, with your own URL at the end, and press Return.

    Terminal
    claude mcp add --transport http hushnotes \
    http://127.0.0.1:48219/mcp/YOUR-TOKEN
  3. 03

    Check it is there

    Run this. The list shows hushnotes as connected.

    Terminal
    claude mcp list
  4. 04

    Allow it in HushNotes

    The first time Claude Code asks for your notes, HushNotes shows a card named claude-code. Click Allow. What the card looks like

03 / The first time

You approve each tool,
by name.

The first time a tool connects, HushNotes shows this card. Nothing is shared until you answer it. Allowed apps are listed in Settings › Connections.

Approval card: claude-code wants to read your notes. Read-only: search your notes, list them, and read the ones that are not locked. It cannot change or delete anything. Locked notes are never shared and cannot be seen at all. Only on this Mac, only while HushNotes is running. Deny and Allow buttons.
  • ↩Return allowsOr click Allow. The tool is remembered by name.
  • escEsc deniesOr click Deny. The tool gets nothing.
  • 50sNo answer, nothing sharedAfter 50 seconds the card goes away by itself. Nothing is shared, and the tool can ask again.
  • Wider access asks againIf the tool later wants more, the card comes back: "claude-code now wants to create notes too".
04 / What each level allows

Read-only by default.
Writing is a choice you make.

There are two levels, Read and Read and write, under They can in Settings › Connections. Neither one can change a note that already exists.

What a tool can doReadDefaultRead and writeOpt in
Search your notes
List them
Read unlocked notes
Create new notes
Edit or delete a note
See locked or deleted notes

Locked notes are never shared. A connected tool cannot see them at all.

What local-only means, and what the tool you connect still sends
05 / Taking it away

Change your mind
at any time.

All three are in Settings › Connections.

RemoveUnder Allowed apps, takes one app’s access away. It asks again the next time it connects; the others keep working.
RegenerateMakes a new address and clears every allowed app at once. Any tool you want back needs the new address, and asks again.
Switch it offTurn off Let apps read your notes. No tool can reach HushNotes until you turn it on again.
How to check where any notes app keeps your words
06 / Troubleshooting

If it doesn't work.

Five things that go wrong, written the way they look from your side.

It connects, but every request is refusedThe approval card is waiting in HushNotes. Answer it with Allow.
Connection refusedHushNotes isn't running, or the connection is switched off. Open HushNotes and check Let apps read your notes in Settings › Connections.
The port in your URL isn't 48219If another app is using 48219, HushNotes moves up to a higher port. Copy Address for apps from Settings again and use that one.
The URL looks right but doesn't workCheck for a space after the token. Pasting sometimes adds one, and it breaks the URL.
The tool is on another MacThe connection only answers on the Mac HushNotes runs on. The address points to that Mac and nowhere else.
Still stuck? Tell us which tool you're using
07 / The rest of the app

It travels with the rest
of HushNotes.