An MCP server that provides access to the macOS clipboard via OSAScript. This tool allows AI assistants to see what content is on the user's clipboard, including text, images, and binary data.
Features
- Retrieve content from the macOS clipboard
- Supports multiple content types:
- Text
- Images (PNG)
- Raw binary data
Installation
bun install
Usage
To start the server:
bun run start
For development with hot reloading:
bun run dev
Alternative development modes:
bun run dev2 # Run with fastmcp dev
bun run inspect # Run with fastmcp inspector
bun run mcp-cli # Run with mcp-cli tool
Implementation Notes
- Uses AppleScript via the
osascript command to interact with the macOS clipboard
- Handles various clipboard content types
- Content is returned with appropriate MIME types
- The clipboard should always be checked on demand (not cached) as content can change between requests
Requirements
- macOS operating system
- Bun runtime