Skip to main content
Glama
Sign In
Clipboard MCP

Clipboard MCP

by dahlia
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Local

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

Related MCP server: ClipToWSL MCP Server

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.

Available Tools

2 tools
read_clipboardA

Read the current text content from the system clipboard.

Returns the text currently stored in the clipboard. If the clipboard is empty or contains non-text data, an empty string is returned.

Inputs: no named parameters. Returns: result

write_clipboardA

Write text content to the system clipboard.

Copies the provided text to the system clipboard, making it available
for pasting in other applications.

Args:
    text: The text content to write to the clipboard.

Returns:
    A confirmation message indicating success.

Inputs: text (required). Returns: result

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Deploy Server
    Claude Code, inside the Godot 4 editorFlockbay puts an AI agent in the real Godot 4 editor: it writes GDScript, runs your game and fixes what breaks. Free, or bring your own Claude Code or Codex.flockbay.comAd

    TDQS

    A4.3/5.0

    Scored across 2 tools

    Disambiguation5/5

    The two tools have perfectly distinct purposes: one reads from the clipboard and the other writes to it. There is no overlap or ambiguity in their functions, making it impossible for an agent to confuse them.

    Naming Consistency5/5

    Both tools follow a consistent verb_noun pattern (read_clipboard, write_clipboard) with clear action-object naming. The snake_case style is uniform throughout, making the tools predictable and easy to understand.

    Tool Count3/5

    With only two tools, the server feels minimal but functional for basic clipboard operations. While it covers the essential read/write actions, it might be considered thin for a broader utility scope, though appropriate for its focused purpose.

    Completeness4/5

    The tools provide complete CRUD-like coverage for clipboard text operations (read and write), with no dead ends. A minor gap exists in handling non-text data or advanced features like clipboard history, but core functionality is well-covered.

    Maintenance

    ActivityInactive
    ResponsivenessOutdated data

    Resources

    Related MCP Connectors

    Related MCP Servers

    • ClipToWSL MCP Server

      CarlosGtrz
      A
      license
      Not graded
      quality
      D
      maintenance
      Enables AI coding agents like Claude to read Windows clipboard contents (text and images) from within WSL environments, providing seamless cross-platform clipboard access through the Model Context Protocol.
      5
      MIT

    • mcp-clipboardify

      fluffypony
      A
      license
      Not graded
      quality
      D
      maintenance
      Provides clipboard access tools (get and set) for AI assistants via the Model Context Protocol, enabling seamless clipboard operations across platforms.
      1
      MIT