XcodeBuild MCP
π§MCP ServerLets Claude Code and other AI coding tools build and work on your iOS and macOS apps through Xcode. You can also run the same tools yourself from the terminal.
Installation
What this MCP server does
Overview
XcodeBuildMCP gives AI agents tools for working on iOS and macOS projects with Xcode, Apple's app development tool. It comes as one package with two modes: an MCP server, which connects the tools to AI agents, and a command-line tool you use directly in the terminal. For example, xcodebuildmcp simulator build builds your app for the simulator, a virtual device that runs on your Mac.
Key Features
- Install it with Homebrew or npm, and run
xcodebuildmcp --helpto check the install. - Connect it to Cursor, Claude Code or Codex, or start it only when needed with
npx -y xcodebuildmcp@latest mcp. - Run tools from the terminal, such as
xcodebuildmcp toolsto list them orxcodebuildmcp simulator buildto build. - Capture logs and debug your app through a background helper that starts by itself when needed.
- Add optional skills that teach the agent how to use the server or the terminal tool with
xcodebuildmcp init.
Who is this for?
It fits iOS and macOS developers who want an AI agent to build and debug their Xcode projects. You need macOS 14.5 or later, Xcode 16 or later, and Node.js 18 or later (Node.js is not needed with Homebrew).
Summarized by AI from this repo's README. Suggest a better one
README.md
View on GitHub βA Model Context Protocol (MCP) server and CLI that provides tools for agent use when working on iOS and macOS projects.
Installation
XcodeBuildMCP 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 xcodebuildmcp
Option B β npm (Node.js 18+)
npm install -g xcodebuildmcp@latest
Verify either install:
xcodebuildmcp --help
Connect 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 xcodebuildmcp@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
XcodeBuildMCP 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:
xcodebuildmcp init
Or install directly via npx without a global install:
npx -y xcodebuildmcp@latest init
For further information on installing skills, see Agent Skills.
Notes
- XcodeBuildMCP 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
XcodeBuildMCP uses Sentry for internal runtime error telemetry only. For details and opt-out instructions, see Privacy & Telemetry.
CLI
XcodeBuildMCP 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 xcodebuildmcp@latest
# Start the MCP server (for MCP clients)
xcodebuildmcp mcp
# List available tools
xcodebuildmcp tools
# Build for simulator
xcodebuildmcp simulator build --scheme MyApp --project-path ./MyApp.xcodeproj
Check for updates and upgrade in place:
xcodebuildmcp upgrade --check
xcodebuildmcp upgrade --yes
The CLI uses a per-workspace daemon for stateful operations (log capture, debugging, etc.) that auto-starts when needed. See the CLI guide for full documentation.
Documentation
- Installation: https://xcodebuildmcp.com/docs/installation
- Setup: https://xcodebuildmcp.com/docs/setup
- MCP clients: https://xcodebuildmcp.com/docs/clients
- CLI usage: https://xcodebuildmcp.com/docs/cli
- Configuration and options: https://xcodebuildmcp.com/docs/configuration
- Tools reference: https://xcodebuildmcp.com/docs/tools
- Troubleshooting: https://xcodebuildmcp.com/docs/troubleshooting
- Privacy: https://xcodebuildmcp.com/docs/privacy
- Skills: https://xcodebuildmcp.com/docs/skills
- Contributing: https://xcodebuildmcp.com/docs/contributing
Licence
This project is licensed under the MIT License - see the LICENSE file for details. For third-party licensing notices see the THIRD_PARTY_LICENSES file for details. For npm package attributions see the THIRD_PARTY_PACKAGE_LICENSES file for details.
More from this repository4
Connects your AI assistant to Xcode, Apple's tool for making iPhone and Mac apps. The assistant can then build your projects and use tools that work with app screens and real devices.
An Xcode Build MCP CLI skill from Sentry for integrating Xcode build processes with AI tools, providing build management and error tracking capabilities.
An MCP server and CLI from Sentry that provides tools for AI agents working on iOS and macOS Xcode projects, enabling build management and diagnostics.
Skill