# mac-control MCP server

> Lets an AI client automate macOS by driving app accessibility trees, windows, input, browsers, screen capture, OCR, and Apple apps.

- Repository: https://github.com/AdelElo13/mac-control-mcp
- Page: https://hostedmcp.org/servers/adelelo13/mac-control-mcp
- Transport: stdio
- Stars: 18
- License: MIT
- Latest version: 0.10.3

## Install

### Claude Code

```sh
claude mcp add mac-control-mcp -- npx -y mac-control-mcp
```

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

```json
{
  "mcpServers": {
    "mac-control-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "mac-control-mcp"
      ]
    }
  }
}
```

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

```json
{
  "servers": {
    "mac-control-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "mac-control-mcp"
      ]
    }
  }
}
```

### VS Code CLI

```sh
code --add-mcp '{"name":"mac-control-mcp","type":"stdio","command":"npx","args":["-y","mac-control-mcp"]}'
```

### Claude Desktop (`claude_desktop_config.json`)

```json
{
  "mcpServers": {
    "mac-control-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "mac-control-mcp"
      ]
    }
  }
}
```

### Codex

```sh
codex mcp add mac-control-mcp -- npx -y mac-control-mcp
```

### Codex config.toml (`~/.codex/config.toml`)

```toml
[mcp_servers.mac-control-mcp]
command = "npx"
args = ["-y", "mac-control-mcp"]
```

### Gemini CLI

```sh
gemini mcp add -s user mac-control-mcp npx -- -y mac-control-mcp
```

### Gemini settings.json (`~/.gemini/settings.json`)

```json
{
  "mcpServers": {
    "mac-control-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "mac-control-mcp"
      ]
    }
  }
}
```

## Environment variables

| Name | Required | Secret | Description |
|---|---|---|---|
| `NOTARIZE_PROFILE` | no | no |  |

## Tools (10)

- `capture_screen`
- `capture_screen_v2`
- `capture_window`
- `capture_display`
- `list_elements`
- `find_element`
- `find_elements`
- `query_elements`
- `get_ui_tree`
- `ax_tree_augmented`

## FAQ

### What can an AI client do with mac-control-mcp?

It can read and mutate the Accessibility tree of any running app, drive Safari and Chrome, capture and OCR the screen, click and type, manage windows and the clipboard, and control Apple apps like Mail, Calendar and Reminders.

### What macOS version does mac-control-mcp require?

It requires macOS 14.0 or later.

### Do I need Python or Node to run mac-control-mcp?

No. It is a native Swift app bundle, and the npm package is only a thin launcher that downloads the notarized app.

### What permissions does mac-control-mcp need?

The first tool call triggers macOS consent prompts for Screen Recording, Accessibility and Apple Events, which must be granted once.

### Does mac-control-mcp make network calls?

No, everything is local system integration.
