io.github.cyanheads/macos-mcp-server
Control macOS system settings, apps, windows, audio, displays, screenshots, and Focus mode via MCP.
MCP server · by cyanheads
About
io.github.cyanheads/macos-mcp-server is an MCP server published by cyanheads. Marketplaces we read that list it: 1 (Official MCP Registry). We first saw it on 2026-10-11 and have recorded no change since. As of our marketplace pass on 2026-10-13.
What it asks for
- Runs on your machine
- Settings: 8
What it declares, asks for and runs, in full
Only install plugins from developers you trust. We list what marketplaces publish and do not test plugins.
Package
npm @cyanheads/macos-mcp-server (@cyanheads/macos-mcp-server on npm)
- npm downloads/week: 316 (2026-10-12)
- npm downloads/month: 1 113 (2026-10-12)
- Latest version on npm: 0.2.1, published 2026-10-09
- Declared version 0.2.1 is not listed on npm
npm facts come from the public npm registry (registry.npmjs.org, api.npmjs.org). Each figure is the registry's own and is never added to another. A registry that publishes no figure shows none: no number is not zero.
Works with
- Claude Code
- Codex
- Cursor
- VS Code
- Copilot CLI
A one-click link opens the client, which asks you to confirm before it adds the server.
From the marketplaces that list it and the MCP transport it declares, as each client documents them. We do not test plugins.
Connect
Commands and configs built only from what its marketplaces declare. We do not run them for you and do not test plugins.
As a local MCP server: npm package
Built from what Official MCP Registry declares.
claude mcp add --transport stdio macos-mcp-server -- npx -y @cyanheads/macos-mcp-server[mcp_servers.macos-mcp-server]
command = "npx"
args = ["-y", "@cyanheads/macos-mcp-server"]{
"mcpServers": {
"macos-mcp-server": {
"command": "npx",
"args": [
"-y",
"@cyanheads/macos-mcp-server"
]
}
}
}Optional settings it also lists: MACOS_DISPLAY_LAYOUTS, MACOS_SCREENSHOT_DIR, MCP_AUTH_MODE, MCP_HTTP_ENDPOINT_PATH, MCP_HTTP_HOST, MCP_HTTP_PORT, MCP_LOG_LEVEL, MCP_TRANSPORT_TYPE.
Where it is published
| Marketplace | Status | Version | Figures | Verified | First seen |
|---|---|---|---|---|---|
| Official MCP Registry (Open the registry record) | Listed | 0.2.1 | Downloads/month (npm): 1 113 Downloads/week (npm): 316 Forks (GitHub): 0 Stars (GitHub): 3 |
Not marked |
Each figure is the marketplace's own and is never added up across marketplaces. A marketplace that publishes no figure shows none: no number is not zero.
What changed
Nothing has moved on this plugin since we started watching it.
Similar plugins
Products whose own names, descriptions, tools and skills are closest in meaning to this one, on every marketplace we read. Closeness is ranked within this list only.
-
MCP server for macOS desktop automation via the Accessibility API.
-
macuse io.github.macuse-app/macuse
MCP server for Mac — control Calendar, Mail, Notes, Reminders, and any Mac app, fully on-device.
-
Local macOS 27 desktop automation through MCP on Apple silicon.
-
mcp-osascript io.github.m0rvayne/mcp-osascript
macOS automation: 17 typed tools for windows, menus, keyboard, clipboard, tabs, screenshots
-
airmcp io.github.heznpc/airmcp
Governed MCP runtime for the Apple ecosystem, available on macOS with per-call approval.
-
Read and manage macOS system settings and perform scoped desktop actions.
-
hammerspoon io.github.mobabur94/hammerspoon
macOS automation via Hammerspoon — 75 tools for windows, Spaces, audio, Bluetooth, and more
-
mcp-mac-control io.github.dockndevai/mcp-mac-control
Full macOS control — drive a Mac like a human: shell, AppleScript, files, and human-like GUI.
-
Control macOS apps via AppleScript/JXA: sanitized commands for Messages, Mail, Finder, and more.
-
mac-use-mcp io.github.antbotlab/mac-use-mcp
Zero-dependency macOS desktop automation for AI agents. 18 tools via MCP. macOS 13+.
Similar plugins by marketplace
The same question asked of one marketplace at a time: is there an analog of this plugin there?
Has a listing on Claude Code: claude-plugins-community (5)
-
MCP server for terminal commands, file operations, and process management
-
Mac & Windows: let ChatGPT, Claude & Cursor use your email, calendar, iMessage, Teams, files.
-
Reconnect MCP servers in Claude Code tmux sessions via automated key injection. No API required — works by driving the /mcp interactive menu through tmux send-keys.
-
Convert MCP servers to token-efficient CLI tools with auto-generated SKILL.md files for Claude Code agents
-
Skills for creating MCP Apps with the MCP Apps SDK
Has a listing on Claude Code: claude-plugins-official (5)
-
MCP server for terminal commands, file operations, and process management
-
Skills for creating MCP Apps with the MCP Apps SDK
-
mdk-mcp-server io.github.SAP/mdk-mcp-server
Model Context Protocol (MCP) server for AI-assisted development of MDK applications.
-
mcp-server io.github.cap-js/mcp-server
Model Context Protocol (MCP) server for AI-assisted development of CAP applications.
-
Figma design platform integration. Access design files, extract component information, read design tokens, and translate designs into code. Bridge the gap between design and…
Has a listing on Claude: knowledge-work-plugins (5)
-
MCP server for terminal commands, file operations, and process management
-
Figma design platform integration. Access design files, extract component information, read design tokens, and translate designs into code. Bridge the gap between design and…
-
Hosted MCP server for AI-assisted Grafana Cloud observability — no local installation required.
-
Create, customize, and manage plugins tailored to your organization's tools and workflows. Configure MCP servers, adjust plugin behavior, and adapt templates to match how your…
-
Sanity content platform integration with MCP server, agent skills, and slash commands. Query and author content, build and optimize GROQ queries, design schemas, and set up Visual…
Has a listing on Codex: openai-curated (openai/plugins) (5)
-
Build, run, test, debug, instrument, and implement local macOS apps using Xcode, SwiftUI, AppKit interop, unified logging, and shell-first desktop workflows.
-
Build iOS apps with workflows for App Intents, SwiftUI UI work, Simulator mirroring in the Codex in-app browser, performance profiling, leak investigation, and simulator debugging.
-
Test Android apps with emulator workflows for reproduction, screenshots, UI inspection, log capture, and performance profiling.
-
Install, open, and connect the signed ChatCut Desktop app from Codex.
-
Cloudflare platform plugin with curated skills for Workers, Wrangler, and Agents SDK plus the official Cloudflare API MCP server.
Has a listing on Community GitHub marketplaces (5)
-
Let any AI agent operate desktop apps on macOS, Windows and Linux, in the background and safely.
-
MCP server for terminal commands, file operations, and process management
-
Real iOS interaction clips, motion breakdowns, SwiftUI to match. Paid licence required.
-
macOS-only MCP server that exposes iMessage chat
macOS-only MCP server that exposes iMessage chat.db to Claude and exports per-chat history to an…
-
touchdesigner-mcp-server io.github.8beeeaaat/touchdesigner-mcp-server
MCP server for TouchDesigner - Control and operate TouchDesigner projects through AI agents
Has a listing on Copilot CLI: github/awesome-copilot (5)
-
Complete toolkit for building Model Context Protocol (MCP) servers in Kotlin using the official io.modelcontextprotocol:kotlin-sdk library. Includes instructions for best…
-
Complete toolkit for building Model Context Protocol (MCP) servers in Go using the official github.com/modelcontextprotocol/go-sdk. Includes instructions for best practices, a…
-
Figma design platform integration. Access design files, extract component information, read design tokens, and translate designs into code. Bridge the gap between design and…
-
Helps coding agents write and review Apple Foundation Models code for iOS, macOS, visionOS, and watchOS using the SDK installed on the developer's Mac. It verifies real API…
-
Complete toolkit for building Model Context Protocol (MCP) servers in TypeScript/Node.js using the official SDK. Includes instructions for best practices, a prompt for generating…
Has a listing on Copilot CLI: github/copilot-plugins (5)
-
mcp-apps
Generate MCP App widgets for MCP tools. Produces self-contained HTML widgets using the MCP Apps protocol.
-
Build Power Apps Canvas Apps using the Canvas Authoring MCP server.
-
Toolkit for building Microsoft 365 Copilot declarative agents — scaffolding, JSON manifest development, and capability configuration.
-
model-apps
Build and deploy Power Apps generative pages for model-driven apps with specialist agents for planning, entity creation, and parallel code generation. Requires PAC CLI >= 2.7.0…
-
mobile-app
Build and deploy Power Apps code apps for mobile using Expo (React Native), with native device functionality and Power Platform connectors
Has a listing on Cursor: cursor/plugins (5)
-
Build apps, scripts, and automations with the TypeScript SDK.
-
playwright-mcp io.github.microsoft/playwright-mcp
Playwright Tools for MCP
-
Fan large tasks out across parallel cloud agents with planners, workers, verifiers, and structured handoffs.
-
Skills for building on the Cursor Origin API. Fetch the live spec first, then follow the Origin rules for credentials, scopes, webhooks, paging, and errors. Includes a skill that…
-
CLI-backed repo compatibility scans plus agents that audit startup, validation, and docs against reality.
Has a listing on Docker MCP Catalog (5)
-
MCP server for terminal commands, file operations, and process management
-
A unified MCP proxy that aggregates multiple MCP servers into one interface, enabling seamless tool discovery and management across all your AI interactions. Manage all your MCP…
-
VeyraX MCP is the only connection you need to access all your tools in any MCP-compatible environment.
-
Access to Rube's catalog of remote MCP servers.
-
Dynatrace-mcp io.github.dynatrace-oss/Dynatrace-mcp
[DEPRECATED] Dynatrace MCP Server. Migrate to dynatrace-for-ai or Dynatrace Remote MCP Server.
Has a listing on Official MCP Registry (5)
-
MCP server for macOS desktop automation via the Accessibility API.
-
macuse io.github.macuse-app/macuse
MCP server for Mac — control Calendar, Mail, Notes, Reminders, and any Mac app, fully on-device.
-
Local macOS 27 desktop automation through MCP on Apple silicon.
-
mcp-osascript io.github.m0rvayne/mcp-osascript
macOS automation: 17 typed tools for windows, menus, keyboard, clipboard, tabs, screenshots
-
airmcp io.github.heznpc/airmcp
Governed MCP runtime for the Apple ecosystem, available on macOS with per-call approval.
Found by meaning, not by shared code or a shared repository: similar plugins stay separate products, and this is not a review or a recommendation.
Is this your plugin?
Add it to your projects and prove you maintain it with a file in its repository, a file on your domain or a DNS record. You get alerts when a marketplace lists it, drops it, changes its verified mark or what it asks for, and its remote endpoint goes on monitoring as a web service.
Data comes from the Official MCP Registry (registry.modelcontextprotocol.io), CC0 1.0. Figures come from our own regular passes over the marketplaces, last read on . We publish no contact details for plugin publishers.