XcodeBuildMCP

A Model Context Protocol (MCP) server and CLI that provides tools for agent use when working on iOS and macOS projects.

](https://github.com/getsentry/XcodeBuildMCP/actions/workflows/ci.yml) [ ](https://opensource.org/licenses/MIT) [ ](https://developer.apple.com/xcode/) [ ](https://modelcontextprotocol.io/) [ [](https://www.agentaudit.dev/skills/xcodebuildmcp)

Installation

XcodeBuildMCP ships as a single package with two modes: a CLI for direct terminal use and an MCP server for AI coding agents. Both installation methods give you both modes.

Option A — Homebrew

brew tap getsentry/xcodebuildmcp
brew install xcodebuildmcp

Use the CLI:

xcodebuildmcp --help

MCP client config:

"XcodeBuildMCP": {
  "command": "xcodebuildmcp",
  "args": ["mcp"]
}

Upgrade later with brew update && brew upgrade xcodebuildmcp.

Option B — npm / npx (Node.js 18+)

For CLI use, install globally:

npm install -g xcodebuildmcp@latest
xcodebuildmcp --help

For MCP server only, no global install needed — add directly to your client config:

"XcodeBuildMCP": {
  "command": "npx",
  "args": ["-y", "xcodebuildmcp@latest", "mcp"]
}

To pin a specific version, replace @latest with an exact version (e.g. xcodebuildmcp@latest).

Client-specific setup

The examples below use npx (Option B). If you installed via Homebrew, replace the command with "command": "xcodebuildmcp", "args": ["mcp"] instead.

Cursor

Recommended (project-scoped): add .cursor/mcp.json in your workspace root:

```json

{ "mcpServers": { "XcodeBuildMCP": { "command": "npx", "args": ["-y", "xcodebuildmcp@latest", "mcp"] } } }

```

For global Cursor config (~/.cursor/mcp.json), use this variant so startup is aligned with the active workspace:

```json

{ "mcpServers": { "XcodeBuildMCP": { "command": "/bin/zsh", "args": [ "-lc", "cd \"${workspaceFolder}\" && exec npx -y xcodebuildmcp@latest mcp" ] } } }

```

Or use the quick install link:

[](https://cursor.com/en-US/install-mcp?name=XcodeBuildMCP&config=eyJjb21tYW5kIjoibnB4IC15IHhjb2RlYnVpbGRtY3BAbGF0ZXN0IG1jcCJ9)

Claude Code

Run:

```bash

claude mcp add XcodeBuildMCP -- npx -y xcodebuildmcp@latest mcp

```

Codex CLI

Run:

```bash

codex mcp add XcodeBuildMCP -- npx -y xcodebuildmcp@latest mcp

```

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

```toml

[mcp_servers.XcodeBuildMCP] command = "npx" args = ["-y", "xcodebuildmcp@latest", "mcp"]

```

Claude Desktop