- Run the doctor tool and include output when filing issues.
- Confirm Xcode and Command Line Tools are installed.
- Verify required workflows are enabled in configuration.
- Check simulator/device availability and permissions.
The doctor tool checks system configuration and reports on all dependencies required by XcodeBuildMCP.
npx --package xcodebuildmcp@latest xcodebuildmcp-doctorIt reports on:
- System and Node.js environment
- Xcode installation and configuration
- Required dependencies (xcodebuild, AXe, etc.)
- Environment variables affecting XcodeBuildMCP
- Feature availability status
Note
You can also ask you agent to run the doctor tool which will provide a more representative output.
Some clients have short tool timeouts. If you see timeouts, increase the client timeout (for example, tool_timeout_sec = 600 in Codex).
If tools do not appear, verify XCODEBUILDMCP_ENABLED_WORKFLOWS includes the required workflow groups.
- Configuration options: CONFIGURATION.md
- Tools reference: TOOLS.md
- Privacy and telemetry: PRIVACY.md