jeomon avatar

macOS-MCP

jeomon/macos-mcp

Gives Claude, GPT, or any MCP client direct control over macOS through the Accessibility API. You get tools for clicking coordinates, typing text, launching apps, managing windows, executing AppleScript, and capturing UI state without needing vision models. Works on macOS 12 and up. The server exposes keyboard shortcuts, mouse operations, scrolling, and can extract interactive elements from the accessibility tree. Runs over stdio for desktop clients or SSE/HTTP for network access. Includes a Pi Agent package that wraps the core tools. Requires Accessibility and Screen Recording permissions. Useful when you want an LLM to drive macOS UI directly instead of building custom automation scripts.

GitHub stars
69
tools
10
transport
STDIO
last updated
May 22, 2026

Tools

10 tools

Public tool metadata for what this MCP can expose to an agent.

ClickClick at coordinates with support for left, right, and double-click

Click at coordinates with support for left, right, and double-click

No parameter schema in public metadata yet.

TypeType text at cursor position, optionally clearing existing text

Type text at cursor position, optionally clearing existing text

No parameter schema in public metadata yet.

ScrollScroll vertically or horizontally in focused window or regions

Scroll vertically or horizontally in focused window or regions

No parameter schema in public metadata yet.

MoveMove mouse pointer or drag to coordinates

Move mouse pointer or drag to coordinates

No parameter schema in public metadata yet.

ShortcutPress keyboard shortcuts (Cmd+C, Cmd+Tab, etc.)

Press keyboard shortcuts (Cmd+C, Cmd+Tab, etc.)

No parameter schema in public metadata yet.

AppLaunch applications, manage windows (resize/move), switch between apps. Supports app names and bundle IDs

Launch applications, manage windows (resize/move), switch between apps. Supports app names and bundle IDs

No parameter schema in public metadata yet.

DesktopCreate a new Mission Control Space (virtual desktop) via Accessibility, verifying the space count increased

Create a new Mission Control Space (virtual desktop) via Accessibility, verifying the space count increased

No parameter schema in public metadata yet.

ShellExecute commands or AppleScript. Use `mode='osascript'` for AppleScript

Execute commands or AppleScript. Use `mode='osascript'` for AppleScript

No parameter schema in public metadata yet.

ScrapeExtract and convert webpage content to Markdown format

Extract and convert webpage content to Markdown format

No parameter schema in public metadata yet.

WaitPause execution for a defined duration

Pause execution for a defined duration

No parameter schema in public metadata yet.

Sponsors

Readme

MCP Toplist

🍎 macOS-MCP

License Python Platform: macOS 12+ Last Commit

Overview

macOS-MCP is a lightweight, open-source Model Context Protocol server that bridges AI agents and the macOS operating system. It enables seamless automation of macOS through LLMs via tasks such as file navigation, application control, UI interaction, browser automation, and system operations.

Supported Operating Systems

  • macOS 12 (Monterey)
  • macOS 13 (Ventura)
  • macOS 14 (Sonoma)
  • macOS 15 (Sequoia)
  • macOS 26 (Tahoe)

Key Features


View the full README on GitHub

Details

Repository
github.com/jeomon/macos-mcp
Category
Automation & Workflows
Package
macos-mcp
Transport
STDIO
Registry
MCP registry, active

Related Automation & Workflows MCP servers

View all
1kastalien-research avatarThoughtboxkastalien-research/thoughtboxExtended reasoning with structured processes, persistence, and workflow guidance60stars
2etairl avatarParallel Browser MCPetairl/parallel-browser-mcpMCP server for parallel browser automation across multiple providers.51stars
3promptexecution avatarJust MCP Serverpromptexecution/just-mcpExpose curated Justfile recipes via MCP for safe deterministic automation.50stars
4martingeidobler avatarAndroidmartingeidobler/android-mcp-serverControl Android devices and emulators via ADB — screenshots, UI automation, and logcat.46stars
5webdriverio avatarMcpwebdriverio/mcpMCP server with WebdriverIO for browser and mobile app automation (iOS/Android via Appium)0stars
6mybolide avatarMcp Probe Kitmybolide/mcp-probe-kitSpec-driven dev workflow MCP: start_* orchestration, memory, GitNexus, quality gates.41stars