# XcodeBuildMCP MCP server

> Lets an AI client build, test, and manage Xcode projects and iOS simulators from the command line or MCP tools.

- Repository: https://github.com/getsentry/XcodeBuildMCP
- Page: https://hostedmcp.org/servers/getsentry/xcodebuildmcp
- Transport: stdio
- Stars: 6569
- License: MIT
- Latest version: 2.7.0

## Install

### Claude Code

```sh
claude mcp add xcodebuildmcp -- npx -y xcodebuildmcp
```

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

```json
{
  "mcpServers": {
    "xcodebuildmcp": {
      "command": "npx",
      "args": [
        "-y",
        "xcodebuildmcp"
      ]
    }
  }
}
```

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

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

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

```json
{
  "mcpServers": {
    "xcodebuildmcp": {
      "command": "npx",
      "args": [
        "-y",
        "xcodebuildmcp"
      ]
    }
  }
}
```

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

```toml
[mcp_servers.xcodebuildmcp]
command = "npx"
args = ["-y", "xcodebuildmcp"]
```

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

```json
{
  "mcpServers": {
    "xcodebuildmcp": {
      "command": "npx",
      "args": [
        "-y",
        "xcodebuildmcp"
      ]
    }
  }
}
```

## Environment variables

| Name | Required | Secret | Description |
|---|---|---|---|
| `INCREMENTAL_BUILDS_ENABLED` | no | no | Enable experimental xcodemake incremental builds (true/false or 1/0). |
| `XCODEBUILDMCP_DEBUG` | no | no | Enable verbose debug logging from the server. |
| `XCODEBUILDMCP_ENABLED_WORKFLOWS` | no | no | Comma-separated list of workflows to load at startup (e.g., 'simulator,device,project-discovery'). |
| `XCODEBUILDMCP_SENTRY_DISABLED` | no | no | Disable Sentry error reporting (preferred flag). |

## FAQ

### What does XcodeBuildMCP do?

It provides tools for agent use when working on iOS and macOS projects, including building for simulators and running prepared test products.

### How do I install XcodeBuildMCP?

Install it via Homebrew with brew tap getsentry/xcodebuildmcp and brew install mobilebuildmcp, or via npm with npm install -g mobilebuildmcp@latest.

### What are the requirements for XcodeBuildMCP?

It requires macOS 14.5 or later, Xcode 16.x or later, and Node.js 18.x or later (Node is not required for Homebrew installation).

### Can I run XcodeBuildMCP without a global install?

Yes, most MCP clients can run the server on demand via npx -y mobilebuildmcp@latest mcp.