Clipboard MCP
=============

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

[MCP]: https://modelcontextprotocol.io/


Installation
------------

The easiest way to use this server is with [uvx]:

~~~~ bash
uvx clipboard-mcp
~~~~

Or install it globally:

~~~~ bash
uv tool install clipboard-mcp
~~~~

[uvx]: https://docs.astral.sh/uv/guides/tools/


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*

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

### Claude Code

Add the following to your Claude Code settings:

~~~~ json
{
  "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:

~~~~ bash
# Debian/Ubuntu
sudo apt install xclip

# Fedora
sudo dnf install xclip

# Arch Linux
sudo pacman -S xclip
~~~~

[pyperclip]: https://pypi.org/project/pyperclip/


License
-------

Distributed under the [AGPL-3.0].

[AGPL-3.0]: https://www.gnu.org/licenses/agpl-3.0.html