Glama
Sign In

MacOS Clipboard MCP Server

by newbeb
GitHub
TypeScript
MIT License
2
  • Apple
RedditDiscord
OverviewInspectSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

local-only server

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

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

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 Resources