test_device_ws

Executes tests on Apple devices (iPhone, iPad, Apple Watch, Apple TV, Apple Vision Pro) using xcodebuild, parses xcresult output, and requires workspacePath, scheme, and deviceId for integration.

Instructions

Runs tests for an Apple workspace on a physical device (iPhone, iPad, Apple Watch, Apple TV, Apple Vision Pro) using xcodebuild test and parses xcresult output. IMPORTANT: Requires workspacePath, scheme, and deviceId.

Input Schema

Name	Required	Description
`configuration`	No	Build configuration (Debug, Release, etc.)
`derivedDataPath`	No	Path where build products and other derived data will go
`deviceId`	Yes	UDID of the device (obtained from list_devices)
`extraArgs`	No	Additional xcodebuild arguments
`platform`	No	Target platform (defaults to iOS)
`preferXcodebuild`	No	If true, prefers xcodebuild over the experimental incremental build system
`scheme`	Yes	The scheme to use (Required)
`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"
    },
    "deviceId": {
      "description": "UDID of the device (obtained from list_devices)",
      "type": "string"
    },
    "extraArgs": {
      "description": "Additional xcodebuild arguments",
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "platform": {
      "description": "Target platform (defaults to iOS)",
      "enum": [
        "iOS",
        "watchOS",
        "tvOS",
        "visionOS"
      ],
      "type": "string"
    },
    "preferXcodebuild": {
      "description": "If true, prefers xcodebuild over the experimental incremental build system",
      "type": "boolean"
    },
    "scheme": {
      "description": "The scheme to use (Required)",
      "type": "string"
    },
    "workspacePath": {
      "description": "Path to the .xcworkspace file (Required)",
      "type": "string"
    }
  },
  "required": [
    "workspacePath",
    "scheme",
    "deviceId"
  ],
  "type": "object"
}

XcodeBuildMCP

test_device_ws

Instructions

Input Schema

Input Schema (JSON Schema)

Other Tools from XcodeBuildMCP

Related Tools

MCP directory API