build_run_ios_sim_id_proj

Build and run an iOS app from a specified project file on a designated simulator using UUID. Requires projectPath, scheme, and simulatorId for execution.

Instructions

Builds and runs an iOS app from a project file on a simulator specified by UUID. IMPORTANT: Requires projectPath, scheme, and simulatorId. Example: build_run_ios_sim_id_proj({ projectPath: '/path/to/project.xcodeproj', 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.
`projectPath`	Yes	Path to the .xcodeproj file (Required)
`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

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"
    },
    "projectPath": {
      "description": "Path to the .xcodeproj file (Required)",
      "type": "string"
    },
    "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"
    }
  },
  "required": [
    "projectPath",
    "scheme",
    "simulatorId"
  ],
  "type": "object"
}

XcodeBuildMCP

build_run_ios_sim_id_proj

Instructions

Input Schema

Input Schema (JSON Schema)

Other Tools from XcodeBuildMCP

Related Tools

MCP directory API