XcodeBuildMCP

# XcodeBuildMCP CLI Tools Reference This document lists CLI tool names as exposed by `xcodebuildmcp <workflow> <tool>`. XcodeBuildMCP provides 71 canonical tools organized into 13 workflow groups. ## Workflow Groups ### Build Utilities (`utilities`) **Purpose**: Utility tools for cleaning build products and managing build artifacts. (1 tools) - `clean` - Defined in iOS Device Development workflow. ### iOS Device Development (`device`) **Purpose**: Complete iOS development workflow for physical devices (iPhone, iPad, Apple Watch, Apple TV, Apple Vision Pro). (14 tools) - `build` - Build for device. - `clean` - Clean build products. - `discover-projects` - Scans a directory (defaults to workspace root) to find Xcode project (.xcodeproj) and workspace (.xcworkspace) files. - `get-app-bundle-id` - Extract bundle id from .app. - `get-app-path` - Get device built app path. - `install` - Install app on device. - `launch` - Launch app on device. - `list` - List connected devices. - `list-schemes` - List Xcode schemes. - `show-build-settings` - Show build settings. - `start-device-log-capture` - Start device log capture. - `stop` - Stop device app. - `stop-device-log-capture` - Stop device app and return logs. - `test` - Test on device. ### iOS Simulator Development (`simulator`) **Purpose**: Complete iOS development workflow for both .xcodeproj and .xcworkspace files targeting simulators. (21 tools) - `boot` - Defined in Simulator Management workflow. - `build` - Build for iOS sim. - `build-and-run` - Build and run iOS sim. - `clean` - Defined in iOS Device Development workflow. - `discover-projects` - Defined in iOS Device Development workflow. - `get-app-bundle-id` - Defined in iOS Device Development workflow. - `get-app-path` - Get sim built app path. - `install` - Install app on sim. - `launch-app` - Launch app on simulator. - `launch-app-with-logs` - Launch sim app with logs. - `list` - Defined in Simulator Management workflow. - `list-schemes` - Defined in iOS Device Development workflow. - `open` - Defined in Simulator Management workflow. - `record-video` - Record sim video. - `screenshot` - Capture screenshot. - `show-build-settings` - Defined in iOS Device Development workflow. - `snapshot-ui` - Print view hierarchy with precise view coordinates (x, y, width, height) for visible elements. - `start-simulator-log-capture` - Defined in Log Capture workflow. - `stop` - Stop sim app. - `stop-simulator-log-capture` - Defined in Log Capture workflow. - `test` - Test on iOS sim. ### LLDB Debugging (`debugging`) **Purpose**: Attach LLDB debugger to simulator apps, set breakpoints, inspect variables and call stacks. (8 tools) - `add-breakpoint` - Add breakpoint. - `attach` - Attach LLDB to sim app. - `continue` - Continue debug session. - `detach` - Detach debugger. - `lldb-command` - Run LLDB command. - `remove-breakpoint` - Remove breakpoint. - `stack` - Get backtrace. - `variables` - Get frame variables. ### Log Capture (`logging`) **Purpose**: Capture and retrieve logs from simulator and device apps. (4 tools) - `start-device-log-capture` - Defined in iOS Device Development workflow. - `start-simulator-log-capture` - Start sim log capture. - `stop-device-log-capture` - Defined in iOS Device Development workflow. - `stop-simulator-log-capture` - Stop sim app and return logs. ### macOS Development (`macos`) **Purpose**: Complete macOS development workflow for both .xcodeproj and .xcworkspace files. Build, test, deploy, and manage macOS applications. (11 tools) - `build` - Build macOS app. - `build-and-run` - Build and run macOS app. - `clean` - Defined in iOS Device Development workflow. - `discover-projects` - Defined in iOS Device Development workflow. - `get-app-path` - Get macOS built app path. - `get-macos-bundle-id` - Extract bundle id from macOS .app. - `launch` - Launch macOS app. - `list-schemes` - Defined in iOS Device Development workflow. - `show-build-settings` - Defined in iOS Device Development workflow. - `stop` - Stop macOS app. - `test` - Test macOS target. ### MCP Doctor (`doctor`) **Purpose**: Diagnostic tool providing comprehensive information about the MCP server environment, dependencies, and configuration. (1 tools) - `doctor` - MCP environment info. ### Project Discovery (`project-discovery`) **Purpose**: Discover and examine Xcode projects, workspaces, and Swift packages. Analyze project structure, schemes, build settings, and bundle information. (5 tools) - `discover-projects` - Defined in iOS Device Development workflow. - `get-app-bundle-id` - Defined in iOS Device Development workflow. - `get-macos-bundle-id` - Defined in macOS Development workflow. - `list-schemes` - Defined in iOS Device Development workflow. - `show-build-settings` - Defined in iOS Device Development workflow. ### Project Scaffolding (`project-scaffolding`) **Purpose**: Scaffold new iOS and macOS projects from templates. (2 tools) - `scaffold-ios` - Scaffold iOS project. - `scaffold-macos` - Scaffold macOS project. ### Simulator Management (`simulator-management`) **Purpose**: Tools for managing simulators from booting, opening simulators, listing simulators, stopping simulators, erasing simulator content and settings, and setting simulator environment options like location, network, statusbar and appearance. (8 tools) - `boot` - Boot iOS simulator. - `erase` - Erase simulator. - `list` - List iOS simulators. - `open` - Open Simulator app. - `reset-location` - Reset sim location. - `set-appearance` - Set sim appearance. - `set-location` - Set sim location. - `statusbar` - Set sim status bar network. ### Swift Package Development (`swift-package`) **Purpose**: Build, test, run and manage Swift Package Manager projects. (6 tools) - `build` - swift package target build. - `clean` - swift package clean. - `list` - List SwiftPM processes. - `run` - swift package target run. - `stop` - Stop SwiftPM run. - `test` - Run swift package target tests. ### UI Automation (`ui-automation`) **Purpose**: UI automation and accessibility testing tools for iOS simulators. Perform gestures, interactions, screenshots, and UI analysis for automated testing workflows. (11 tools) - `button` - Press simulator hardware button. - `gesture` - Simulator gesture preset. - `key-press` - Press key by keycode. - `key-sequence` - Press a sequence of keys by their keycodes. - `long-press` - Long press at coords. - `screenshot` - Defined in iOS Simulator Development workflow. - `snapshot-ui` - Defined in iOS Simulator Development workflow. - `swipe` - Swipe between points. - `tap` - Tap coordinate or element. - `touch` - Touch down/up at coords. - `type-text` - Type text. ### Xcode IDE Integration (`xcode-ide`) **Purpose**: Bridge tools for connecting to Xcode's built-in MCP server (mcpbridge) to access IDE-specific functionality. (3 tools) - `bridge-disconnect` - Disconnect bridge and unregister proxied `xcode_tools_*` tools. - `bridge-status` - Show xcrun mcpbridge availability and proxy tool sync status. - `bridge-sync` - One-shot connect + tools/list sync (manual retry; avoids background prompt spam). ## Summary Statistics - **Canonical Tools**: 71 - **Total Tools**: 95 - **Workflow Groups**: 13 --- *This documentation is automatically generated by `scripts/update-tools-docs.ts` from the tools manifest. Last updated: 2026-02-07T22:29:44.282Z UTC*