# getsentry/XcodeBuildMCP

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

Repository: https://github.com/getsentry/XcodeBuildMCP
Canonical: https://ross.abutalabs.com/products/xcodebuildmcp
Homepage: https://www.xcodebuildmcp.com
Language: TypeScript
License: MIT
License Family: permissive
Topics: mcp, mcp-server, model-context-protocol, model-context-protocol-servers, xcode, xcodebuild, tag-non-production
Last push: 2026-08-12T20:00:35+00:00

## Health v2 (maintenance only)
Score: 84/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 97, release rhythm 94, longevity 38
- inputs: {"age_days": 542, "days_push": 21, "days_rel": 41, "gap_med": 1, "n_releases_24m": 52}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 6289, forks 314 (observed 2026-08-28T04:09:41.342478+00:00)

## What it is
XcodeBuildMCP is a Model Context Protocol (MCP) server and CLI that exposes up to 82 tools for building, testing, debugging, and deploying iOS, macOS, watchOS, tvOS, and visionOS apps via AI coding agents. It wraps xcodebuild, simulators, physical devices, LLDB debugging, and UI automation behind agent-friendly tools and workflows.

## Use cases
- let AI agents build and fix iOS Xcode projects autonomously
- run Xcode tests and capture code coverage from an agent
- debug iOS apps with LLDB breakpoints via Claude Code or Cursor
- boot and manage iOS simulators and capture screenshots or video
- deploy and test apps on physical iPhones over USB or Wi-Fi
- automate simulator UI taps and gestures for testing
- script Xcode build workflows in CI pipelines

## When to choose
- you use AI coding agents (Cursor, Claude Code, VS Code, Windsurf) on iOS or macOS projects
- you want agents to build, test, debug, and deploy Apple-platform apps end to end
- you need both an MCP server and a standalone CLI for scripting and CI

## When to avoid
- you develop on Linux or Windows - it shells out to Apple tools and is macOS-only
- you need Xcode versions older than 16
- you don't use AI agents or MCP-compatible clients and only need plain xcodebuild scripting

## Facets
- artifact type: service
- maturity: active
- function: mcp, developer-tools, cli, testing, workflow-automation
- domain: developer-tools, mobile-development, desktop-applications
- platform: cli
- tags: xcode, ios, macos, simulator, lldb, swift-package-manager, ui-automation, mcp-server, ai-coding-agents, ai-agents, automation, nodejs, docker

## Member repositories
- getsentry/XcodeBuildMCP (main) score 84

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:09:41.342478+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-29T17:46:18.426281+00:00, confidence not recorded.
  - readme: https://github.com/getsentry/XcodeBuildMCP (fetched 2026-08-28T04:09:41.342478+00:00, sha a680021a491a)
  - homepage: https://www.xcodebuildmcp.com (fetched 2026-08-29T08:43:10.408465+00:00, sha 06ce6591828d)
  - site_page: https://www.xcodebuildmcp.com/docs (fetched 2026-08-29T08:43:10.411821+00:00, sha 35f6b98562d5)
  - site_page: https://www.xcodebuildmcp.com/docs/contributing (fetched 2026-08-29T08:43:10.414313+00:00, sha e3e00e31f56b)
  - registry_npm: https://registry.npmjs.org/xcodebuildmcp (fetched 2026-08-29T08:43:10.416453+00:00, sha 60883432d010)
- Data as of 2026-08-30T08:39:29.467469+00:00.