clipboard-mcp

# Clipboard MCP Server A Model Context Protocol (MCP) server that provides system clipboard read and write capabilities for AI assistants like Claude. ## ⚠️ Important: Install System Dependencies First **Linux users must install clipboard utilities before using this package:** ```bash # For X11 (most common) sudo apt install xclip xsel # For Wayland sudo apt install wl-clipboard # Other distributions sudo dnf install xclip xsel # Fedora/RHEL sudo pacman -S xclip xsel # Arch Linux ``` **WSL users:** Usually works out of the box using Windows clipboard tools. If you encounter issues, install `xclip xsel` as above. **macOS and Windows users:** No additional dependencies needed! ## Features - **read_clipboard**: Read text content from the system clipboard - **write_clipboard**: Write text content to the system clipboard - Cross-platform support (Linux, macOS, Windows, WSL) - Lightweight with minimal dependencies ## Installation ### Option 1: pip (Recommended) ```bash pip install clipboard-mcp ``` *Consider using a virtual environment to avoid dependency conflicts:* ```bash python -m venv venv source venv/bin/activate # On Windows: venv\Scripts\activate pip install clipboard-mcp ``` ### Option 2: uv (Lightweight, for trying it out) Run directly with uv (no pip installation required): ```bash # One-time execution uv run --from clipboard-mcp clipboard-mcp # Or clone and run from source git clone https://github.com/gabiteodoru/clipboard-mcp.git cd clipboard-mcp uv run clipboard-mcp ``` ### Option 3: From Source ```bash git clone https://github.com/gabiteodoru/clipboard-mcp.git cd clipboard-mcp pip install -e . ``` ## Usage ### With Claude CLI After pip installation: ```bash claude mcp add --scope user clipboard-mcp clipboard-mcp ``` With uv (no installation): ```bash claude mcp add --scope user clipboard-mcp "uv run --from clipboard-mcp clipboard-mcp" ``` Or from source directory: ```bash claude mcp add --scope user clipboard-mcp "uv …