{
  "markdown": "# clipboard-mcp\n\n[![CI](https://github.com/mnardit/clipboard-mcp/workflows/CI/badge.svg)](https://github.com/mnardit/clipboard-mcp/actions)\n[![Crates.io](https://img.shields.io/crates/v/clipboard-mcp.svg)](https://crates.io/crates/clipboard-mcp)\n[![License: MIT](https://img.shields.io/crates/l/clipboard-mcp.svg)](LICENSE)\n\nCross-platform [Model Context Protocol](https://modelcontextprotocol.io) (MCP) server that gives AI assistants direct read/write access to your system clipboard. **[Website](https://max.nardit.com/clipboard-mcp)**\n\nCopy an error → ask Claude to fix it → the fix lands in your clipboard. No manual paste into chat, no manual copy from response.\n\n```bash\ncargo install clipboard-mcp\n```\n\n## Why clipboard-mcp?\n\n- **Single binary** — no Python, no Node.js, no runtime to install\n- **Native clipboard** — uses [arboard](https://github.com/1Password/arboard) by 1Password, not shell commands like `pbcopy`/`xclip`\n- **Watch mode** — `watch_clipboard` lets agents react to what you copy in real-time\n- **HTML + format detection** — read HTML content, probe available clipboard formats\n- **Cross-platform** — Windows, macOS (Intel + Apple Silicon), Linux (X11 + Wayland)\n- **HTTP transport** — run as a local HTTP server for remote agent access\n\n## Tools\n\n| Tool | Description |\n|------|-------------|\n| `get_clipboard` | Read current text from the clipboard. Content over 100 KB is truncated. |\n| `get_clipboard_html` | Read HTML content from the clipboard (e.g., rich text from browsers). |\n| `set_clipboard` | Write text to the clipboard (max 1 MB). |\n| `watch_clipboard` | Wait for clipboard text to change (default 30s, max 300s). Max 5 concurrent. |\n| `list_clipboard_formats` | Probe which formats are available (text, HTML, image, files). |\n| `clear_clipboard` | Clear all clipboard content. |\n\n### watch_clipboard parameters\n\n| Parameter | Type | Default | Description |\n|-----------|------|---------|-------------|\n| `timeout_secs` | integer (optional) | 30 | Seconds to wait for a change (max 300) |\n\n## Installation\n\n```bash\ncargo install clipboard-mcp\n```\n\nOr download a binary from [GitHub Releases](https://github.com/mnardit/clipboard-mcp/releases).\n\n## Configuration\n\n### Claude Desktop (stdio, default)\n\nAdd to `claude_desktop_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"clipboard\": {\n      \"command\": \"clipboard-mcp\"\n    }\n  }\n}\n```\n\n### Claude Code (stdio)\n\n```bash\n# Add for current project\nclaude mcp add clipboard clipboard-mcp\n\n# Or add globally\nclaude mcp add --scope user clipboard clipboard-mcp\n```\n\n### HTTP Transport\n\nRun as an HTTP server for remote or programmatic access:\n\n```bash\nclipboard-mcp --http                          # 127.0.0.1:3100\nclipboard-mcp --http --port 8080              # custom port\nclipboard-mcp --http --host 0.0.0.0           # expose to network (see Security)\n```\n\nMCP endpoint: `http://HOST:PORT/mcp`\n\n## Usage Examples\n\n**Read and transform:**\n> \"Take whatever is on my clipboard and rewrite it in a more formal tone, then put the result back.\"\n\n**Watch for changes:**\n> \"Watch my clipboard for 60 seconds. When I copy something, summarize it in one sentence.\"\n\n**Round-trip:**\n> \"Get my clipboard, translate it to German, and set the translation back.\"\n\n**Data transform:**\n> Copy a CSV table → \"Convert what's on my clipboard to JSON\" → paste formatted JSON into your editor.\n\n**Code from clipboard:**\n> Copy a code snippet from a browser → \"Review the code on my clipboard for bugs\" → Claude reads it directly, no pasting into chat.\n\n**Step-by-step agent output via clipboard history:**\n> Run a multi-step task and `set_clipboard` after each step. With any clipboard manager (Paste, CopyQ, Klipper), you get a chronological log of every result — browse, search, and review the agent's work without switching windows.\n\n## Platform Support\n\n- **Windows** (x86_64) — clipboard persists via OS pasteboard\n- **macOS** (x86_64, aarch64) — clipboard persists via OS pasteboard\n- **Linux** (x86_64, aarch64) — X11 and Wayland (via `wl-data-control` protocol)\n\n> **Linux note:** On Linux, clipboard content set by the server is kept alive by a background thread. If no clipboard manager is running (bare WMs like i3/dwm), install `clipman`, `parcellite`, or `copyq`.\n\n## How It Works\n\nSingle binary. Uses [arboard](https://github.com/1Password/arboard) (by 1Password) for native clipboard access. Communicates via MCP protocol over stdio (default) or HTTP (`--http` flag, Streamable HTTP transport). No runtime dependencies on Windows and macOS; Linux requires X11 libs or a Wayland compositor with `wl-data-control` support.\n\n## Troubleshooting\n\n**Linux: clipboard content disappears**\nEnsure a clipboard manager is running. On bare window managers (i3, dwm), install `clipman`, `parcellite`, or `copyq`.\n\n**Wayland: \"clipboard is empty or contains non-text content\"**\nYour compositor must support the `wl-data-control` protocol. Sway, Hyprland, GNOME, and KDE all do. Older compositors may not.\n\n**macOS: clipboard access denied**\nEnsure the terminal running the MCP server has clipboard permissions in System Settings > Privacy & Security.\n\n## Security\n\nThis server gives connected MCP clients full read/write access to your system clipboard:\n\n- **`get_clipboard`** / **`get_clipboard_html`** — return clipboard content verbatim\n- **`set_clipboard`** — silently overwrites clipboard contents (max 1 MB)\n- **`watch_clipboard`** — returns the next thing you copy, verbatim\n- **`clear_clipboard`** — wipes clipboard without confirmation\n\nOnly connect this server to AI sessions you trust. Do not use it in environments where sensitive data (passwords, tokens) may be on the clipboard.\n\n**HTTP mode:** Default bind is `127.0.0.1` (localhost only). Binding to `0.0.0.0` with `--host` exposes clipboard to all reachable network interfaces. Browser-initiated requests (with `Origin` header) are rejected with 403. There is no authentication — non-browser HTTP clients are not restricted. For remote access, prefer SSH tunneling over exposing to the network.\n\n## Contributing\n\nBug reports and pull requests are welcome. For major changes, please open an issue first.\n\n## License\n\nMIT\n",
  "bytes": 6154,
  "sha": "07f8dd32441cce0662c2b0d4f0091601981189452068d67ecf9662ed553ac85d",
  "repo_slug": "mnardit/clipboard-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_mnardit_clipboard_mcp_3caf4707/readme"
}