XcodeBuildMCP
About
Popular MCP server that enables AI agents to scaffold, build, run and test iOS, macOS, visionOS and watchOS apps or simulators and wired and wireless devices. It has powerful UI-automation capabilities like controlling the simulator, capturing run-time logs, as well as taking screenshots and viewing the…
Details
- License
- MIT
Explore
- MCP server for AI coding agent integration
- CLI for direct terminal use in iOS/macOS builds
- Optional agent skills (MCP and CLI) to prime agents
- Automatic skip of Swift Macro validation to reduce errors
- Per‑workspace daemon for stateful operations (log capture, debugging)
- Device tools requiring Xcode code signing configuration
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
XcodeBuildMCPCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
Install via Homebrew (brew tap getsentry/xcodebuildmcp && brew install xcodebuildmcp) or npm (npm install -g xcodebuildmcp@latest). Start the MCP server with xcodebuildmcp mcp for integration with MCP clients like Cursor or Claude Code, or use CLI commands such as xcodebuildmcp tools and xcodebuildmcp simulator build --scheme MyApp directly.
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"xcodebuildmcp": {
"XcodeBuildMCP": {
"command": "npx",
"args": [
"-y",
"xcodebuildmcp@latest",
"init"
]
}
}
}
}McpServers
{
"XcodeBuildMCP": {
"command": "npx",
"args": [
"-y",
"xcodebuildmcp@latest",
"init"
]
}
}- Build an app for the simulator— ask the agent to runsimulator buildwith a scheme and project path to compile your iOS or macOS project.
- Run tests on a specific simulator— usesimulator testwith a test products path and simulator name to execute previously prepared test bundles.
- Prepare test products without running them— invokesimulator buildwith--build-for-testingand a--test-products-pathto generate portable.xctestproductsbundles.
- Start the MCP server for an AI client— run themcpsubcommand so your coding agent can access all build and test tools via the MCP protocol.
- List available tools from the CLI— use thetoolscommand to discover which operations are available in the current environment.
- Check for and apply updates— runupgrade --checkorupgrade --yesto update the CLI in place.
A Model Context Protocol (MCP) server and CLI that provides tools for agent use when working on iOS and macOS projects.
XcodeBuildMCP ships as a single package with two modes: aCLIfor direct terminal use and anMCP serverfor AI coding agents. Either install method gives you both.
brew tap getsentry/xcodebuildmcp brew install xcodebuildmcp
Drop-in config snippets for Cursor, Claude Code, Codex, can be found in the official docs pageMCP Clients. Most clients can also run the MCP server on demand vianpx -y xcodebuildmcp@latest mcpwithout a global install.
- macOS 14.5 or later
- Xcode 16.x or later
- Node.js 18.x or later (not required for Homebrew installation)
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).
Or install directly via npx without a global install:
For further information on installing skills, seeAgent Skills.
- 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. SeeDevice Code Signing.
XcodeBuildMCP uses Sentry for internal runtime error telemetry only. For details and opt-out instructions, seePrivacy & Telemetry.
XcodeBuildMCP provides a unified command-line interface. Themcpsubcommand 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 # Prepare portable test products without running tests xcodebuildmcp simulator build --scheme MyApp --project-path ./MyApp.xcodeproj --simulator-name "iPhone 17" --build-for-testing --test-products-path ./MyApp.xctestproducts # Run previously prepared test products xcodebuildmcp simulator test --test-products-path ./MyApp.xctestproducts --simulator-name "iPhone 17"
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 theCLI guidefor full 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
This project is licensed under the MIT License - see theLICENSEfile for details. For third-party licensing notices see theTHIRD_PARTY_LICENSESfile for details. For npm package attributions see theTHIRD_PARTY_PACKAGE_LICENSESfile for details.
This is a web browser that enables your coding agent, such as Claude Code, to visit websites on your behalf and assist you in identifying bugs or creating UI test cases.
A Model Context Protocol (MCP) server that enables AI assistants to integrate with Prometheus Alertmanager
A comprehensive MCP server for tooling interactions(40+) and resource accessibility(60+) plus many useful prompts to interact with Algorand Blockchain.
An MCP server that provides control over Android devices through ADB. Offers device screenshot capture, UI layout analysis, package management, and ADB command execution capabilities.
A Binary Ninja plugin, MCP server, and bridge that seamlessly integrates Binary Ninja with your favorite MCP client.
integration that connects BloodHound with AI through MCP, allowing security professionals to analyze Active Directory attack paths using natural language queries instead of Cypher.
A specialized MCP gateway for LLM enhancement prompts and jailbreaks with dynamic schema adaptation. Provides prompts for different LLMs using an enum-based approach.
Obtains latest dependency details for Clojure libraries.
A Model Context Protocol (MCP) server for CODESYS V3 programming environments.
Analyze large codebases and document collections using high-context models via OpenRouter, OpenAI, or Google AI -- very useful, e.g., with Claude Code
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
