macos-clipboard-mcp
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@macos-clipboard-mcp Paste the current clipboard content."
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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
method1(recommended)
{
"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.pyRequirements
Python 3.12+
macOS (uses AppleScript for clipboard operations)
Usage
Start the MCP server:
mcp dev main.pyThis exposes the following MCP tools:
copy_to_clipboard(data: str): Copies text to the clipboardpaste_from_clipboard(): Returns text from the clipboardpaste_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 toolscopy_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
Scored across 3 tools
Each tool targets a distinct clipboard operation: copying data, pasting text, and pasting images. No ambiguity between them.
All tool names follow a consistent verb_noun pattern in snake_case: copy_to_clipboard, paste_from_clipboard, paste_image_from_clipboard.
Three tools are appropriate for a clipboard utility, covering the essential operations without bloat.
The tool set covers the fundamental clipboard actions: copy, paste text, and paste image. No obvious gaps for typical usage.
Maintenance
Related MCP Connectors
MCP connector that lets ChatGPT list, search, and run your Apple Shortcuts via a local Mac agent
Connect ChatGPT and Claude to your Mac, Windows or Linux with secure MCP remote access.
Search, read, and write your Apple Notes from ChatGPT/Claude via a local Mac agent + MCP relay.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceProvides AI assistants access to the macOS clipboard content, supporting text, images, and binary data via OSAScript.8MIT
- AlicenseAqualityBmaintenanceMCP 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.760 PyPI4Apache 2.0
- AlicenseNot gradedqualityCmaintenanceMCP 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 npmMIT
- AlicenseAqualityDmaintenanceA local MCP server that exposes macOS automation actions (AppleScript + CLIs) as tools, enabling MCP clients on your Mac to control apps, system settings, and more.39MIT