XcodeBuildMCP
VerifiedMCP server and CLI for Xcode-based iOS and macOS development.
What is the XcodeBuildMCP MCP server?
XcodeBuildMCP provides build, simulator, and device tooling for Xcode 16 projects on macOS 14.5+. It supports both MCP mode for agents and a unified CLI that can launch a stateful daemon for logging and debugging.
Optional agent skills can be installed to prime models on effective use of the tools or CLI commands. The server is distributed via Homebrew or npm and requires no remote API keys.
Install & connect
Add this to your MCP client config. Pick your client below and copy.
{
"mcpServers": {
"XcodeBuildMCP": {
"command": "npx",
"args": [
"-y",
"xcodebuildmcp"
]
}
}
}Package: xcodebuildmcp (npm)
Other ways to install
npx
npx -y xcodebuildmcpExample prompts
Once connected, try asking your AI client:
Security & permissions
Runs locally via stdio on macOS and accesses Xcode projects, build artifacts, and optionally device signing identities; no remote API keys required.
What you can do with XcodeBuildMCP
Simulator builds
Trigger simulator builds for a given scheme and project path directly from an AI coding session.
Device deployment
Run and debug apps on physical devices after code signing is configured in Xcode.
Log capture
Start stateful log capture sessions for troubleshooting builds or runtime issues.
How to use XcodeBuildMCP
- 1Install via Homebrew or npm (Node 18+).
- 2Run xcodebuildmcp mcp to start the server for MCP clients.
- 3Add the stdio configuration to your AI client (Cursor, Claude, etc.).
- 4Optionally run xcodebuildmcp init to install agent skills.
- 5Use xcodebuildmcp tools or CLI subcommands for direct access.
XcodeBuildMCP: pros & cons
Pros
- +Native Xcode 16 and macOS integration with simulator and device support.
- +Dual CLI + MCP interface with stateful daemon for logs and debugging.
- +Agent skills available to improve model performance on Apple projects.
- +Simple install via Homebrew or npm with no external service dependencies.
Cons
- –Requires recent macOS and Xcode versions; not usable on other platforms.
- –Device features need manual code-signing setup in Xcode.
- –Tool list is not documented in public README; must query via CLI.
Frequently asked questions
Yes, clients can invoke it on demand with npx -y xcodebuildmcp@latest mcp.
User reviews
Verified reviews from the community shape this listing's rating.
Loading reviews…