# mcp-server-macos

> mcp-server-macos is an open-source MCP server for productivity. Lets Claude, Cursor and other MCP clients control your Mac, built on pymacos. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** macOS, CLI
- **Repository:** https://github.com/jeanextreme002/mcp-server-macos
- **MCP Registry name:** io.github.JeanExtreme002/mcp-server-macos
- **Categories:** [productivity](https://ai-powered.com/categories/productivity), [developer tools](https://ai-powered.com/categories/developer-tools)
- **Listing updated:** 2026-11-18

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
claude mcp add mcp-server-macos -- uvx mcp-server-macos
```

### Claude Desktop (claude_desktop_config.json)

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

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "mcp-server-macos": {
      "command": "uvx",
      "args": [
        "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.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Context7](https://ai-powered.com/mcp/context7): Context7 is a freemium MCP server for developer tools.
- [Chrome DevTools MCP](https://ai-powered.com/mcp/chrome-devtools-mcp-2): Chrome DevTools MCP is an open-source MCP server for browser automation.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [awesome-mcp-servers](https://ai-powered.com/mcp/awesome-mcp-servers-2): awesome-mcp-servers is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.

---
Source: https://ai-powered.com/mcp/mcp-server-macos
