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-jsonflag toxcodebuildmcp setupthat exports an env-based MCP client config block instead of writingconfig.yaml(#268 by @detailobsessed).
Changed
- Clarified configuration layering:
session_set_defaultsoverridesconfig.yaml, which overrides environment variables. See docs/CONFIGURATION.md (#268 by @detailobsessed). - Improved
xcodebuildmcp setupreliability when optional targets (like physical devices) are unavailable.
Fixed
- Fixed
.xcodebuildmcp/config.yamlbeing 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-schemesCLI command missing--project-pathand--workspace-pathflags (#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 xcodebuildmcpMCP config:
"XcodeBuildMCP": {
"command": "xcodebuildmcp",
"args": ["mcp"]
}Option B — npm / npx (Node.js 18+)
Install:
npm install -g xcodebuildmcp@latestMCP config:
"XcodeBuildMCP": {
"command": "npx",
"args": ["-y", "xcodebuildmcp@latest", "mcp"]
}📦 NPM Package: https://www.npmjs.com/package/xcodebuildmcp/v/2.3.0