Clipboard MCP

An MCP server that provides tools for reading and writing system clipboard data. Works on Linux, macOS, Windows, and WSL.

Installation

The easiest way to use this server is with uvx:

uvx clipboard-mcp

Or install it globally:

uv tool install clipboard-mcp

Configuration

Claude Desktop

Add the following to your Claude Desktop configuration file:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

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

Claude Code

Add the following to your Claude Code settings:

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

Available tools

read_clipboard

Read the current text content from the system clipboard.

write_clipboard

Write text content to the system clipboard.

Parameter	Type	Description
text	string	The text content to write to the clipboard

Platform support

This server uses pyperclip for clipboard access, which requires different backends depending on your platform:

• macOS: Uses pbcopy/pbpaste (built-in)
• Windows: Uses native Windows clipboard APIs (built-in)
• Linux/WSL: Requires xclip or xsel to be installed

On Linux, install the required dependency:

# Debian/Ubuntu
sudo apt install xclip

# Fedora
sudo dnf install xclip

# Arch Linux
sudo pacman -S xclip

License

Distributed under the AGPL-3.0.