# MobileBuildMCP MCP server

> Lets an AI agent build, test, and manage iOS and macOS Xcode projects through MCP tools or a CLI.

- Repository: https://github.com/getsentry/MobileBuildMCP
- Page: https://hostedmcp.org/servers/getsentry/mobilebuildmcp
- Official: yes
- Transport: stdio
- Stars: 6573
- License: MIT

## Install

### Claude Code

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

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

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

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

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

### VS Code CLI

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

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

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

### Codex

```sh
codex mcp add mobilebuildmcp -- npx -y mobilebuildmcp
```

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

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

### Gemini CLI

```sh
gemini mcp add -s user mobilebuildmcp npx -- -y mobilebuildmcp
```

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

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

## FAQ

### What does MobileBuildMCP do for iOS and macOS projects?

It provides MCP tools and CLI commands that let agents build, test, and manage Xcode projects for iOS and macOS, including simulator builds and test products.

### How do I install MobileBuildMCP?

Install it via Homebrew with the getsentry tap or via npm globally with mobilebuildmcp@latest; both give you the CLI and the MCP server.

### What are the system requirements for MobileBuildMCP?

It requires macOS 14.5 or later and Xcode 16.x or later, plus Node.js 18.x or later unless you installed via Homebrew.

### Can I build for a simulator from the command line with MobileBuildMCP?

Yes, the CLI includes a simulator build command that takes a scheme and project path.

### Does MobileBuildMCP send telemetry?

It uses Sentry only for internal runtime error telemetry, and the docs describe how to opt out.