macos-mcp-server

About macos-mcp-server

Use macos-mcp-server with your agent

claude mcp add macos-mcp-server -- npx -y @cyanheads/macos-mcp-server

{
  "mcpServers": {
    "macos-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@cyanheads/macos-mcp-server"
      ]
    }
  }
}

Frequently asked questions

What is macos-mcp-server?

macos-mcp-server is an MCP (Model Context Protocol) server by cyanheads. Control macOS system settings, apps, windows, audio, displays, screenshots, and Focus mode via MCP.

How do I connect macos-mcp-server to Claude, Cursor, or another MCP client?

Install macos-mcp-server from its npm package (@cyanheads/macos-mcp-server) and register it under "mcpServers" in your client's MCP configuration — for example claude_desktop_config.json or Cursor's mcp.json — then restart the client.

Is macos-mcp-server open source?

Yes — the source code is public at github.com/cyanheads/macos-mcp-server, with 1 GitHub stars.

Can AI agents pay to use macos-mcp-server?

Not yet through Loomal — macos-mcp-server is listed as a free directory entry. If its maintainer verifies ownership, they can set per-call USDC pricing that agents pay over x402, with settlement on Base.