XcodeBuild

Installation

TypingMindClaude DesktopCursorVS CodeClaude CodeGemini CLICodexWindsurf

TypingMind

Prerequisites:

Node.js 18+

Copy

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

Available Tools

• build_device

  Builds an app for a connected device.

• clean

  Cleans build products with xcodebuild.

• discover_projs

  Scans a directory (defaults to workspace root) to find Xcode project (.xcodeproj) and workspace (.xcworkspace) files.

• get_app_bundle_id

  Extracts the bundle identifier from an app bundle (.app) for any Apple platform (iOS, iPadOS, watchOS, tvOS, visionOS). IMPORTANT: You MUST provide the appPath parameter. Example: get_app_bundle_id({ appPath: '/path/to/your/app.app' })

• get_device_app_path

  Retrieves the built app path for a connected device.

• install_app_device

  Installs an app on a connected device.

• launch_app_device

  Launches an app on a connected device.

• list_devices

  Lists connected physical Apple devices (iPhone, iPad, Apple Watch, Apple TV, Apple Vision Pro) with their UUIDs, names, and connection status. Use this to discover physical devices for testing.

• list_schemes

  Lists schemes for a project or workspace.

• show_build_settings

  Shows xcodebuild build settings.

• start_device_log_cap

  Starts log capture on a connected device.

• stop_app_device

  Stops a running app on a connected device.

• stop_device_log_cap

  Stops an active Apple device log capture session and returns the captured logs.

• test_device

  Runs tests on a physical Apple device.

• doctor

  Provides comprehensive information about the MCP server environment, available dependencies, and configuration status.

• start_sim_log_cap

  Starts capturing logs from a specified simulator. Returns a session ID. By default, captures only structured logs.

• stop_sim_log_cap

  Stops an active simulator log capture session and returns the captured logs.

• build_macos

  Builds a macOS app.

• build_run_macos

  Builds and runs a macOS app.

• get_mac_app_path

  Retrieves the built macOS app bundle path.

• get_mac_bundle_id

  Extracts the bundle identifier from a macOS app bundle (.app). IMPORTANT: You MUST provide the appPath parameter. Example: get_mac_bundle_id({ appPath: '/path/to/your/app.app' }) Note: In some environments, this tool may be prefixed as mcp0_get_macos_bundle_id.

• launch_mac_app

  Launches a macOS application. IMPORTANT: You MUST provide the appPath parameter. Example: launch_mac_app({ appPath: '/path/to/your/app.app' }) Note: In some environments, this tool may be prefixed as mcp0_launch_macos_app.

• stop_mac_app

  Stops a running macOS application. Can stop by app name or process ID.

• test_macos

  Runs tests for a macOS target.

• scaffold_ios_project

  Scaffold a new iOS project from templates. Creates a modern Xcode project with workspace structure, SPM package for features, and proper iOS configuration.

• scaffold_macos_project

  Scaffold a new macOS project from templates. Creates a modern Xcode project with workspace structure, SPM package for features, and proper macOS configuration.

• boot_sim

  Boots an iOS simulator.

• build_run_sim

  Builds and runs an app on an iOS simulator.

• build_sim

  Builds an app for an iOS simulator.

• describe_ui

  Gets entire view hierarchy with precise frame coordinates (x, y, width, height) for all visible elements. Use this before UI interactions or after layout changes - do NOT guess coordinates from screenshots. Returns JSON tree with frame data for accurate automation.

• get_sim_app_path

  Retrieves the built app path for an iOS simulator.

• install_app_sim

  Installs an app in an iOS simulator.

• launch_app_logs_sim

  Launches an app in an iOS simulator and captures its logs.

• launch_app_sim

  Launches an app in an iOS simulator.

• list_sims

  Lists available iOS simulators with their UUIDs.

• open_sim

  Opens the iOS Simulator app.

• screenshot

  Captures screenshot for visual verification. For UI coordinates, use describe_ui instead (don't determine coordinates from screenshots).

• stop_app_sim

  Stops an app running in an iOS simulator.

• test_sim

  Runs tests on an iOS simulator.

• reset_sim_location

  Resets the simulator's location to default.

• set_sim_appearance

  Sets the appearance mode (dark/light) of an iOS simulator.

• set_sim_location

  Sets a custom GPS location for the simulator.

• sim_statusbar

  Sets the data network indicator in the iOS simulator status bar. Use "clear" to reset all overrides, or specify a network type (hide, wifi, 3g, 4g, lte, lte-a, lte+, 5g, 5g+, 5g-uwb, 5g-uc).

• swift_package_build

  Builds a Swift Package with swift build

• swift_package_clean

  Cleans Swift Package build artifacts and derived data

• swift_package_list

  Lists currently running Swift Package processes

• swift_package_run

  Runs an executable target from a Swift Package with swift run

• swift_package_stop

  Stops a running Swift Package executable started with swift_package_run

• swift_package_test

  Runs tests for a Swift Package with swift test

• button

  Press hardware button on iOS simulator. Supported buttons: apple-pay, home, lock, side-button, siri

• gesture

  Perform gesture on iOS simulator using preset gestures: scroll-up, scroll-down, scroll-left, scroll-right, swipe-from-left-edge, swipe-from-right-edge, swipe-from-top-edge, swipe-from-bottom-edge

• key_press

  Press a single key by keycode on the simulator. Common keycodes: 40=Return, 42=Backspace, 43=Tab, 44=Space, 58-67=F1-F10.

• key_sequence

  Press key sequence using HID keycodes on iOS simulator with configurable delay

• long_press

  Long press at specific coordinates for given duration (ms). Use describe_ui for precise coordinates (don't guess from screenshots).

• swipe

  Swipe from one point to another. Use describe_ui for precise coordinates (don't guess from screenshots). Supports configurable timing.

• tap

  Tap at specific coordinates or target elements by accessibility id or label. Use describe_ui to get precise element coordinates prior to using x/y parameters (don't guess from screenshots). Supports optional timing delays.

• touch

  Perform touch down/up events at specific coordinates. Use describe_ui for precise coordinates (don't guess from screenshots).

• type_text

  Type text (supports US keyboard characters). Use describe_ui to find text field, tap to focus, then type.

• session-clear-defaults

  Clear selected or all session defaults.

• session-set-defaults

  Set the session defaults needed by many tools. Most tools require one or more session defaults to be set before they can be used. Agents should set all relevant defaults up front in a single call (e.g., project/workspace, scheme, simulator or device ID, useLatestOS) to avoid iterative prompts; only set the keys your workflow needs.

• session-show-defaults

  Show current session defaults.

• record_sim_video

  Starts or stops video capture for an iOS simulator.

• erase_sims

  Erases a simulator by UDID.