MCP server

Connect Claude to your notes
without putting them on anyone's server

Snoq ships an MCP server. Your AI assistant can read, search and write your notes by talking to the copy of Snoq already running on your machine - not to a cloud API, because there isn't one.

What an MCP server actually is

The Model Context Protocol is an open standard for letting an AI assistant use a tool. An MCP server advertises a list of things it can do - "list the notes", "search the notes", "append to this note" - and the assistant calls them when your request needs one. It is the difference between pasting a note into a chat window and asking the assistant to go and find it.

Snoq is the MCP server. There is no separate program to install, no sidecar process to keep updated, no API key to generate on a website. The feature is part of the app you already have, and it is off until you turn it on.

What that looks like in practice

You ask your assistant something like:

  • "What did I write in my project notes about the pricing model?"
  • "Add today's meeting outcome to the note called Roadmap."
  • "Start a note called Trip planning under the Personal category."

Snoq answers from the notes on your disk. When the assistant writes, the text appears in the open editor while you watch - not on the next restart.

Why this one runs on your machine

Most integrations of this kind work by giving a cloud service access to a cloud account. Snoq has neither. The bridge listens on 127.0.0.1 - the loopback address, reachable only from your own computer - and your assistant talks to it through a local process. Nothing about your notes crosses the network, because there is no network hop to make.

Loopback only

The bridge is bound to localhost. It is not exposed to your network, your router, or the internet. Another machine on your Wi-Fi cannot reach it.

A token, per install

Every request must carry a bearer token generated on your machine. You can reveal it, copy it, or reset it from Settings → MCP - a reset cuts off anything you connected earlier.

No Snoq account, still

The MCP feature does not add one. There is no sign-in, no linked identity, no server-side record that you enabled it.

Your assistant is the only reader

Whatever your assistant reads travels to whichever AI provider you chose to use, under their terms. Snoq's part of the chain stays local - but the assistant's does not, and that is worth deciding deliberately.

Connect an assistant in one line

Open Snoq, go to Settings → MCP, and tick Let AI assistants connect to Snoq. The page then gives you a copy button for your client. You do not have to type any of the following by hand - and you should use the copy button rather than the samples below, because it fills in the real path to your own install.

Snoq's Settings screen on the MCP page: the master switch ticked and reading Ready, buttons to copy the setup for Claude Code and Claude Desktop, three separate permission checkboxes, and the access token field
Settings → MCP: one switch to let assistants connect, one button to copy the setup, and a separate checkbox for each thing they may do

Claude Code

Press Copy for Claude Code and paste the line into a terminal:

claude mcp add --scope user snoq -- "C:\Users\you\AppData\Local\Snoq\snoq-mcp.exe"

Claude Desktop

Press Copy for Claude Desktop and paste the block into its config file:

{ "mcpServers": { "snoq": { "command": "C:\\Users\\you\\AppData\\Local\\Snoq\\snoq-mcp.exe", "args": [] } } }

Two things worth knowing

Snoq does not have to be open. When the assistant first needs your notes, it starts Snoq for you and waits for it. Closing the app does not break the connection.

There is no address to keep up to date. The setup you copy contains no port number and no token - only the path to the app. That is deliberate: it means nothing in your assistant's configuration can quietly go stale and stop working after an update or a restart.

Three switches, all off until you say so

Reading every note you own is the largest thing this feature can do, so it does not happen quietly. The master switch is off in a fresh install, and each additional capability is its own checkbox in Settings → MCP. Changes take effect immediately - no restart, and no need to reconnect your assistant.

Let AI assistants connect to Snoq

The master switch. Off by default. While it is off, every request is refused with a message telling the assistant that you turned the feature off - the assistant can explain what happened instead of guessing at a broken connection.

Allow it to change my notes

Off by default, which means a freshly connected assistant is read-only. Turn it on and it can create notes, rename them, star them, append to them and rewrite them. Leave it off and every one of those is refused while reading still works.

Allow it to unlock my notes

Off by default, and best left that way. Switching it on means handing your passphrase to the assistant, which puts it in your conversation history with whichever AI provider you use. With it off, the assistant can still ask Snoq to bring the unlock prompt to the front - you type the passphrase into Snoq, as usual, and it never travels anywhere.

There is a fourth checkbox, Enable developer tools, which lets an assistant drive Snoq's interface directly. It exists for testing Snoq itself. Leave it off.

How it behaves with an encrypted vault

If you have set a passphrase, the MCP server respects it exactly as the app does. While the vault is locked, note content is not readable through the bridge - requests to read, search or change a note are refused, and the assistant is told the notes are locked and that it should ask you to unlock them.

Locking works the other way too. Your assistant can lock the vault on request, and doing so clears the decryption keys from memory the same way the keyboard shortcut does - it is a real lock, not a screen that looks locked.

Locking covers the note list, not just the note bodies. Titles and categories happen to be stored unencrypted, but Snoq will not hand them over while the vault is locked - because you cannot read them either at that moment, with the unlock prompt covering the window. An assistant that asks what notes exist gets the answer you would give it: unlock first. The full construction is documented on the encryption page.

Common questions

"Does this send my notes to Anthropic, or to you?"

Not to us - Snoq has no server and receives nothing. Whatever your assistant actually reads does go to the AI provider running that assistant, because that is where the assistant runs. If you ask it to summarise a note, the note's text is in that request. Snoq's job is to make sure that only happens when you have switched the feature on, and only for what you asked about.

"Which assistants work with it?"

Any MCP client. Snoq's settings page has one-press setup for Claude Code and Claude Desktop because those are the two we test against. Other clients that speak the protocol connect the same way - they run Snoq.exe mcp-stdio and talk to it over standard input and output.

"Can the assistant delete a note?"

Not on its own. It can ask you to: Snoq comes to the front with the note open and its usual "are you sure?" prompt showing, and you answer it. The assistant cannot answer for you. Snoq has no undo, and a deleted note is the one loss you might never notice, so that decision stays yours. Changing or removing your passphrase is not exposed at all, and neither is importing or exporting an encrypted archive. See what the assistant may do for the complete list, including what is left out and why.

"What if I am editing a note when the assistant writes to it?"

Your unsaved typing is kept. Snoq treats the editor's live buffer as the starting point rather than the last saved copy, applies the change on top, and refreshes every open tab showing that note. You see the text appear in front of you.

"How do I turn it off again?"

Untick the master switch in Settings → MCP. It takes effect on the next request - no restart. To cut off a client permanently, press Reset on the access token as well.

Your notes, and an assistant that can actually reach them

Free, offline, no account. Windows 10 and 11.

Download Snoq free

Windows 10 / 11 - ~166 MB - no admin required