Clipboard MCP Server

An MCP server that gives your AI assistant direct access to your system clipboard: read what you copied, or write clean text straight to it. Works with any MCP-compatible client, including Claude Code, Claude Desktop, Cursor, Windsurf, and others. Its 7 documented tools cover clipboard, copy. It runs locally over stdio via the published package.

People connecting media tools to Claude, Cursor, VS Code, or another MCP client. The project is written in Python.

VERIFIED ACTIVE

LAST COMMIT 2026-07-20 · ★ 5 · #93 OF 155 MAINTAINED MEDIA · VERIFIED 2026-08-25

Apache-2.0 · Python servers · how we verify → /methodology

01 · Install Clipboard

Claude Code

claude mcp add cmeans-mcp-clipboard -- uvx mcp-clipboard

Claude Desktop / Cursor / VS Code - add to config

{
  "mcpServers": {
    "cmeans-mcp-clipboard": {
      "command": "uvx",
      "args": [
        "mcp-clipboard"
      ]
    }
  }
}

Same JSON for Cursor. For VS Code, rename the top-level key from `mcpServers` to `servers`.

Using another client? Same JSON, different key

Claude Desktop · mcpServers

Cursor · mcpServers

VS Code · servers

Windsurf · mcpServers

Zed · context_servers

Cline · mcpServers

Roo Code · mcpServers

Continue · mcpServers

LibreChat · mcpServers

Gemini CLI · mcpServers

Codex CLI · mcp_servers

Full setup guides: every client.

02 · Evidence

Security posture

What to check before giving this server access to your agent - from the registry, GitHub, and our own probes. We don't score safety; we show what's verifiable.

runs as local process (stdio) - runs on your machine with your user's permissions

license Apache-2.0 - declared in the repository

pypi package mcp-clipboard - check the name against the project README before installing (PyPI has no namespace ownership)

registry namespace io.github.cmeans is GitHub-verified and matches the repo owner

03 · What Clipboard can do

Prose above is summarized from the project's README and registry record - no invented capabilities.

What you can build

With this server connected, an agent can write text content to the system clipboard. Accepts an optional mime_type parameter (text/plain by default, write a PNG or JPEG image to the system clipboard from base64-encoded bytes. Pass-through with no re-encoding, list what MIME types are currently on the clipboard. Accepts selection="primary" for the X11/Wayland PRIMARY selection, and read raw clipboard content for a given MIME type (diagnostic). Any non-binary type passes through.

The 7 tools it gives your agent

Extracted from the project's README - what Clipboard lets an agent do.

clipboard_paste
- Primary tool. Read any clipboard content: tables, text, code, JSON, URLs, images. Tables are formatted as Markdown/JSON/CSV; pass include_schema=true to append
clipboard_copy
- Write text content to the system clipboard. Accepts an optional mime_type parameter (text/plain by default; also text/html, text/rtf, image/svg+xml, or any text
clipboard_copy_markdown
- Render markdown to HTML and place both formats on the clipboard so paste targets pick the right one - Slack/Gmail/Notion/Discord get rich text; vim/terminal get
clipboard_copy_image
- Write a PNG or JPEG image to the system clipboard from base64-encoded bytes. Pass-through with no re-encoding; magic bytes are validated against the declared MI
clipboard_list_formats
- List what MIME types are currently on the clipboard. Accepts selection="primary" for the X11/Wayland PRIMARY selection.
clipboard_read_raw
- Return raw clipboard content for a given MIME type (diagnostic). Any non-binary type passes through; only image/, audio/, video/, and application/octet-stream a
clipboard_version
- Return the running mcp-clipboard package version as {"name": "mcp-clipboard", "version": ""}. Diagnostic. Useful for hosts that don't surface the standard MCP s

Limitations (from the README)

Audio and video are not supported. If the clipboard contains audio or video, the server reports the format but cannot return the content. Image write supports PNG and JPEG only via clipboard_copy_image. Pass-through, no re-encoding. Other binary formats (GIF, WebP, TIFF, BMP) are not yet writable. SVG rides the typed-text path via clipboard_copy(mime_type="image/svg+xml") since SVG is XML. Writing multiple MIME types

Latest releases

v2.6.1 · 2026-05-08

Fixed · SVG clipboard round-trip on Windows and macOS: copying an SVG via · clipboard_copy(mime_type="image/svg+xml") and then pasting it back · no longer returns "Clipboard is empty." Three layered gaps closed: · (1)…

v2.6.0 · 2026-05-07

Fixed · non-ASCII characters (em dash, en dash, curly quotes, · non-Latin scripts, etc.) are no longer corrupted on · clipboard_copy / clipboard_copy_markdown. Root cause was that · PowerShell's…

v2.5.1 · 2026-05-06

Fixed · Add mcp-name: io.github.cmeans/mcp-clipboard HTML comment to · README.md for MCP-registry ownership validation. The v2.5.0 · publish-registry job (the first-ever firing of the registry- · publish workflow added…

04 · Who maintains Clipboard

Clipboard is maintained by cmeans. We track 2 MCP servers from cmeans - 2 actively maintained, 11 combined GitHub stars, oldest repo from Feb 2026. Full record: all servers from cmeans.

  1. Synology NAS MCP server for Synology NAS - browse files, monitor health, and automate operations ★ 6

05 · Facts

category
media - ranked #93 of 155 actively-maintained media servers as of 2026-08-25.
registry
io.github.cmeans/mcp-clipboard (active, first published 2026-05-06 · 3 versions)
packages
pypi:mcp-clipboard

06 · Clipboard FAQ

Is Clipboard still maintained?

Yes - as of 2026-08-25, its last commit was 2026-07-20. We re-verify nightly.

What can Clipboard do?

With this server connected, an agent can write text content to the system clipboard. Accepts an optional mime_type parameter (text/plain by default, write a PNG or JPEG image to the system clipboard from base64-encoded bytes. Pass-through with no re-encoding, list what MIME types are currently on the clipboard. Accepts selection="primary" for the X11/Wayland PRIMARY selection, and read raw clipboard content for a given MIME type (diagnostic). Any non-binary type passes through.

How do I install Clipboard?

Run `uvx mcp-clipboard`. You can also paste the ready-made client config above.

Does Clipboard run locally?

Yes - it's a stdio server: it runs on your machine (via uvx) with your user's permissions. Your data stays local unless the server itself calls external APIs.

07 · Alternatives to Clipboard