Clipboard Mcp Server

cyanheads/clipboard-mcp-server

Gives Claude direct access to your system clipboard across macOS, Linux (X11/Wayland), and Windows. Three tools: read content in text, HTML, RTF, or image formats with auto-detection of the richest available type, write text or HTML with automatic plain-text fallback, and inspect what formats are present before reading. Handles size limits (512 KB for text formats, 5 MB for images), returns base64-encoded PNGs with dimensions, and throws typed errors when a requested format isn't available. Built on the mcp-ts-core framework with declarative tool definitions. Reach for this when you need Claude to paste code snippets, grab screenshots, or exchange structured content with other desktop apps without manual copy-paste steps.

GitHub stars: 3
tools: 3
transport: STDIO, HTTP
env vars: 9
last updated: Oct 29, 2026

View on GitHub

Tools

3 tools

Public tool metadata for what this MCP can expose to an agent.

clipboard_readRead clipboard contents in a specified format (text, HTML, RTF, image, or auto-select richest)

Read clipboard contents in a specified format (text, HTML, RTF, image, or auto-select richest)

No parameter schema in public metadata yet.

clipboard_writeWrite plain text or HTML to the clipboard, replacing current contents, or clear it outright

Write plain text or HTML to the clipboard, replacing current contents, or clear it outright

No parameter schema in public metadata yet.

clipboard_inspectList available clipboard formats and byte sizes without reading full content

List available clipboard formats and byte sizes without reading full content

No parameter schema in public metadata yet.

Configuration

MCP_LOG_LEVELdefault: info

Sets the minimum log level for output (e.g., 'debug', 'info', 'warn').

CLIPBOARD_READ_ONLYdefault: false

Serve the clipboard read-only. When true, clipboard_write is not registered: it is absent from tools/list and uncallable, absent from the manifest but shown as disabled on the landing page and startup log. Accepts true/false/1/0/yes/no/on/off.

MCP_TRANSPORT_TYPEdefault: http

Selects the HTTP transport.

MCP_HTTP_HOSTdefault: 127.0.0.1

The hostname for the HTTP server.

MCP_HTTP_PORTdefault: 3010

The port to run the HTTP server on.

MCP_HTTP_ENDPOINT_PATHdefault: /mcp

The endpoint path for the MCP server.

MCP_AUTH_MODEdefault: none

Authentication mode to use: 'none', 'jwt', or 'oauth'.

MCP_HTTP_MAX_BODY_BYTESdefault: 7340032

Maximum inbound JSON-RPC request body in bytes. Defaults to 7 MiB so a full-size clipboard_write survives worst-case JSON escaping; 0 disables the guard.

MCP_SESSION_MODEdefault: stateless

HTTP session mode: 'auto', 'stateful', or 'stateless'. 'auto' resolves to 'stateful'. This server defaults to 'stateless'.