alexlock1/macos-system

MCP Server

macOS System MCP Server - file dialogs, clipboard, notifications

macOS system integration MCP server. File dialogs, clipboard, notifications, screenshots, Finder, PDF, Notes, and image processing.

MCP Server

  • Package: macos-mcp (GitHub only — not on npm)
  • Transport: stdio
  • Command: git clone + npm install + npm run build

Authentication

None (macOS system permissions required)

VariableRequiredDescription
No environment variables required

Available Tools

ToolDescription
pick_fileFile picker dialog
clipboard_readRead clipboard
clipboard_writeWrite clipboard
notifySystem notification
screenshotTake screenshot
reveal_in_finderShow in Finder
note_createCreate Apple Note
image_resizeResize image
pdf_mergeMerge PDFs

Configuration Example

toml
[[mcp.servers]]
name = "macos-system"
type = "stdio"
command = "npx"
args = ["-y", "macos-mcp (GitHub only — not on npm)"]
timeout_seconds = 60
tools = []

Notes: macOS only. Not on npm — requires git clone. Uses AppleScript.