MacOS Clipboard MCP Server

by newbeb

Integrations

  • Provides access to the macOS clipboard via OSAScript, allowing retrieval of clipboard content including text, images, and binary data

MacOS Clipboard MCP Server

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

You must be authenticated.

A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

local-only server

The server can only run on the client's local machine because it depends on local resources.

Provides AI assistants access to the macOS clipboard content, supporting text, images, and binary data via OSAScript.

  1. Features
    1. Installation
      1. Usage
        1. Implementation Notes
          1. Requirements

            Related MCP Servers

            • -
              security
              A
              license
              -
              quality
              Allows the AI to read from your local Apple Notes database (macOS only)
              Last updated -
              56
              Python
              MIT License
              • Apple
            • A
              security
              A
              license
              A
              quality
              Provides screenshot and OCR capabilities for macOS.
              Last updated -
              1
              35
              10
              JavaScript
              MIT License
              • Apple
            • -
              security
              A
              license
              -
              quality
              Provides code manipulation, execution, and version control capabilities. It allows AI assistants to read, write, and execute code while maintaining a history of changes.
              Last updated -
              8
              Python
              MIT License
            • -
              security
              F
              license
              -
              quality
              Enables AI tools to capture and process screenshots of a user's screen, allowing AI assistants to see and analyze what the user is looking at through a simple MCP interface.
              Last updated -
              1
              Python
              • Linux
              • Apple

            View all related MCP servers

            ID: t0r959dh66