XcodeBuildMCP

XcodeBuildMCP is a Model Context Protocol server and CLI that enables AI agents to automate builds and provide coding assistance for iOS and macOS projects using Xcode. Key features of XcodeBuildMCP: - Automated building, compiling, and project management for Xcode-based iOS and macOS applications - Direct integration with Xcode 16 on macOS for native Apple development workflows - Dual-mode operation: use as a command-line tool for terminal workflows or as an MCP server for AI coding agents - Compatible with popular AI coding assistants including Cursor, Claude Code, and VS Code - Installable via Homebrew or npm/npx for Node.js 18+ environments

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://badge.fury.io/js/xcodebuildmcp) [](https://opensource.org/licenses/MIT) [](https://nodejs.org/) [](https://developer.apple.com/xcode/) [](https://www.apple.com/macos/) [](https://modelcontextprotocol.io/) [](https://deepwiki.com/getsentry/XcodeBuildMCP) [](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:

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

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

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

Codex CLI

Run:

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

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

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

Claude Desktop

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

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

VS Code / VS Code Insiders

Add to your VS Code settings JSON:

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

Or use the quick install links:

[](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](https://img.shields.io/badge/VS_Code_Insiders-XcodeBuildMCP-24bfa5?style=flat&logo=visualstudiocode&logoColor=ffffff