Skip to main content
Glama
macos-clipboard-mcp

macos-clipboard-mcp

by xiaoquisme

MacOS Clipboard MCP

A simple utility that provides model context protocol (MCP) tools for interacting with the macOS clipboard.

Features

  • Copy text to the clipboard

  • Paste text from the clipboard

  • Paste images from the clipboard (supports TIFF, PNG, and JPEG formats)

Related MCP server: mcp-clipboard

mcp config

{
    "clipboard": {
        "command": "uvx",
        "args": [
            "macos-clipboard-mcp"
        ]
    }
}

method2

{
    "clipboard": {
            "command": "uv",
            "args": [
                "--directory",
                "<your-local-folder>/macos-clipboard-mcp",
                "run",
                "main.py"
            ]
        }
}

Installation

uv sync
python main.py

Requirements

  • Python 3.12+

  • macOS (uses AppleScript for clipboard operations)

Usage

Start the MCP server:

mcp dev main.py

This exposes the following MCP tools:

  • copy_to_clipboard(data: str): Copies text to the clipboard

  • paste_from_clipboard(): Returns text from the clipboard

  • paste_image_from_clipboard(): Returns images from the clipboard as base64-encoded PNG

Development

This project uses modern Python tooling:

  • uv for dependency management

License

MIT

Available Tools

3 tools
copy_to_clipboardC

copy data to clipboard

Inputs: data (required).

paste_from_clipboardD

paste from clipboard

Inputs: no named parameters.

paste_image_from_clipboardA

Paste image from clipboard, automatically detect TIFF/PNG/JPEG formats, and always return the image as a PNG base64-encoded string. Returns an empty string if there is no image in the clipboard.

Inputs: no named parameters.

Tool Schema Changelog

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

Loading tool schema changelog…

    TDQS

    B3/5.0

    Scored across 3 tools

    Disambiguation5/5

    Each tool targets a distinct clipboard operation: copying data, pasting text, and pasting images. No ambiguity between them.

    Naming Consistency5/5

    All tool names follow a consistent verb_noun pattern in snake_case: copy_to_clipboard, paste_from_clipboard, paste_image_from_clipboard.

    Tool Count5/5

    Three tools are appropriate for a clipboard utility, covering the essential operations without bloat.

    Completeness5/5

    The tool set covers the fundamental clipboard actions: copy, paste text, and paste image. No obvious gaps for typical usage.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      B
      maintenance
      MCP server that reads and writes the system clipboard — tables, text, code, JSON, URLs, images, and more. Preserves spreadsheet structure (rows/columns) that is lost when pasting into Claude directly.
      7
      60 PyPI
      4
      Apache 2.0
    • A
      license
      Not graded
      quality
      C
      maintenance
      MCP server that gives AI agents access to your Maus clipboard on macOS, enabling them to write clean text into history, search, and manage clipboard items locally.
      11 npm
      MIT