HushNotes Get HushNotes
Notes MCP · Setup

Connect a tool to your notes.

Claude Code, Claude Desktop, Codex, Cursor and other MCP clients can search and read your notes.

Nothing leaves your Mac. The tool reaches HushNotes on this machine only.

First, turn it on in Settings › Connections and copy the URL.

Pick your tool.

The steps below use a placeholder URL. Wherever you see it, put the URL you copied from Settings in its place.

http://127.0.0.1:48219/mcp/YOUR-TOKEN

  1. Open a terminalUse Terminal, in Applications › Utilities, or the terminal you already run Claude Code in.
  2. Add HushNotesPaste this, with your own URL at the end, and press Return.$ claude mcp add --transport http hushnotes http://127.0.0.1:48219/mcp/YOUR-TOKEN
  3. Check it is thereRun this. The list shows hushnotes as connected.$ claude mcp list
  4. Allow it in HushNotesThe first time Claude Code asks for your notes, HushNotes shows a card named claude-code. Click Allow. What the card looks like

Menu names in these tools change between versions. If a label here does not match, look for MCP or Connectors in that tool's settings.

The first time.

When a tool connects for the first time, HushNotes shows this card. It names the tool as the tool names itself, such as claude-code or claude-desktop, and says exactly what it is asking to do. Click Allow or press Return to let it in; click Deny or press Esc to refuse. If you do nothing for 60 seconds, that counts as Deny. If the tool later asks for wider access, the card comes back with a new headline, such as claude-code now wants to create notes too.

What each level allows.

There are two levels. You choose one in Settings.

Read-only

  • Search your notes
  • List them
  • Read the unlocked ones

Read & write

  • Everything in Read-only
  • Create a new note

Neither level can edit or delete a note that already exists.

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

Taking it away.

All three are in Settings › Connections.

  • RevokeRemoves one tool. The others keep working.
  • Regenerate tokenRevokes every tool at once. The URL changes, so any tool you want back needs the new one.
  • Switch it offTurn the connection off. No tool can reach HushNotes until you turn it on again.

If it does not work.

  • It connects, but its requests are refusedThe approval card is waiting in HushNotes. Answer it with Allow.
  • Connection refusedHushNotes is not running, or the connection is off. Open HushNotes and check Settings › Connections.
  • The port in your URL is not 48219If another app is using 48219, HushNotes moves up to a higher port. Copy the URL from Settings again and use that one.
  • The URL looks right but does not workCheck for a space after the token. Pasting sometimes adds one, and it breaks the URL.
  • The tool is on another MacIt only works on the Mac HushNotes runs on. The address points to that machine and nowhere else.

Still stuck? Tell us which tool you are using and you will hear back from the person who wrote it.

About Notes MCP