# MCP Server for Mac: Let Claude Code Drive Your Mac

> Edith includes an MCP server. Connect Claude Code, Codex, Cursor or VS Code once, and the commands of every extension you enable become tools your agent can call, with the same safety rules as the command line.

- Canonical URL: https://getedith.pro/mcp
- Server command: `/Applications/Edith.app/Contents/MacOS/ed mcp`
- Requirements: Edith on macOS 14 or later on Apple silicon

## How it works

1. **Connect**: run `ed mcp install --client all`, or press Connect all in Settings, then Tools. `--client` also takes `claude`, `codex`, `cursor` or `vscode`.
2. **Discover**: the agent calls `edith_catalog` to see each extension, whether it is enabled, installed or available, and example commands.
3. **Act**: it calls tools such as `edith_usage_limits` or `edith_clipboard_ls` and gets the command's JSON back.

## Safety

- Destructive commands and extension installs return a preview until the call passes `confirm: true`.
- A call that puts a confirmation flag such as `--yes` in its arguments is refused, so `confirm` is the only way to apply a change.
- Tools exist only for extensions you have enabled.
- Installing an extension previews first, and the tool list refreshes after it is installed.
- Every tool returns the same JSON as `ed ... --json`.

## Clients

### Claude Code

```sh
claude mcp add --scope user edith -- /Applications/Edith.app/Contents/MacOS/ed mcp
```

Or let Edith write the entry for you:

```sh
ed mcp install --client claude
```

Or add this to `~/.claude.json`:

```json
{
  "mcpServers": {
    "edith": {
      "args": [
        "mcp"
      ],
      "command": "/Applications/Edith.app/Contents/MacOS/ed",
      "env": {},
      "type": "stdio"
    }
  }
}
```

### Codex

```sh
codex mcp add edith -- /Applications/Edith.app/Contents/MacOS/ed mcp
```

Or let Edith write the entry for you:

```sh
ed mcp install --client codex
```

Or add this to `~/.codex/config.toml`:

```toml
[mcp_servers.edith]
command = "/Applications/Edith.app/Contents/MacOS/ed"
args = ["mcp"]
```

### Cursor

```sh
ed mcp install --client cursor
```

Or add this to `~/.cursor/mcp.json`:

```json
{
  "mcpServers": {
    "edith": {
      "args": [
        "mcp"
      ],
      "command": "/Applications/Edith.app/Contents/MacOS/ed"
    }
  }
}
```

### VS Code

```sh
ed mcp install --client vscode
```

Or add this to `~/Library/Application Support/Code/User/mcp.json`:

```json
{
  "servers": {
    "edith": {
      "args": [
        "mcp"
      ],
      "command": "/Applications/Edith.app/Contents/MacOS/ed",
      "type": "stdio"
    }
  }
}
```

## Tool name prefixes by extension

- [Audio Mixer](https://getedith.pro/extensions/audio-mixer): `edith_audio`
- [Presenter](https://getedith.pro/extensions/presenter-mode): `edith_presenter`
- [Color Picker](https://getedith.pro/extensions/color-picker): `edith_color` or `edith_colour`
- [Menu Bar Stats](https://getedith.pro/extensions/menu-bar-stats): `edith_system`
- [Emoji Picker](https://getedith.pro/extensions/emoji-picker): `edith_emoji`
- [Homebrew](https://getedith.pro/extensions/homebrew): `edith_brew`
- [Calendar](https://getedith.pro/extensions/calendar): `edith_calendar`
- [Running Apps](https://getedith.pro/extensions/running-apps): `edith_apps`
- [Keyboard Clean](https://getedith.pro/extensions/keyboard-clean): `edith_keyboard`
- [Cleaner](https://getedith.pro/extensions/disk-cleaner): `edith_cleaner`
- [App Updates](https://getedith.pro/extensions/app-updates): `edith_maintenance`
- [Plugins](https://getedith.pro/extensions/agent-skills): `edith_skills`
- [Shelf](https://getedith.pro/extensions/notch-shelf): `edith_shelf`
- [Clipboard](https://getedith.pro/extensions/clipboard-manager): `edith_clipboard`
- [Music](https://getedith.pro/extensions/music-player): `edith_music`
- [Docs](https://getedith.pro/extensions/command-reference): `edith_docs`
- [LaTeX](https://getedith.pro/extensions/latex-editor): `edith_latex`
- [Memory](https://getedith.pro/extensions/private-memory): `edith_companion`
- [Studio](https://getedith.pro/extensions/studio): `edith_studio`
- [Usage](https://getedith.pro/extensions/claude-code-usage): `edith_usage`
- [Launcher](https://getedith.pro/extensions/launcher): `edith_bifrost`
- [Lid Awake](https://getedith.pro/extensions/lid-awake): `edith_lid_awake`
- [Attention](https://getedith.pro/extensions/screen-time-tracker): `edith_attention`
- [Machines](https://getedith.pro/extensions/ssh-machines): `edith_machines`
- [Downloads](https://getedith.pro/extensions/media-downloader): `edith_download` or `edith_downloads` or `edith_dl`
- [Site Audit](https://getedith.pro/extensions/site-audit): `edith_seo`
- [Virtual Camera](https://getedith.pro/extensions/virtual-camera): `edith_camera`
- [Code Stats](https://getedith.pro/extensions/code-stats): `edith_code_stats`
- [Agents](https://getedith.pro/extensions/coding-agents): `edith_herdr`
- [Code Review](https://getedith.pro/extensions/code-review): `edith_quinjet`
- [Database](https://getedith.pro/extensions/database-client): `edith_database`

## Coding agents

- [Claude Code on Mac: Usage, Limits and MCP](https://getedith.pro/agents/claude-code.md): Session, weekly and Fable limits in the menu bar, cost by repository, several Claude accounts, permission prompts you can answer from Edith, and every Edith command as an MCP tool.
- [Codex on Mac: Usage Limits, Workspaces and MCP](https://getedith.pro/agents/codex.md): Codex's 5-hour and weekly limits in the menu bar, local and Codex Cloud history, a board that launches Codex with your model and effort, and every Edith command as an MCP tool.
