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
