What tools does MacOS Clipboard MCP expose?
It exposes three MCP tools: `copy_to_clipboard(data: str)`, `paste_from_clipboard()` (returns text), and `paste_image_from_clipboard()` (returns the clipboard image as a base64‑encoded PNG string).
MacOS Clipboard MCP Server
@xiaoquisme
Basic information
About MacOS Clipboard MCP Server
A simple utility that provides model context protocol (MCP) tools for interacting with the macOS clipboard.
MacOS Clipboard MCP Server config
Add this server to your MCP-compatible client using the configuration below.
{
"mcpServers": {
"macos-cliboard-mcp": {
"command": "uv",
"args": [
"sync"
]
}
}
}MacOS Clipboard MCP Server tools
Tool list not available yet
This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.
We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.
Overview
What is MacOS Clipboard MCP?
MacOS Clipboard MCP is a Model Context Protocol server that exposes tools for reading and writing the macOS clipboard. It is built for developers who want to let AI assistants or MCP-compatible clients copy text to, paste text from, or retrieve images from the system clipboard on macOS.
How to use MacOS Clipboard MCP?
The recommended setup uses uvx with no local install: add an MCP client entry with command uvx and args ["macos-clipboard-mcp"]. Alternatively, clone the repo, run uv sync, and start the server with mcp dev main.py. The server exposes three tools: copy_to_clipboard, paste_from_clipboard, and paste_image_from_clipboard.
Key features of MacOS Clipboard MCP
- Copy arbitrary text strings to the clipboard
- Paste the current clipboard text as a string
- Paste clipboard images (TIFF, PNG, JPEG) as base64-encoded PNG
- Runs entirely on macOS using AppleScript
- Minimal setup with the
uvxone‑command approach
Use cases of MacOS Clipboard MCP
- An AI coding assistant copies generated code to the clipboard for immediate pasting
- A chatbot retrieves text the user previously copied to share with a language model
- An MCP‑enabled workflow extracts an image from the clipboard and processes it elsewhere
Frequently asked questions
What are the runtime requirements?
Python 3.12 or later and macOS are required. Clipboard operations are implemented via AppleScript, so the server will not function on other operating systems.
How is clipboard interaction implemented under the hood?
The server relies on macOS AppleScript to read from and write to the system clipboard. No external GUI or X11 dependency is needed.
Which image formats can the server handle when pasting an image?
The server supports TIFF, PNG, and JPEG image formats currently in the clipboard. The output is always a base64‑encoded PNG.
How do I configure MacOS Clipboard MCP in my MCP client?
The recommended method adds a `clipboard` entry with `"command": "uvx"` and `"args": ["macos-clipboard-mcp"]`. An alternative method uses `"command": "uv"` with local folder arguments pointing to a cloned copy of the repository.
More Other MCP servers
The Living Bread
The Living BreadA free remote MCP server for The Living Bread. Bible passages read word for word from a stored public domain text with an evidence label, keyword search and cross references, real churches, gatherings and prayer groups w
MCP Toolbox for Databases
googleapisMCP Toolbox for Databases is an open source MCP server for databases.
15.9K
P
PickFu MCP
PickFu MCP is a Model Context Protocol (MCP) server that connects AI assistants, developers, marketers, product managers, and AI agents to PickFu's consumer research platform. It enables users to create surveys, conduct
Handl
Handl speaks the Model Context Protocol. Your whole billing operation — projects, invoices, clients, reports, approvals — as tools any AI assistant can call, inside your autonomy rules.
Hindsight
vectorize-ioHindsight: Agent Memory That Learns
50.4K
Comments