AgentToolHub
Skill

xcodebuildmcp-cli

xcodebuildmcp-cli — a Claude Code skill from getsentry/xcodebuildmcp

Features

  • ✓Curated collection of xcodebuildmcp-cli — a claude code skill from getsentry/xcodebuildmcp resources
  • ✓Covers a wide range of tools across multiple categories
  • ✓Community-maintained and regularly updated
  • ✓Browse the [GitHub repository](https://github.com/getsentry/xcodebuildmcp) for the complete list

Installation Guide

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

bash
brew tap getsentry/xcodebuildmcp
brew install xcodebuildmcp

Use the CLI:

bash
xcodebuildmcp --help

MCP client config:

json
"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:

bash
npm install -g xcodebuildmcp@latest
xcodebuildmcp --help

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

json
"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.

<details>
<summary>Cursor</summary>
<br />

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:

![Install MCP Server](https://cursor.com/en-US/install-mcp?name=XcodeBuildMCP&config=eyJjb21tYW5kIjoibnB4IC15IHhjb2RlYnVpbGRtY3BAbGF0ZXN0IG1jcCJ9)
<br />
</details>

<details>
<summary>Claude Code</summary>
<br />

Run:

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

<br />
</details>

<details>
<summary>Codex CLI</summary>
<br />

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"]

<br />
</details>

<details>
<summary>Claude Desktop</summary>
<br />

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

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

<br />
</details>

<details>
<summary>VS Code / VS Code Insiders</summary>
<br />

Add to your VS Code settings JSON:

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

Or use the quick install links:

![Install in VS Code](vscode:mcp/install?%7B%22name%22%3A%22XcodeBuildMCP%22%2C%22type%22%3A%22stdio%22%2C%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22xcodebuildmcp%40latest%22%2C%22mcp%22%5D%7D)
![Install in VS Code Insiders](vscode-insiders:mcp/install?%7B%22name%22%3A%22XcodeBuildMCP%22%2C%22type%22%3A%22stdio%22%2C%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22xcodebuildmcp%40latest%22%2C%22mcp%22%5D%7D)
<br />
</details>

<details>
<summary>Kiro / Kiro CLI</summary>
<br />

Workspace-level (applies only to the current workspace): add .kiro/settings/mcp.json in your project root:

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

User-level (applies globally across all workspaces): add to ~/.kiro/settings/mcp.json:

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

<br />
</details>

<details>
<summary>Windsurf</summary>
<br />

Add to ~/.codeium/windsurf/mcp_config.json:

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

<br />
</details>

<details>
<summary>Trae</summary>
<br />

Add to ~/Library/Application Support/Trae/User/mcp.json:

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

<br />
</details>

<details>
<summary>Xcode (Codex Agent)</summary>
<br />

Requires Xcode 26.3 or later. Codex agent must be installed and configured in Xcode Settings -> Intelligence -> Open AI.

The only way at the time of writing to add an MCP server is to use a project scoped .codex/config.toml file in the root of your project workspace:
/path/to/your/project/.codex/config.toml

toml
  [mcp_servers.XcodeBuildMCP]
  args = [
  "-lc",
  "PATH=/opt/homebrew/bin:/usr/local/bin:/usr/bin:/bin:/usr/sbin:/sbin; export NVM_DIR=\"$HOME/.nvm\"; [ -s \"$NVM_DIR/nvm.sh\" ] && . \"$NVM_DIR/nvm.sh\"; nvm use --silent >/dev/null 2>&1 || true; npx -y xcodebuildmcp@latest mcp"
  ]
  command = "/bin/zsh"
  enabled = true
  tool_timeout_sec = 10000

> NOTE:
> Codex Agent when running in Xcode has a limited PATH by default. The above example should work for most users but if you find the server doesn't start or is not available, it's likely because npx is not found so you might have to adjust the above configuration accordingly.

<br />
</details>

<details>
<summary>Xcode (Claude Code Agent)</summary>
<br />

Requires Xcode 26.3 or later. Claude Code agent must be installed and configured in Xcode Settings -> Intelligence -> Anthropic.

Add to the end or replace the existing mcpServers object in Xcode's Claude Code agent config at:
~/Library/Developer/Xcode/CodingAssistant/ClaudeAgentConfig/.claude.json

json
    // ... rest of file ...
    "mcpServers": {
      "XcodeBuildMCP": {
        "command": "/bin/zsh",
        "args": [
          "-lc",
          "PATH=/opt/homebrew/bin:/usr/local/bin:/usr/bin:/bin:/usr/sbin:/sbin; export NVM_DIR=\"$HOME/.nvm\"; [ -s \"$NVM_DIR/nvm.sh\" ] && . \"$NVM_DIR/nvm.sh\"; nvm use --silent >/dev/null 2>&1 || true; npx -y xcodebuildmcp@latest mcp"
        ]
      }
    }
  }

> NOTE:
> Claude Code Agent when running in Xcode has a limited PATH by default. The above example should work for most users but if you find the server doesn't start or is not available, it's likely because npx is not found so you might have to adjust the above configuration accordingly.

<br />
</details>

<details>
<summary>AdaL CLI</summary>
<br />

Run the following command inside the AdaL CLI prompt:

console
  /mcp add XcodeBuildMCP --command npx --args "-y,xcodebuildmcp@latest,mcp"

<br />
</details>

<br />

For other installation options see [Getting Started](docs/GETTING_STARTED.md).

Reviews