Skip to content

Latest commit

 

History

History
190 lines (131 loc) · 7.23 KB

File metadata and controls

190 lines (131 loc) · 7.23 KB

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-08T12:09:33.648Z UTC