build_run_ios_sim_id_ws

Build and run iOS apps on a specified simulator using workspace path, scheme, and simulator UUID. Supports custom configurations, derived data paths, and additional xcodebuild arguments.

Instructions

Builds and runs an iOS app from a workspace on a simulator specified by UUID. IMPORTANT: Requires workspacePath, scheme, and simulatorId. Example: build_run_ios_sim_id_ws({ workspacePath: '/path/to/workspace', scheme: 'MyScheme', simulatorId: 'SIMULATOR_UUID' })

Input Schema

Name	Required	Description
`configuration`	No	Build configuration (Debug, Release, etc.)
`derivedDataPath`	No	Path where build products and other derived data will go
`extraArgs`	No	Additional xcodebuild arguments
`preferXcodebuild`	No	If true, prefers xcodebuild over the experimental incremental build system, useful for when incremental build system fails.
`scheme`	Yes	The scheme to use (Required)
`simulatorId`	Yes	UUID of the simulator to use (obtained from listSimulators) (Required)
`useLatestOS`	No	Whether to use the latest OS version for the named simulator
`workspacePath`	Yes	Path to the .xcworkspace file (Required)

Input Schema (JSON Schema)

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false,
  "properties": {
    "configuration": {
      "description": "Build configuration (Debug, Release, etc.)",
      "type": "string"
    },
    "derivedDataPath": {
      "description": "Path where build products and other derived data will go",
      "type": "string"
    },
    "extraArgs": {
      "description": "Additional xcodebuild arguments",
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "preferXcodebuild": {
      "description": "If true, prefers xcodebuild over the experimental incremental build system, useful for when incremental build system fails.",
      "type": "boolean"
    },
    "scheme": {
      "description": "The scheme to use (Required)",
      "type": "string"
    },
    "simulatorId": {
      "description": "UUID of the simulator to use (obtained from listSimulators) (Required)",
      "type": "string"
    },
    "useLatestOS": {
      "description": "Whether to use the latest OS version for the named simulator",
      "type": "boolean"
    },
    "workspacePath": {
      "description": "Path to the .xcworkspace file (Required)",
      "type": "string"
    }
  },
  "required": [
    "workspacePath",
    "scheme",
    "simulatorId"
  ],
  "type": "object"
}

XcodeBuildMCP

build_run_ios_sim_id_ws

Instructions

Input Schema

Input Schema (JSON Schema)

Other Tools from XcodeBuildMCP

Related Tools

MCP directory API