Snug MCP server
Snug's MCP server lets your agents read your clipboard history (text, links, colors, pictures, files and pinboards), change your clips and pinboards, and ask you for changes only you make. Keys are never read.
What you need
- The
snugcommand at/usr/local/bin/snug. Install the snug command - Snug running.
- macOS 14 or later.
Set up
In Snug, open Settings > Agents > Setup. Under MCP setup, click Copy next to your agent. It copies the same text as below. Snug never writes these files for you.
Claude Code
Paste this into a terminal, then start a new Claude Code session:
claude mcp add --scope user snug -- /usr/local/bin/snug mcpClaude Desktop
Put the snug entry under mcpServers in ~/Library/Application Support/Claude/claude_desktop_config.json, then restart Claude Desktop:
{
"mcpServers": {
"snug": {
"command": "/usr/local/bin/snug",
"args": ["mcp"]
}
}
}Cursor
Put the snug entry under mcpServers in ~/.cursor/mcp.json, then restart Cursor:
{
"mcpServers": {
"snug": {
"command": "/usr/local/bin/snug",
"args": ["mcp"]
}
}
}Codex
Add this to ~/.codex/config.toml, then start a new Codex session:
[mcp_servers.snug]
command = "/usr/local/bin/snug"
args = ["mcp"]
tool_timeout_sec = 200Tools
Each tool says how Snug allows it: like a read, like a change, with no panel, or by asking you on the Mac.
search_clipsSearch clipboard history. Searches your clipboard history and pinboards, as the tray search does. Arguments: query, kind, pinboard, app, limit.list_recentRecent clips. Lists your newest clips. With pinboard, lists the pins of that pinboard in its order, each with its index (0 the first), and the total. Arguments: kind, limit, pinboard, app.get_clipRead a clip. Reads one clip by its id: text, a link, a color, a picture or the paths of files. Never a key. Arguments: id.list_pinboardsPinboards. Lists your pinboards with their names, colors and number of clips. Arguments: none.pin_clipPin a clip. Pins a clip to a pinboard, as Pin to in Snug: a copy goes to the front of the pinboard and the clip stays where it is. Content the pinboard holds already moves to its front. A key is pinned by its ref, never by its value. Returns the pin's own id and index. Arguments: pinboard (required), id or latest, kind.unpin_clipUnpin a clip. Takes a clip out of a pinboard: a pin by its id, or a clip of the history or a key's ref with pinboard. The clip in the history stays. Arguments: id (required), pinboard.move_pinMove a pin. Moves a pin to another pinboard, or to another place in its pinboard: index (0 the first), before or after another pin. Returns its id and index. Arguments: id (required), pinboard, index, before, after.create_pinboardCreate a pinboard. Creates a pinboard at the end of the row. Arguments: name (required).rename_pinboardRename a pinboard. Gives a pinboard a new name. Arguments: pinboard (required), name (required).delete_pinboardDelete a pinboard. Deletes a pinboard and its pins. The clips in the history stay. Without confirm: true nothing is deleted, and the answer says what would go. Arguments: pinboard (required), confirm.list_keysList keys. Lists your keys: ref, kind, masked tail, name, and when each was saved and last used. Never a value. Arguments: none.renameRename a clip or key. Gives a key or a clip a new name. Only the name changes, never a value. An empty name removes it. No panel asks; you see the rename in Activity. Arguments: target (required), name (required), reason (required).color_pinboardColor a pinboard. Gives a pinboard another color. Arguments: pinboard (required), color (required).move_pinboardMove a pinboard. Moves a pinboard to another place in the row: index (0 the first), or one place left or right. Arguments: pinboard (required), index or direction.delete_clipDelete a clip. Deletes a clip of the history or a pin, with no undo. Without confirm: true nothing is deleted. A key is refused. Arguments: id (required), confirm.edit_clipEdit a clip. Gives a text, link or color clip new plain text. A text that holds a secret is refused, and so is a key. Arguments: id (required), text (required).revert_clipRevert a clip. Takes an edited clip back to what was copied. Arguments: id (required).mark_secretMark a clip as secret. Moves the text of a clip into Snug's vault as a key and returns its ref. Every copy of the text leaves the history and the pinboards. Arguments: id (required).list_grantsList the grants of keys. Lists the grants of your keys, as Keys shows them, and whether raw use is allowed. Never a value. Arguments: ref.key_activityRead the Activity of keys. Lists the newest rows of Keys > Activity: who used a key, how, the program and the result. The reason an agent gave is for the user only. Never a value. Arguments: ref, limit.list_runsList the live proxy runs. Lists the live runs of snug run --proxy, with the id that stop_run takes. Arguments: none.revoke_grantRevoke grants of a key. Revokes grants of a key: those of an action and a program or env file, or all of them. Raw use stays. Arguments: ref (required), reason (required), action, target, all.stop_raw_useStop raw use of keys. Stops raw use of keys, so they work through the proxy only again. Arguments: refs (required), reason (required).stop_runStop a live proxy run. Ends a live proxy run, or every live run of a key. The program gets 401 on its next call. Arguments: reason (required), run or ref.end_hour_grantsEnd the hour grants. Ends the 1 hour grants of clip reads and changes in this project, or in every project with all. Arguments: reason (required), all.stop_agent_accessStop all agent access. Turns on Stop All Agent Access: every proxy run ends and every later agent request is refused. Only you turn it back on. Arguments: reason (required).revoke_phoneRevoke the paired phone. Revokes the phone paired to answer approvals, so its answers count no more. Only you pair a phone again. Arguments: reason (required).copy_clipCopy a clip to the clipboard. Puts a clip on your clipboard, as Copy in Snug. Every app can read the clipboard, so it is asked like a read. A key is refused. Arguments: id (required), plain.resume_captureResume recording. Starts the recording of copies again. Arguments: none.get_settingsRead the settings. Reads your settings: the pause, Keep History, the capture rules, ignored apps, the agent switches and more. No key, no license. Arguments: none.set_switchTurn a setting off. Turns a setting off, the side that only takes access away: clip_reads, clip_changes, auto_value, link_previews or screen_sharing. Arguments: switch (required), on (required), reason (required).ask_delete_keyAsk the user to delete a key. Asks you to delete a key, with its approvals, cards and Activity. Arguments: ref (required), reason (required).ask_allow_raw_useAsk the user to allow raw use. Asks you to allow raw use of keys, so run --env, pipe and put can hand out their values. Arguments: refs (required), reason (required).ask_resume_accessAsk the user to turn agent access back on. Asks you to turn agent access back on after Stop All Agent Access. Arguments: reason (required).ask_not_a_secretAsk the user to turn a key back into text. Asks you to turn a key back into a text clip in your history. Returns the id of the text clip, never its content. Arguments: target (required), reason (required).ask_revert_valueAsk the user to bring back a key's old value. Asks you to bring back the value a key had before its last Replace Value. Arguments: ref (required), reason (required).ask_erase_historyAsk the user to erase the history. Asks you to erase your clipboard history. Pinboards and keys stay. Arguments: confirm (required), reason (required).ask_keep_historyAsk the user to change Keep History. Asks you to change how long your history is kept. A shorter time deletes older clips now. Arguments: keep (required), reason (required).ask_set_switchAsk the user to change a setting. Asks you to turn a setting on, or ignore_confidential or ignore_transient either way. Arguments: switch (required), on (required), reason (required).ask_unignore_appAsk the user to record an app again. Asks you to record the copies of an ignored app again. Arguments: app (required), reason (required).ask_always_load_hostAsk the user to load the previews of a host. Asks you to let the link previews of a host load with no click. Arguments: host (required), reason (required).ask_pause_captureAsk the user to pause recording. Asks you to pause the recording of copies, for minutes or until resumed. While paused, a key you copy stays on the clipboard as text. Arguments: minutes, reason (required).ask_ignore_appAsk the user to ignore an app. Asks you to stop recording the copies of an app, by its bundle id or its name. A key you copy there stays on the clipboard as text. Arguments: app (required), reason (required).
Approvals
The first time an agent reads a clip in a project, Snug shows its panel: Always Allow, Allow for 1 Hour, Allow Once or Deny.
- Allow Once covers this one request.
- Allow for 1 Hour lets programs in this project read your clips for one hour.
- Always Allow turns on Allow agents to read clipboard history in Settings > Agents > Access. It is off by default. Turn it off there to make agents ask again.
- Keys are never shown and always ask.
Changes to clips and pinboards
Changing your clips and pinboards, and resuming recording, is a permission of its own. A read you allowed does not allow a change. copy_clip is asked like a read, since every app can read the clipboard.
- The first change in a project asks you. Snug's panel shows the exact change, such as Pin 'npm test' to Work, with the same buttons.
- Always Allow turns on Allow agents to change clips and pinboards in Settings > Agents > Access.
- Deleting a clip or a pinboard always asks, with Allow Once only. Allow for 1 Hour and Always Allow never cover it, and the agent must also send confirm: true.
- Changes need a Snug license after the free trial.
- A pinned key shows only its ref and masked tail, never its value.
No panel
Lists of metadata, a rename and tools that only take access away ask no one. Each needs a reason, and you see it in Snug. No value is ever shown.
Asking you
The ask_ tools ask for a change only you make, such as deleting a key or erasing your history.
- You answer a panel on the Mac and confirm with Touch ID or your password, every time. Nothing is kept.
- After you deny an ask, do not answer, or cancel Touch ID, every ask is refused for 3 minutes, from every agent and project.
- Agents never answer a panel, clear denied requests, replace a key's value, paste or copy a key, or change your license, usage counts, pairing, sign-ins, skill install or sandbox setup.