mcp-wayland-clipboard

MCP server to write to the Wayland clipboard via `wl-copy`.

This Model Context Protocol (MCP) server allows AI models to copy text directly to your Wayland clipboard using the `wl-copy` command-line tool.

Prerequisites

• Node.js (v18 or higher)
• `wl-copy` installed and available in PATH (usually provided by the `wl-clipboard` package)

Installing wl-clipboard

On Arch Linux:

sudo pacman -S wl-clipboard

On Ubuntu/Debian:

sudo apt install wl-clipboard

Installation

npm install

Building

npm run build

This compiles the TypeScript source to JavaScript in the `dist/` directory.

Usage

Starting the server

After building, you can start the server using:

npx mcp-wayland-clipboard

Or directly with Node:

node dist/index.js

Tool: `copy_to_clipboard`

The server provides a single tool called `copy_to_clipboard` that accepts a `text` parameter and copies it to your Wayland clipboard.

Parameters:

• `text` (string, required): The text to copy to the clipboard

Returns:

• Success: `{ success: true, message: "Text copied to clipboard" }`
• Error: `{ success: false, error: "error message" }`

Example Use Case

A common use case is asking an AI to generate formulas or code snippets and have them automatically copied to your clipboard. For example:

> "Generate an Excel formula to sum cells A1 to A5 and copy it to my clipboard"

The AI can then call the `copy_to_clipboard` tool with the formula, and you can paste it directly into Excel.

Configuration for MCP Clients

Claude Desktop

Add the following to your Claude Desktop configuration file (typically located at `~/Library/Application Support/Claude/claude_desktop_config.json` on macOS or `~/.config/Claude/claude_desktop_config.json` on Linux):

{
  "mcpServers": {
    "wayland-clipboard": {
      "command": "npx",
      "args": ["-y", "mcp-wayland-clipboard"]
    }
  }
}

Or if you have the project installed locally:

{
  "mcpServers": {
    "wayland-clipboard": {
      "command": "node",
      "args": ["/path/to/mcp-wayland-clipboard/dist/index.js"]
    }
  }
}

Other MCP Clients

For other MCP clients, configure them to start the server using:

• Command: `npx` (or `node` if using local installation)
• Args: `["-y", "mcp-wayland-clipboard"]` (or `["/path/to/dist/index.js"]` for local)

Error Handling

The server will exit with an error code if `wl-copy` is not found in your PATH during startup. Make sure `wl-clipboard` is installed before running the server.

License

MIT