Skip to content
SnugDownload for Mac

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

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 mcp

Claude 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 = 200

Tools

Each tool says how Snug allows it: like a read, like a change, with no panel, or by asking you on the Mac.

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.

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.

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.

For agents: the full reference