AI Plugin Index
macos-mcp-server
CommunityMCP server by cyanheads · updated · ★ 3 · 108 downloads a week
Control macOS system settings, apps, windows, audio, displays, screenshots, and Focus mode via MCP. macos-mcp-server is a community project by cyanheads, not verified by a company domain.
Last commit 14 days ago
Apache-2.0: permissive, fine for commercial use
Clear description, published package or server URL, original repository
No risky patterns in the files we checked
What you need
| Setting | Needed | What it is |
|---|---|---|
MACOS_Environment variable | Optional | Default directory for screenshot files. Defaults to ~/Desktop when empty. |
MACOS_Environment variable | Optional | JSON object mapping layout names to displayplacer argument strings for apply_layout. Default: {} |
MCP_Environment variable | Optional | Minimum log level for output: debug, info, notice, warning, error. Default: info |
From the publisher's entry in the official MCP Registry. Required settings are already in the install config below as placeholders.
Install macos-mcp-server
Built from the published package, never by AIclaude mcp add macos-mcp-server -- npx -y @cyanheads/macos-mcp-serverRun in your terminal. Add --scope user to use it in every project.
{
"mcpServers": {
"macos-mcp-server": {
"command": "npx",
"args": [
"-y",
"@cyanheads/macos-mcp-server"
]
}
}
}Settings, Developer, Edit config. Paste into claude_desktop_config.json and restart.
{
"mcpServers": {
"macos-mcp-server": {
"command": "npx",
"args": [
"-y",
"@cyanheads/macos-mcp-server"
]
}
}
}Add to ~/.cursor/mcp.json (all projects) or .cursor/mcp.json (this project).
{
"servers": {
"macos-mcp-server": {
"command": "npx",
"args": [
"-y",
"@cyanheads/macos-mcp-server"
]
}
}
}Add to .vscode/mcp.json. VS Code uses "servers", not "mcpServers".
codex mcp add macos-mcp-server -- npx -y @cyanheads/macos-mcp-server{
"mcpServers": {
"macos-mcp-server": {
"command": "npx",
"args": [
"-y",
"@cyanheads/macos-mcp-server"
]
}
}
}Add to ~/.gemini/config/mcp_config.json (all projects) or .agents/mcp_config.json (this project).
gemini mcp add macos-mcp-server npx -y @cyanheads/macos-mcp-serverGemini CLI was replaced by Antigravity CLI in June 2026 and remains only for enterprise licences and paid API keys.
MCP servers run with your permissions and can read what you give them access to. Some need an API key: check the README and add it under env in the macos-mcp-server block.
Weekly newsletter
Like macos-mcp-server? Get the best new MCP servers every week
The best new tools, security warnings before you install something risky, and one practical tip. Free, three minute read.
Security check
ANo download-and-run commands, hidden instructions or signs of sending keys out were found.
Checked automatically: README.md, package.json. This looks for known risky patterns and is not a full audit. How grades work
Alternatives to macos-mcp-server
All alternatives →
Natural voice conversations for AI assistants - STT/TTS via MCP
Transcribe local audio with FunASR and SenseVoice using private, on-device inference.
Identify and remove AI watermarks and provenance metadata from your own images and video.
MCP App Server demonstrating video resources served as base64 blobs
MCP App Server for rendering and playing sheet music from ABC notation
Trim, convert, resize, compress, and remix audio and video.
macos-mcp-server: common questions
How do I install macos-mcp-server?
In Claude Code run claude mcp add macos-mcp-server -- npx -y @cyanheads/macos-mcp-server. For Claude Desktop, Cursor and VS Code, paste the config shown above and restart. See the install guides.
Is macos-mcp-server the official server?
macos-mcp-server is a community project by cyanheads, not verified by a company domain.
Is macos-mcp-server free?
The code is published under the Apache-2.0 licence. The service it connects to may have its own pricing.
Is macos-mcp-server safe to use?
It scores 74 of 100. Grades: maintenance A, licence A, quality C. Security check: grade A, no risky patterns found in the files checked. Review the code before you install. How grades work.
What are alternatives to macos-mcp-server?
Similar MCP servers: voicemode, FunASR, Remove AI Watermarks, Server Video Resource.
Does macos-mcp-server work with ChatGPT?
Not directly. It runs locally, and ChatGPT only connects to remote servers with a URL. Use it in Claude Code, Claude Desktop, Cursor, VS Code or Codex.