Skip to content
MCP server

Clipboard MCP Server

Read, write, and inspect the system clipboard on macOS, Linux (X11/Wayland), and Windows…

Install
Pricing
Open source
Runs
Locally or Remotely
Version
0.3.0
Listing updated
4 days ago

About Clipboard MCP Server

Clipboard MCP Server is an open-source MCP server. It can run locally on your machine or as a hosted remote server.

Read, write, and inspect the system clipboard on macOS, Linux (X11/Wayland), and Windows via MCP.

Install

Run in a terminal

claude mcp add clipboard-mcp-server -- npx -y @cyanheads/clipboard-mcp-server

Add to claude_desktop_config.json

{
  "mcpServers": {
    "clipboard-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@cyanheads/clipboard-mcp-server"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "clipboard-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@cyanheads/clipboard-mcp-server"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "clipboard-mcp-server": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@cyanheads/clipboard-mcp-server"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "clipboard-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@cyanheads/clipboard-mcp-server"
      ]
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "clipboard-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@cyanheads/clipboard-mcp-server"
      ]
    }
  }
}

Configuration

  • MCP_LOG_LEVELSets the minimum log level for output (e.g., 'debug', 'info', 'warn').
  • CLIPBOARD_READ_ONLYServe 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_TYPESelects the HTTP transport.
  • MCP_HTTP_HOSTThe hostname for the HTTP server.
  • MCP_HTTP_PORTThe port to run the HTTP server on.
  • MCP_HTTP_ENDPOINT_PATHThe endpoint path for the MCP server.
  • MCP_AUTH_MODEAuthentication mode to use: 'none', 'jwt', or 'oauth'.
  • MCP_LOG_LEVELSets the minimum log level for output (e.g., 'debug', 'info', 'warn').
  • MCP_HTTP_MAX_BODY_BYTESMaximum 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_MODEHTTP session mode: 'auto', 'stateful', or 'stateless'. 'auto' resolves to 'stateful'. This server defaults to 'stateless'.
  • CLIPBOARD_READ_ONLYServe the clipboard read-only. When true, clipboard_write is absent from the manifest and tools/list and uncallable, but shown as disabled on the landing page and startup log. Accepts true/false/1/0/yes/no/on/off.

Pricing

Open source

Clipboard MCP Server FAQ

Is Clipboard MCP Server free?

Yes. Clipboard MCP Server is open source, so you can use and self-host it for free.

How do I add Clipboard MCP Server to Claude Code?

Run this command in your terminal: claude mcp add clipboard-mcp-server -- npx -y @cyanheads/clipboard-mcp-server