get_sim_app_path_id_proj

Retrieve the app bundle path for a specific simulator using a project file by providing projectPath, scheme, platform, and simulatorId. Essential for Xcode development workflows on iOS, watchOS, tvOS, or visionOS simulators.

Instructions

Gets the app bundle path for a simulator by UUID using a project file. IMPORTANT: Requires projectPath, scheme, platform, and simulatorId. Example: get_sim_app_path_id_proj({ projectPath: '/path/to/project.xcodeproj', scheme: 'MyScheme', platform: 'iOS Simulator', simulatorId: 'SIMULATOR_UUID' })

Input Schema

Name	Required	Description
`arch`	No	Architecture
`configuration`	No	Build configuration (Debug, Release, etc.)
`platform`	Yes	The target simulator platform (Required)
`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)
`simulatorName`	No	Name of the simulator
`useLatestOS`	No	Whether to use the latest OS version for the named simulator
`workspacePath`	No	Path to the .xcworkspace file

Input Schema (JSON Schema)

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false,
  "properties": {
    "arch": {
      "description": "Architecture",
      "type": "string"
    },
    "configuration": {
      "description": "Build configuration (Debug, Release, etc.)",
      "type": "string"
    },
    "platform": {
      "description": "The target simulator platform (Required)",
      "enum": [
        "iOS Simulator",
        "watchOS Simulator",
        "tvOS Simulator",
        "visionOS Simulator"
      ],
      "type": "string"
    },
    "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"
    },
    "simulatorName": {
      "description": "Name of the simulator",
      "type": "string"
    },
    "useLatestOS": {
      "description": "Whether to use the latest OS version for the named simulator",
      "type": "boolean"
    },
    "workspacePath": {
      "description": "Path to the .xcworkspace file",
      "type": "string"
    }
  },
  "required": [
    "projectPath",
    "scheme",
    "platform",
    "simulatorId"
  ],
  "type": "object"
}

XcodeBuildMCP