🍎 mcp-server-macos

Let your AI assistant use your Mac.
An MCP server for Claude, Cursor and any other MCP client, built on pymacos.

Add it in a minute, and your assistant stops explaining what to do on your Mac and starts doing it.

Get started

With uv installed, there's nothing to set up first.

In Claude Code:

claude mcp add macos -- uvx mcp-server-macos

In Cursor, one click:

In Claude Desktop and other clients configured with JSON:

{
  "mcpServers": {
    "macos": {
      "command": "uvx",
      "args": ["mcp-server-macos"]
    }
  }
}

No uv? pip install mcp-server-macos, then use mcp-server-macos as the command.

Requires macOS and Python 3.10 or newer.

Permissions

macOS gives privacy permissions to the app that runs the server (Claude Desktop, your terminal, your editor), not to the server itself.

When a tool needs a permission that's missing, it tells the assistant which one, instead of failing silently.

Contributing

Bug reports, ideas and pull requests are welcome. CONTRIBUTING.md explains the setup and how to add a tool, which takes one function and its tests. To report a vulnerability, see SECURITY.md.

If the project is useful to you, a star helps other people find it.

License

Released under the MIT License, free for personal and commercial use.

_{Not affiliated with or endorsed by Apple Inc. macOS is a trademark of Apple Inc.}