MCP server for clipboard in AI

Clipboard AI Integration via MCP: The clipboard-mcp Server

AI assistants like Claude Desktop and Claude Code don’t have direct access to the system clipboard. This forces extra steps in your workflow: copy an error, paste into chat, get a fix, then copy back. The clipboard-mcp server built in Rust solves this by offering three tools—read, write, and monitor the clipboard—via the Model Context Protocol (MCP).

Core Server Tools

clipboard-mcp implements an MCP server with these tools:

• get_clipboard: pulls clipboard content directly. AI receives data without manual pasting into the chat.
• set_clipboard: writes output back to the clipboard. Ready for Ctrl+V in your editor or terminal.
• watch_clipboard: monitors clipboard changes via polling. Default timeout is 30 seconds, max 5 minutes.

A ~250-line binary with no runtime dependencies. Supports Windows, macOS (Intel/Apple Silicon), and Linux (X11/Wayland).

Install via cargo install clipboard-mcp or use prebuilt releases. Connect to Claude Desktop by adding to claude_desktop_config.json:

{
  "mcpServers": {
    "clipboard": {
      "command": "clipboard-mcp"
    }
  }
}

For Claude Code: claude mcp add clipboard clipboard-mcp.

Practical Use Cases

Round-trip Processing

Copy → Process → Result in clipboard in just two steps:

• Log error → "Fix this" → Fix ready to paste.
• Text → "Translate to German" → Translation in clipboard.
• JSON → "Format it" → Clean, structured output.

Data Transformation

CSV from Excel → "Convert to JSON" → Formatted JSON ready to insert. Great for YAML↔JSON, Markdown→HTML, XML conversions.

Clipboard Monitoring

"Watch for 60 seconds, analyze code on every Ctrl+C." AI reacts instantly to each copy without switching windows.

Code Review

GitHub snippet → Ctrl+C → "Check for bugs." Preserves formatting—no need to paste into chat.

Streaming via Clipboard History

Agent calls set_clipboard at each step. With a clipboard manager (like KDE or GNOME), you see a live stream of intermediate results.

Technical Implementation

Built on rmcp (Rust SDK for MCP), arboard (cross-platform clipboard), and tokio (single-threaded runtime).

Clipboard operations run in spawn_blocking to prevent blocking the MCP server. Uses JSON-RPC over stdio.

Linux nuances: Clipboard behavior depends on the clipboard manager. Without one, data may vanish when the owner exits. Automatic integration with KDE, GNOME, Sway+clipman.

| Platform | Architecture | Status |

|----------|--------------|--------|

| Windows | x86_64 | Windows 11 |

| macOS | x86_64, aarch64 | macOS 26.4 (Apple Silicon) |

| Linux | x86_64, aarch64 | X11 + Wayland (wl-data-control) |

CI builds all targets.

Security & Limitations

Full AI access to clipboard:

• get_clipboard returns everything—including passwords and sensitive data.
• set_clipboard overwrites without confirmation (1 MB limit).
• watch_clipboard captures every subsequent Ctrl+C.

Use only in trusted sessions. Open source (MIT), ~250 lines for easy audit.

Key Takeaways

• Cuts workflow from 7 to 2 steps when processing copied content.
• Cross-platform MCP server with zero dependencies—just ~250 lines of Rust.
• Tools: get/set/watch clipboard; integrates with Claude Desktop and Code.
• Works across all desktop environments, including Wayland; security rests with the user.

— Editorial Team