Download Latest Version xcodebuildmcp-2.3.2-darwin-arm64.tar.gz (62.9 MB)
Email in envelope

Get an email when there's a new version of XcodeBuildMCP

Home / v2.3.0
Name Modified Size InfoDownloads / Week
Parent folder
xcodebuildmcp-2.3.0-darwin-arm64.tar.gz 2026-03-16 62.9 MB
xcodebuildmcp-2.3.0-darwin-arm64.tar.gz.sha256 2026-03-16 65 Bytes
xcodebuildmcp-2.3.0-darwin-universal.tar.gz 2026-03-16 102.4 MB
xcodebuildmcp-2.3.0-darwin-universal.tar.gz.sha256 2026-03-16 65 Bytes
xcodebuildmcp-2.3.0-darwin-x64.tar.gz 2026-03-16 64.1 MB
xcodebuildmcp-2.3.0-darwin-x64.tar.gz.sha256 2026-03-16 65 Bytes
xcodebuildmcp-2.3.0.tgz 2026-03-16 4.2 MB
README.md 2026-03-16 2.3 kB
Release v2.3.0 source code.tar.gz 2026-03-16 3.1 MB
Release v2.3.0 source code.zip 2026-03-16 3.4 MB
Totals: 10 Items   240.1 MB 0

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 by @detailobsessed). See docs/CONFIGURATION.md.
  • Added --format mcp-json flag to xcodebuildmcp setup that exports an env-based MCP client config block instead of writing config.yaml (#268 by @detailobsessed).

Changed

  • Clarified configuration layering: session_set_defaults overrides config.yaml, which overrides environment variables. See docs/CONFIGURATION.md (#268 by @detailobsessed).
  • Improved xcodebuildmcp setup reliability when optional targets (like physical devices) are unavailable.

Fixed

  • Fixed .xcodebuildmcp/config.yaml being modified on startup when simulator metadata was refreshed (#230).
  • Fixed orphaned MCP server processes that could remain running after the client disconnects (#273).
  • Fixed list-schemes CLI command missing --project-path and --workspace-path flags (#271).
  • Fixed Xcode IDE workflow tools not working when invoked from the CLI.
  • Fixed Swift Package tools not properly waiting for process exit when stopping.

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: https://www.npmjs.com/package/xcodebuildmcp/v/2.3.0

Source: README.md, updated 2026-03-16