# XcodeBuildMCP

> A Model Context Protocol (MCP) server and CLI that provides tools for agent use when working on iOS and macOS projects.

- **URL**: https://www.freshcrate.ai/projects/XcodeBuildMCP
- **Author**: getsentry
- **Category**: MCP Servers
- **Latest version**: `v2.6.0` (2026-06-01)
- **License**: MIT
- **Source**: https://github.com/getsentry/XcodeBuildMCP
- **Homepage**: https://www.xcodebuildmcp.com
- **Language**: TypeScript
- **GitHub**: 5,287 stars, 254 forks
- **Registry**: github
- **Tags**: `mcp`, `mcp-server`, `model-context-protocol`, `model-context-protocol-servers`, `tag-production`, `typescript`, `xcode`, `xcodebuild`

## Description

A Model Context Protocol (MCP) server and CLI that provides tools for agent use when working on iOS and macOS projects.

## Recent releases

| Version | Date | Urgency | Changes |
| --- | --- | --- | --- |
| `v2.6.0` | 2026-06-01 | High | ## Release v2.6.0  ### New! Runtime UI automation  UI automation now hands your agent reusable context instead of just confirming an action ran. After a tap, swipe, type, wait, or batch, the result includes a compact snapshot of the foreground UI with stable element references and a screen hash, so the agent can pick the next control directly rather than taking another screenshot or re-running a full snapshot. Candidate controls are ranked from real accessibility data, and suggested next steps p |
| `v2.5.2` | 2026-05-12 | High | ## Release v2.5.2  ### Changed  - Updated the bundled AXe binary used by UI automation tools to 1.7.0.  ### Fixed  - Fixed a log-capture vulnerability where a crafted `bundleId` or custom subsystem filter could broaden simulator log streams to capture output from other apps or Apple system subsystems. Bundle IDs and subsystem filters are now validated against a strict allowlist before reaching the predicate ([#407](https://github.com/getsentry/XcodeBuildMCP/pull/407) by [@sebastiondev](https://g |
| `v2.5.0` | 2026-05-07 | High | ## Release v2.5.0  ### Breaking  #### Standalone log-capture tools removed  The old `logging` workflow and its standalone log-capture tools (`start_sim_log_cap`, `stop_sim_log_cap`, `start_device_log_cap`, `stop_device_log_cap`, and `launch_app_logs_sim`) have been removed. This affects users, scripts, and agents that call those tool names directly.  Use the launch or build-and-run tools instead. They return runtime log paths as part of the normal result, so agents no longer need a separate star |
| `v2.3.2` | 2026-03-31 | Medium | ## Release v2.3.2  ### Fixed  - Improved reliability of internal telemetry during shutdown ([#302](https://github.com/getsentry/XcodeBuildMCP/pull/302)).  ### Option A — Homebrew (no Node.js required)  Install: ```bash brew tap getsentry/xcodebuildmcp brew install xcodebuildmcp ```  MCP config: ```json "XcodeBuildMCP": {   "command": "xcodebuildmcp",   "args": ["mcp"] } ```  ### Option B — npm / npx (Node.js 18+)  Install: ```bash npm install -g xcodebuildmcp@latest ```  MCP config: ```json "Xco |
| `v2.3.1` | 2026-03-27 | Medium | ## Release v2.3.1  ### Fixed  - Fixed unnecessary tool confirmation prompts in MCP clients (such as Codex) that treat missing approval annotations as high-risk defaults ([#297](https://github.com/getsentry/XcodeBuildMCP/pull/297)).  ### Option A — Homebrew (no Node.js required)  Install: ```bash brew tap getsentry/xcodebuildmcp brew install xcodebuildmcp ```  MCP config: ```json "XcodeBuildMCP": {   "command": "xcodebuildmcp",   "args": ["mcp"] } ```  ### Option B — npm / npx (Node.js 18+)  Inst |
| `v2.3.0` | 2026-03-16 | Low | ## Release v2.3.0  ### Added  - Added environment variable support for session defaults (e.g. `XCODEBUILDMCP_WORKSPACE_PATH`, `XCODEBUILDMCP_SCHEME`, `XCODEBUILDMCP_PLATFORM`) so MCP clients can supply startup defaults in their config without a project config file ([#268](https://github.com/getsentry/XcodeBuildMCP/pull/268) by [@detailobsessed](https://github.com/detailobsessed)). See [docs/CONFIGURATION.md](docs/CONFIGURATION.md#environment-variables). - Added `--format mcp-json` flag to `xcode |
| `v2.2.1` | 2026-03-08 | Low | ## Release v2.2.1  - Fix AXe bundling issue.  ### Option A — Homebrew (no Node.js required)  Install: ```bash brew tap getsentry/xcodebuildmcp brew install xcodebuildmcp ```  MCP config: ```json "XcodeBuildMCP": {   "command": "xcodebuildmcp",   "args": ["mcp"] } ```  ### Option B — npm / npx (Node.js 18+)  Install: ```bash npm install -g xcodebuildmcp@latest ```  MCP config: ```json "XcodeBuildMCP": {   "command": "npx",   "args": ["-y", "xcodebuildmcp@latest", "mcp"] } ```  📦 **NPM Package**: |
| `v2.2.0` | 2026-03-07 | Low | ## Release v2.2.0  ### Added  - Added `get_coverage_report` and `get_file_coverage` tools for inspecting code coverage from test results — view per-target summaries or drill into function-level coverage and uncovered line ranges for specific files ([#240](https://github.com/getsentry/XcodeBuildMCP/pull/240) by [@irangareddy](https://github.com/irangareddy)). See [docs/TOOLS.md](docs/TOOLS.md). - Added a unified build-and-run command for physical devices, matching the existing simulator workflow |
| `v2.1.0` | 2026-02-23 | Low | ## Release v2.1.0  ### Added  - Added `xcodebuildmcp init` CLI command to install agent skills, replacing the standalone `install-skill.sh` script. Supports auto-detection of AI clients (Claude Code, Cursor, Codex), `--print` for unsupported clients, and `--uninstall` for removal. See [docs/SKILLS.md](docs/SKILLS.md#install). - Added namespaced session defaults profiles, letting you save and switch between different project/scheme/simulator configurations without reconfiguring each time. See [do |
| `v2.0.7` | 2026-02-10 | Low | ## Release v2.0.7  ### Changed  - XcodeBuildMCP has moved to the [getsentry](https://github.com/getsentry) GitHub organization. Homebrew users should switch to the new tap: `brew untap cameroncooke/xcodebuildmcp && brew tap getsentry/xcodebuildmcp`. npm and npx users are unaffected.  ### Option A — Homebrew (no Node.js required)  Install: ```bash brew tap getsentry/xcodebuildmcp brew install xcodebuildmcp ```  MCP config: ```json "XcodeBuildMCP": {   "command": "xcodebuildmcp",   "args": ["mcp"] |

## Dependency audit

- **Score**: 100/100
- **Total deps**: 29
- **Resolved**: 29
- **Unresolved**: 0
- **License conflicts**: 0
- **Warnings**: 0
- **Scanned**: 2026-05-11

## Citation

- HTML: https://www.freshcrate.ai/projects/XcodeBuildMCP
- Markdown: https://www.freshcrate.ai/projects/XcodeBuildMCP.md
- Dependencies JSON: https://www.freshcrate.ai/api/projects/XcodeBuildMCP/deps

_Generated by freshcrate.ai. Indexes github releases for AI-agent ecosystem packages._