Skip to content

Release v2.3.0

Latest

Choose a tag to compare

@github-actions github-actions released this 16 Mar 22:11

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:

brew tap getsentry/xcodebuildmcp
brew install xcodebuildmcp

MCP config:

"XcodeBuildMCP": {
  "command": "xcodebuildmcp",
  "args": ["mcp"]
}

Option B — npm / npx (Node.js 18+)

Install:

npm install -g xcodebuildmcp@latest

MCP config:

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

📦 NPM Package: https://www.npmjs.com/package/xcodebuildmcp/v/2.3.0