Skip to content
MCP server

mcp-server-macos

Lets Claude, Cursor and other MCP clients control your Mac, built on pymacos

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
macOS, CLI
Runs
Locally
Version
1.3.3
Listing updated
today

Similar MCP servers

About mcp-server-macos

mcp-server-macos is an open-source MCP server for productivity. It runs locally on your machine and is started by your AI client.

Setup is a single command with uv installed: claude mcp add macos -- uvx mcp-server-macos, or an equivalent JSON block for Claude Desktop and a one-click link for Cursor. Without uv, pip install works too. It needs macOS and Python 3.10 or newer.

macOS grants privacy permissions to the app that launches the server, such as Claude Desktop, a terminal or an editor, not to the server itself. When a tool needs a permission that is missing, it tells the assistant which one rather than failing silently.

The project is MIT licensed and not affiliated with Apple. The README says adding a tool takes one function and its tests, which makes it easy to extend. It is at version 0.1.1.

Install

Run in a terminal

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

Add to claude_desktop_config.json

{
  "mcpServers": {
    "mcp-server-macos": {
      "command": "uvx",
      "args": [
        "mcp-server-macos"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "mcp-server-macos": {
      "command": "uvx",
      "args": [
        "mcp-server-macos"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "mcp-server-macos": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "mcp-server-macos"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Using several servers? Build one config file with the MCP config generator.

What it does

One-command install
Runs through uvx, with a JSON config for Claude Desktop and a one-click Cursor link.
Built on pymacos
Uses the pymacos library to act on the Mac.
Clear permission errors
Tells the assistant which macOS privacy permission is missing.
Easy to extend
A new tool is one function plus its tests.
MIT licensed
Free for personal and commercial use.

Good for

  • Let an assistant act on your Mac instead of describing steps
  • Add Mac control to Claude Code with one command
  • Extend the server with your own macOS tool
  • Use the same server from Cursor or Claude Desktop

Pricing

Open source

MIT licensed

mcp-server-macos FAQ

What does it require?

macOS and Python 3.10 or newer; uv makes setup a single command.

Who needs to grant macOS permissions?

The app that runs the server, such as Claude Desktop, your terminal or your editor.

What licence is it under?

MIT.

How do I add it to Claude Code?

Run claude mcp add macos -- uvx mcp-server-macos.

Is mcp-server-macos free?

Yes. mcp-server-macos is open source, so you can use and self-host it for free.

How do I add mcp-server-macos to Claude Code?

Run this command in your terminal: claude mcp add mcp-server-macos -- uvx mcp-server-macos

What are the best alternatives to mcp-server-macos?

The closest alternatives to mcp-server-macos are REA, Context7, Chrome DevTools MCP, Codebase Memory and GitHub.

Where this comes from

  • Description: written from the project's README.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers