XcodeBuild MCP server
{
"mcpServers": {
"xcodebuildmcp": {
"command": "npx",
"args": [
"-y",
"xcodebuildmcp@latest"
]
}
}
}{
"mcpServers": {
"xcodebuildmcp": {
"command": "npx",
"args": [
"-y",
"xcodebuildmcp@latest"
]
}
}
}{
"mcpServers": {
"xcodebuildmcp": {
"command": "npx",
"args": [
"-y",
"xcodebuildmcp@latest"
]
}
}
}{
"servers": {
"xcodebuildmcp": {
"command": "npx",
"args": [
"-y",
"xcodebuildmcp@latest"
]
}
}
}{
"mcpServers": {
"xcodebuildmcp": {
"command": "npx",
"args": [
"-y",
"xcodebuildmcp@latest"
]
}
}
}file .mcp.json (in your project root)file claude_desktop_config.jsonfile ~/.cursor/mcp.jsonfile .vscode/mcp.jsonfile ~/.codeium/windsurf/mcp_config.jsoninstall npx -y xcodebuildmcpversion 2.7.0
What it does
XcodeBuildMCP is an MCP server and CLI for managing iOS and macOS projects, providing tools for building, testing, and managing simulators and devices. It is for developers working on Apple platforms who want to automate build workflows and integrate Xcode operations with AI agents.
- Build iOS or macOS apps for simulators and devices with specified schemes and configurations.
- Run unit and integration tests on simulators, including preparing and executing test products.
- Manage simulator instances and device connections for testing and debugging workflows.
Tools this server exposes
| Tool | Does |
|---|---|
| simulator_build | Build an app for iOS/macOS simulator with options for test product generation. |
| simulator_test | Run tests on a simulator using previously prepared or new test products. |
| device_build | Build an app for a physical iOS/macOS device. |
| device_test | Run tests on a physical device. |
| simulator_list | List available iOS/macOS simulators. |
| device_list | List connected physical devices. |
| project_info | Retrieve information about an Xcode project structure and configuration. |
Before you enable it
An MCP server runs with whatever access you give it. Start with a development account rather than production, and check which tools the server exposes before you let an agent call them unattended.