get_sim_app_path_name_proj

Retrieve the app bundle path for a specific simulator using a project file by providing projectPath, scheme, platform, and simulatorName arguments, ensuring precise targeting for iOS, watchOS, tvOS, or visionOS simulators.

Instructions

Gets the app bundle path for a simulator by name using a project file. IMPORTANT: Requires projectPath, scheme, platform, and simulatorName. Example: get_sim_app_path_name_proj({ projectPath: '/path/to/project.xcodeproj', scheme: 'MyScheme', platform: 'iOS Simulator', simulatorName: 'iPhone 16' })

Input Schema

Name	Required	Description
`arch`	No	Architecture
`configuration`	No	Build configuration (Debug, Release, etc.)
`platform`	Yes	Target simulator platform (Required)
`projectPath`	Yes	Path to the .xcodeproj file (Required)
`scheme`	Yes	The scheme to use (Required)
`simulatorId`	No	UUID of the simulator
`simulatorName`	Yes	Name of the simulator to use (e.g., 'iPhone 16') (Required)
`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": "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",
      "type": "string"
    },
    "simulatorName": {
      "description": "Name of the simulator to use (e.g., 'iPhone 16') (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",
      "type": "string"
    }
  },
  "required": [
    "projectPath",
    "scheme",
    "platform",
    "simulatorName"
  ],
  "type": "object"
}

XcodeBuildMCP