XcodeBuildMCP

by cameroncooke

Recommended

6k stars

959 downloads

Not rated

GitHub Website

Description

 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…

About

Details

Author: cameroncooke
GitHub stars: 6,040
Downloads: 959
Categories: Developer Tools, Community, Other, Infrastructure

- 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 XcodeBuildMCP

Command (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

Setting up with Cursor

Open Cursor's settings
Navigate to the MCP section
Click "Add new Global MCP server"
Copy and paste the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "xcodebuildmcp": {
            "XcodeBuildMCP": {
                "command": "npx",
                "args": [
                    "-y",
                    "xcodebuildmcp@latest",
                    "init"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "xcodebuildmcp": {
            "XcodeBuildMCP": {
                "command": "npx",
                "args": [
                    "-y",
                    "xcodebuildmcp@latest",
                    "init"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "xcodebuildmcp": {
            "XcodeBuildMCP": {
                "command": "npx",
                "args": [
                    "-y",
                    "xcodebuildmcp@latest",
                    "init"
                ]
            }
        }
    }
}

Setting up with Claude Desktop

Open Claude Desktop's settings
Go to the Integrations tab
Click "Add MCP Server"
Use the configuration below based on your operating system

Note: Make sure Claude Desktop is running before attempting to connect.

JSON

{
    "mcpServers": {
        "xcodebuildmcp": {
            "XcodeBuildMCP": {
                "command": "npx",
                "args": [
                    "-y",
                    "xcodebuildmcp@latest",
                    "init"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "xcodebuildmcp": {
            "XcodeBuildMCP": {
                "command": "npx",
                "args": [
                    "-y",
                    "xcodebuildmcp@latest",
                    "init"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "xcodebuildmcp": {
            "XcodeBuildMCP": {
                "command": "npx",
                "args": [
                    "-y",
                    "xcodebuildmcp@latest",
                    "init"
                ]
            }
        }
    }
}

Setting up with Windsurf

Open Windsurf's preferences
Go to the Integrations section
Click "Add MCP Integration"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "xcodebuildmcp": {
            "XcodeBuildMCP": {
                "command": "npx",
                "args": [
                    "-y",
                    "xcodebuildmcp@latest",
                    "init"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "xcodebuildmcp": {
            "XcodeBuildMCP": {
                "command": "npx",
                "args": [
                    "-y",
                    "xcodebuildmcp@latest",
                    "init"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "xcodebuildmcp": {
            "XcodeBuildMCP": {
                "command": "npx",
                "args": [
                    "-y",
                    "xcodebuildmcp@latest",
                    "init"
                ]
            }
        }
    }
}

Setting up with Cline

Open Cline's settings
Navigate to the Integrations section
Click "Add MCP Server"
Copy and paste the configuration below based on your operating system

Note: Make sure to restart Cline after adding the configuration.

JSON

{
    "mcpServers": {
        "xcodebuildmcp": {
            "XcodeBuildMCP": {
                "command": "npx",
                "args": [
                    "-y",
                    "xcodebuildmcp@latest",
                    "init"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "xcodebuildmcp": {
            "XcodeBuildMCP": {
                "command": "npx",
                "args": [
                    "-y",
                    "xcodebuildmcp@latest",
                    "init"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "xcodebuildmcp": {
            "XcodeBuildMCP": {
                "command": "npx",
                "args": [
                    "-y",
                    "xcodebuildmcp@latest",
                    "init"
                ]
            }
        }
    }
}

Setting up with Goose

Open Goose's preferences
Go to the Integrations tab
Select "MCP Servers"
Click "Add New Server"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "xcodebuildmcp": {
            "XcodeBuildMCP": {
                "command": "npx",
                "args": [
                    "-y",
                    "xcodebuildmcp@latest",
                    "init"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "xcodebuildmcp": {
            "XcodeBuildMCP": {
                "command": "npx",
                "args": [
                    "-y",
                    "xcodebuildmcp@latest",
                    "init"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "xcodebuildmcp": {
            "XcodeBuildMCP": {
                "command": "npx",
                "args": [
                    "-y",
                    "xcodebuildmcp@latest",
                    "init"
                ]
            }
        }
    }
}

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 run`simulator build`with a scheme and project path to compile your iOS or macOS project. - **Run tests on a specific simulator**— use`simulator test`with a test products path and simulator name to execute previously prepared test bundles. - **Prepare test products without running them**— invoke`simulator build`with`--build-for-testing`and a`--test-products-path`to generate portable`.xctestproducts`bundles. - **Start the MCP server for an AI client**— run the`mcp`subcommand so your coding agent can access all build and test tools via the MCP protocol. - **List available tools from the CLI**— use the`tools`command to discover which operations are available in the current environment. - **Check for and apply updates**— run`upgrade --check`or`upgrade --yes`to 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: a**CLI**for direct terminal use and an**MCP server**for 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 page[MCP Clients. Most clients can also run the MCP server on demand via`npx -y xcodebuildmcp@latest mcp`without 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, see](https://xcodebuildmcp.com/docs/clients)[Agent 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. See](https://xcodebuildmcp.com/docs/skills)[Device Code Signing. XcodeBuildMCP uses Sentry for internal runtime error telemetry only. For details and opt-out instructions, see](https://xcodebuildmcp.com/docs/device-signing)[Privacy & Telemetry. 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 # 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 the](https://xcodebuildmcp.com/docs/privacy)[CLI guidefor full documentation. - Installation:](https://xcodebuildmcp.com/docs/cli)[https://xcodebuildmcp.com/docs/installation - Setup:](https://xcodebuildmcp.com/docs/installation)[https://xcodebuildmcp.com/docs/setup - MCP clients:](https://xcodebuildmcp.com/docs/setup)[https://xcodebuildmcp.com/docs/clients - CLI usage:](https://xcodebuildmcp.com/docs/clients)[https://xcodebuildmcp.com/docs/cli - Configuration and options:](https://xcodebuildmcp.com/docs/cli)[https://xcodebuildmcp.com/docs/configuration - Tools reference:](https://xcodebuildmcp.com/docs/configuration)[https://xcodebuildmcp.com/docs/tools - Troubleshooting:](https://xcodebuildmcp.com/docs/tools)[https://xcodebuildmcp.com/docs/troubleshooting - Privacy:](https://xcodebuildmcp.com/docs/troubleshooting)[https://xcodebuildmcp.com/docs/privacy - Skills:](https://xcodebuildmcp.com/docs/privacy)[https://xcodebuildmcp.com/docs/skills - Contributing:](https://xcodebuildmcp.com/docs/skills)[https://xcodebuildmcp.com/docs/contributing This project is licensed under the MIT License - see the](https://xcodebuildmcp.com/docs/contributing)[LICENSEfile for details. For third-party licensing notices see the](https://github.com/getsentry/XcodeBuildMCP/blob/HEAD/LICENSE)[THIRD_PARTY_LICENSESfile for details. For npm package attributions see the](https://github.com/getsentry/XcodeBuildMCP/blob/HEAD/THIRD_PARTY_LICENSES)[THIRD_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](https://github.com/getsentry/XcodeBuildMCP/blob/HEAD/THIRD_PARTY_PACKAGE_LICENSES.md)

No reviews yet — be the first

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.

Description

About

Details

Jump to

Setting up with Highlight

From the repository

Claude Desktop / Cursor

McpServers

Install

More like this

Sequential Thinking

Sentry

Github

Filesystem

EverArt

Google Drive