XcodeBuildMCP MCP server
XcodeBuildMCP provides tools for Xcode project management, simulator management, and app utilities.
6.4k stars43k downloads/wk
Reviews
Write oneNobody has reviewed XcodeBuildMCP yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
XcodeBuildMCP tools
No tool declarations could be read from the package source. They show once the server is installed.
Public scan report
scanner v0.1.9 · 2026-09-25 · same rubric, same numbers if you re-run it
- Code scan533 source files scanned13/25
- –Live reliabilityno gateway calls yet and no remote to proben/a
- –Tool poisoningtools not inspected (local package is not executed); not countedn/a
- Auth qualitylocal package, no credentials required12/15
- Maintenancelast push 2 days ago15/15
- Maintainer identitynamespace and repository owner differ; GitHub account older than a year6/10
Findings (1)
- highShell command built from a string (injection risk)
exec.shell-concatbuild/utils/environment.js: …entPid) { const parentCommand = execSync(`ps -o command= -p ${parentPid}`, { encoding: "utf8…
Install XcodeBuildMCP in Claude Code, Cursor or VS Code
Runs npx -y xcodebuildmcp on your machine. Read the scan report first; the gateway never runs local packages.
claude mcp add XcodeBuildMCP -- npx -y xcodebuildmcp
What the publisher says
From the XcodeBuildMCP repository's README, as published. We do not edit it. Read it on GitHub
A Model Context Protocol (MCP) server and CLI that provides tools for agent use when working on iOS and macOS projects.
Installation
MobileBuildMCP ships as a single package with two modes: a CLI for direct terminal use and an MCP server for AI coding agents. Either install method gives you both.
Option A — Homebrew
brew tap getsentry/xcodebuildmcp
brew install mobilebuildmcpOption B — npm (Node.js 18+)
npm install -g mobilebuildmcp@latestVerify either install:
mobilebuildmcp --helpConnect your MCP client
Drop-in config snippets for Cursor, Claude Code, Codex, can be found in the official docs page MCP Clients. Most clients can also run the MCP server on demand via npx -y mobilebuildmcp@latest mcp without a global install.
Requirements
- macOS 14.5 or later
- Xcode 16.x or later
- Node.js 18.x or later (not required for Homebrew installation)
Skills
MobileBuildMCP now includes two optional agent skills:
- MCP Skill: Primes the agent with instructions on how to use the MCP server's tools (optional when using the MCP server).
- CLI Skill: Primes the agent with instructions on how to navigate the CLI (recommended when using the CLI).
To install with a global binary:
mobilebuildmcp initOr install directly via npx without a global install:
npx -y mobilebuildmcp@latest initFor further information on installing skills, see Agent Skills.
Notes
- MobileBuildMCP requests xcodebuild to skip macro validation to avoid errors when building projects that use Swift Macros.
- Device tools require code signing to be configured in Xcode. See Device Code Signing.
Privacy
MobileBuildMCP uses Sentry for internal runtime error telemetry only. For details and opt-out instructions, see Privacy & Telemetry.
CLI
MobileBuildMCP provides a unified command-line interface. The mcp subcommand starts the MCP server, while all other commands provide direct terminal access to tools:
# Install globally
npm install -g mobilebuildmcp@latest
# Start the MCP server (for MCP clients)
mobilebuildmcp mcp
# List available tools
mobilebuildmcp toolsShortened. The full README is on GitHub.
Nothing above is checked by us. What we check is on the safety report.
XcodeBuildMCP: common questions
- Is XcodeBuildMCP MCP server safe?
- Mostly: it is graded B (71/100). Read the XcodeBuildMCP safety report
- How do I install XcodeBuildMCP?
- It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
- Does XcodeBuildMCP need an API key?
- No secret keys are declared. It reads 4 settings from the environment.
- Is XcodeBuildMCP maintained?
- The last commit was 4 days ago (2026-09-23). The latest release is v2.7.0.