# io.github.cameroncooke/XcodeBuildMCP (npm · xcodebuildmcp)

XcodeBuildMCP provides tools for Xcode project management, simulator management, and app utilities.

- Trust score: 55/100 (low)
- Change this week: +19
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-08-03

## Components

- npm · `xcodebuildmcp`: 55/100 (this document), [markdown](https://verifymcp.io/servers/cameroncooke-xcodebuildmcp/xcodebuildmcp.md), [page](https://verifymcp.io/servers/cameroncooke-xcodebuildmcp/xcodebuildmcp)

## Channel facts

- Registry: `npm`
- Package: `xcodebuildmcp`
- Version: `1.12.8`
- Transport: `stdio`

## Trust breakdown

How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-08-03.

- **Supply Chain Security**: 87/100
  - No malware found by supply-chain analysis.
  - Only part of the dependency tree could be resolved (138 of 142), so this covers what we could see, not the whole tree.
  - No install/post-install scripts declared.
  - Only part of the dependency tree could be resolved (138 of 142), so this covers what we could see, not the whole tree.
- **Provenance & Transparency**: 19/100
  - Repository check failed: the declared repository URL redirects; it must resolve directly.
  - Provenance check failed: no build-provenance attestation is published.
  - Clear OSI-approved license (MIT).
  - Actively maintained (last published 10 days ago).
  - Disclosure check failed: no security disclosure policy was found in the source repository.
- **Schema Quality & AI Usability**: 42/100
  - 0% of prompts and resources have a non-trivial description (not blank, and not just the item's name).
  - AI-judged instruction clarity (good).
  - Context-footprint check failed: tool/resource definitions use about 7005 tokens (~114/item across 61 items; 58 tools + 3 resources), over budget; trim descriptions and params.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 27/100
  - Stability observed for 8 of 30 days with no destabilising changes; credit accrues until the full window elapses.
- **Tool Coverage**: 95/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 84% of tool parameters carry a description.
- **Capabilities**: 60/100
  - Spec-recency check failed: implements MCP spec 2025-06-18; the latest is 2026-07-28.

## Install

### Claude

```bash
claude mcp add cameroncooke-xcodebuildmcp -- npx -y xcodebuildmcp
```

### Codex

```bash
codex mcp add cameroncooke-xcodebuildmcp -- npx -y xcodebuildmcp
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "cameroncooke-xcodebuildmcp": {
      "type": "local",
      "command": [
        "npx",
        "-y",
        "xcodebuildmcp"
      ],
      "enabled": true
    }
  }
}
```

### OpenClaw

```bash
openclaw mcp add cameroncooke-xcodebuildmcp --command npx --arg -y --arg xcodebuildmcp
```

### Hermes

```yaml
mcp_servers:
  cameroncooke-xcodebuildmcp:
    command: "npx"
    args: ["-y", "xcodebuildmcp"]
```

### Other

```json
{
  "mcpServers": {
    "cameroncooke-xcodebuildmcp": {
      "command": "npx",
      "args": [
        "-y",
        "xcodebuildmcp"
      ]
    }
  }
}
```

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-08-03 (score 55, +1)

No change was recorded against any check on this day. Stability & Change Management went from 23 to 27. That category is still filling its 30-day observation window: 7 days of observed history at the previous scan, 8 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-08-02 (score 54, +41)

- [security regression] Provenance: unverified → fail
- [security improvement] Install scripts: unverified → pass
- [security improvement] Known CVEs: unverified → partial
- [security improvement] Malware scan: unverified → pass
- [functional regression] MCP protocol: unverified → fail
- [functional regression] Tool coverage: 100 → unverified
- [functional regression] Schema quality: 0 → unverified
- [functional improvement] License: unverified → pass
- [functional improvement] Dependency health: unverified → partial
- [functional improvement] Maintenance: unverified → pass
- [functional improvement] Stability: unverified → 0.23
- [functional improvement] Schema quality: unverified → good
- [functional] Licence: MIT

### 2026-07-31 (score 13, −23)

- [functional] We updated how we score, so this day's move reflects our rubric, not a change to the server

### 2026-07-30 (score 36, +18)

- [functional improvement] Tool coverage: unverified → 100
- [functional improvement] Schema quality: unverified → 0

### 2026-07-28 (score 18, −18)

- [functional regression] Tool coverage: 100 → unverified
- [functional regression] Schema quality: 0 → unverified

### 2026-07-27 (score 36)

First indexed and scored.

## MCP tools (58)

### `build_device` (~158 tokens)

Builds an app from a project or workspace for a physical Apple device. Provide exactly one of projectPath or workspacePath. Example: build_device({ projectPath: '/path/to/MyProject.xcodeproj', scheme: 'MyScheme' })

Input parameters:

- `configuration` (string): Build configuration (Debug, Release)
- `derivedDataPath` (string): Path to derived data directory
- `extraArgs` (array): Additional arguments to pass to xcodebuild
- `preferXcodebuild` (boolean): Prefer xcodebuild over faster alternatives
- `projectPath` (string): Path to the .xcodeproj file
- `scheme` (string, required): The scheme to build
- `workspacePath` (string): Path to the .xcworkspace file

### `clean` (~247 tokens)

Cleans build products for either a project or a workspace using xcodebuild. Provide exactly one of projectPath or workspacePath. Platform defaults to iOS if not specified. Example: clean({ projectPath: '/path/to/MyProject.xcodeproj', scheme: 'MyScheme', platform: 'iOS' })

Input parameters:

- `configuration` (string): Optional: Build configuration to clean (Debug, Release, etc.)
- `derivedDataPath` (string): Optional: Path where derived data might be located
- `extraArgs` (array): Additional xcodebuild arguments
- `platform` (string): Optional: Platform to clean for (defaults to iOS). Choose from macOS, iOS, iOS Simulator, watchOS, watchOS Simulator, tvOS, tvOS Simulator, visionOS, visionOS Simulator
- `preferXcodebuild` (boolean): If true, prefers xcodebuild over the experimental incremental build system, useful for when incremental build system fails.
- `projectPath` (string): Path to the .xcodeproj file
- `scheme` (string): Optional: The scheme to clean
- `workspacePath` (string): Path to the .xcworkspace file

### `discover_projs` (~97 tokens)

Scans a directory (defaults to workspace root) to find Xcode project (.xcodeproj) and workspace (.xcworkspace) files.

Input parameters:

- `maxDepth` (integer): Optional: Maximum directory depth to scan. Defaults to 5.
- `scanPath` (string): Optional: Path relative to workspace root to scan. Defaults to workspace root.
- `workspaceRoot` (string, required): The absolute path of the workspace root to scan within.

### `get_app_bundle_id` (~99 tokens)

Extracts the bundle identifier from an app bundle (.app) for any Apple platform (iOS, iPadOS, watchOS, tvOS, visionOS). IMPORTANT: You MUST provide the appPath parameter. Example: get_app_bundle_id({ appPath: '/path/to/your/app.app' })

Input parameters:

- `appPath` (string, required): Path to the .app bundle to extract bundle ID from (full path to the .app directory)

### `get_device_app_path` (~146 tokens)

Gets the app bundle path for a physical device application (iOS, watchOS, tvOS, visionOS) using either a project or workspace. Provide exactly one of projectPath or workspacePath. Example: get_device_app_path({ projectPath: '/path/to/project.xcodeproj', scheme: 'MyScheme' })

Input parameters:

- `configuration` (string): Build configuration (Debug, Release, etc.)
- `platform` (string): Target platform (defaults to iOS)
- `projectPath` (string): Path to the .xcodeproj file
- `scheme` (string, required): The scheme to use
- `workspacePath` (string): Path to the .xcworkspace file

### `install_app_device` (~85 tokens)

Installs an app on a physical Apple device (iPhone, iPad, Apple Watch, Apple TV, Apple Vision Pro). Requires deviceId and appPath.

Input parameters:

- `appPath` (string, required): Path to the .app bundle to install (full path to the .app directory)
- `deviceId` (string, required): UDID of the device (obtained from list_devices)

### `launch_app_device` (~85 tokens)

Launches an app on a physical Apple device (iPhone, iPad, Apple Watch, Apple TV, Apple Vision Pro). Requires deviceId and bundleId.

Input parameters:

- `bundleId` (string, required): Bundle identifier of the app to launch (e.g., "com.example.MyApp")
- `deviceId` (string, required): UDID of the device (obtained from list_devices)

### `list_devices` (~50 tokens)

Lists connected physical Apple devices (iPhone, iPad, Apple Watch, Apple TV, Apple Vision Pro) with their UUIDs, names, and connection status. Use this to discover physical devices for testing.

### `list_schemes` (~82 tokens)

Lists available schemes for either a project or a workspace. Provide exactly one of projectPath or workspacePath. Example: list_schemes({ projectPath: '/path/to/MyProject.xcodeproj' })

Input parameters:

- `projectPath` (string): Path to the .xcodeproj file
- `workspacePath` (string): Path to the .xcworkspace file

### `show_build_settings` (~108 tokens)

Shows build settings from either a project or workspace using xcodebuild. Provide exactly one of projectPath or workspacePath, plus scheme. Example: show_build_settings({ projectPath: '/path/to/MyProject.xcodeproj', scheme: 'MyScheme' })

Input parameters:

- `projectPath` (string): Path to the .xcodeproj file
- `scheme` (string, required): Scheme name to show build settings for (Required)
- `workspacePath` (string): Path to the .xcworkspace file

### `start_device_log_cap` (~86 tokens)

Starts capturing logs from a specified Apple device (iPhone, iPad, Apple Watch, Apple TV, Apple Vision Pro) by launching the app with console output. Returns a session ID.

Input parameters:

- `bundleId` (string, required): Bundle identifier of the app to launch and capture logs for.
- `deviceId` (string, required): UDID of the device (obtained from list_devices)

### `stop_app_device` (~79 tokens)

Stops an app running on a physical Apple device (iPhone, iPad, Apple Watch, Apple TV, Apple Vision Pro). Requires deviceId and processId.

Input parameters:

- `deviceId` (string, required): UDID of the device (obtained from list_devices)
- `processId` (number, required): Process ID (PID) of the app to stop

### `stop_device_log_cap` (~42 tokens)

Stops an active Apple device log capture session and returns the captured logs.

Input parameters:

- `logSessionId` (string, required): The session ID returned by start_device_log_cap.

### `test_device` (~258 tokens)

Runs tests for an Apple project or workspace on a physical device (iPhone, iPad, Apple Watch, Apple TV, Apple Vision Pro) using xcodebuild test and parses xcresult output. Provide exactly one of projectPath or workspacePath. IMPORTANT: Requires scheme and deviceId. Example: test_device({ projectPath: "/path/to/MyProject.xcodeproj", scheme: "MyScheme", deviceId: "device-uuid" })

Input parameters:

- `configuration` (string): Build configuration (Debug, Release)
- `derivedDataPath` (string): Path to derived data directory
- `deviceId` (string, required): UDID of the device (obtained from list_devices)
- `extraArgs` (array): Additional arguments to pass to xcodebuild
- `platform` (string): Target platform (defaults to iOS)
- `preferXcodebuild` (boolean): Prefer xcodebuild over faster alternatives
- `projectPath` (string): Path to the .xcodeproj file
- `scheme` (string, required): The scheme to test
- `testRunnerEnv` (object): Environment variables to pass to the test runner (TEST_RUNNER_ prefix added automatically)
- `workspacePath` (string): Path to the .xcworkspace file

### `doctor` (~38 tokens)

Provides comprehensive information about the MCP server environment, available dependencies, and configuration status.

Input parameters:

- `enabled` (boolean): Optional: dummy parameter to satisfy MCP protocol

### `start_sim_log_cap` (~89 tokens)

Starts capturing logs from a specified simulator. Returns a session ID. By default, captures only structured logs.

Input parameters:

- `bundleId` (string, required): Bundle identifier of the app to capture logs for.
- `captureConsole` (boolean): Whether to capture console output (requires app relaunch).
- `simulatorUuid` (string, required): UUID of the simulator to capture logs from (obtained from list_simulators).

### `stop_sim_log_cap` (~41 tokens)

Stops an active simulator log capture session and returns the captured logs.

Input parameters:

- `logSessionId` (string, required): The session ID returned by start_sim_log_cap.

### `build_macos` (~195 tokens)

Builds a macOS app using xcodebuild from a project or workspace. Provide exactly one of projectPath or workspacePath. Example: build_macos({ projectPath: '/path/to/MyProject.xcodeproj', scheme: 'MyScheme' })

Input parameters:

- `arch` (string): Architecture to build for (arm64 or x86_64). For macOS only.
- `configuration` (string): Build configuration (Debug, Release, etc.)
- `derivedDataPath` (string): Path where build products and other derived data will go
- `extraArgs` (array): Additional xcodebuild arguments
- `preferXcodebuild` (boolean): If true, prefers xcodebuild over the experimental incremental build system
- `projectPath` (string): Path to the .xcodeproj file
- `scheme` (string, required): The scheme to use
- `workspacePath` (string): Path to the .xcworkspace file

### `build_run_macos` (~198 tokens)

Builds and runs a macOS app from a project or workspace in one step. Provide exactly one of projectPath or workspacePath. Example: build_run_macos({ projectPath: '/path/to/MyProject.xcodeproj', scheme: 'MyScheme' })

Input parameters:

- `arch` (string): Architecture to build for (arm64 or x86_64). For macOS only.
- `configuration` (string): Build configuration (Debug, Release, etc.)
- `derivedDataPath` (string): Path where build products and other derived data will go
- `extraArgs` (array): Additional xcodebuild arguments
- `preferXcodebuild` (boolean): If true, prefers xcodebuild over the experimental incremental build system
- `projectPath` (string): Path to the .xcodeproj file
- `scheme` (string, required): The scheme to use
- `workspacePath` (string): Path to the .xcworkspace file

### `get_mac_app_path` (~173 tokens)

Gets the app bundle path for a macOS application using either a project or workspace. Provide exactly one of projectPath or workspacePath. Example: get_mac_app_path({ projectPath: '/path/to/project.xcodeproj', scheme: 'MyScheme' })

Input parameters:

- `arch` (string): Architecture to build for (arm64 or x86_64). For macOS only.
- `configuration` (string): Build configuration (Debug, Release, etc.)
- `derivedDataPath` (string): Path to derived data directory
- `extraArgs` (array): Additional arguments to pass to xcodebuild
- `projectPath` (string): Path to the .xcodeproj file
- `scheme` (string, required): The scheme to use
- `workspacePath` (string): Path to the .xcworkspace file

### `get_mac_bundle_id` (~104 tokens)

Extracts the bundle identifier from a macOS app bundle (.app). IMPORTANT: You MUST provide the appPath parameter. Example: get_mac_bundle_id({ appPath: '/path/to/your/app.app' }) Note: In some environments, this tool may be prefixed as mcp0_get_macos_bundle_id.

Input parameters:

- `appPath` (string, required): Path to the macOS .app bundle to extract bundle ID from (full path to the .app directory)

### `launch_mac_app` (~105 tokens)

Launches a macOS application. IMPORTANT: You MUST provide the appPath parameter. Example: launch_mac_app({ appPath: '/path/to/your/app.app' }) Note: In some environments, this tool may be prefixed as mcp0_launch_macos_app.

Input parameters:

- `appPath` (string, required): Path to the macOS .app bundle to launch (full path to the .app directory)
- `args` (array): Additional arguments to pass to the app

### `stop_mac_app` (~68 tokens)

Stops a running macOS application. Can stop by app name or process ID.

Input parameters:

- `appName` (string): Name of the application to stop (e.g., "Calculator" or "MyApp")
- `processId` (number): Process ID (PID) of the application to stop

### `test_macos` (~206 tokens)

Runs tests for a macOS project or workspace using xcodebuild test and parses xcresult output. Provide exactly one of projectPath or workspacePath. IMPORTANT: Requires scheme. Example: test_macos({ projectPath: "/path/to/MyProject.xcodeproj", scheme: "MyScheme" })

Input parameters:

- `configuration` (string): Build configuration (Debug, Release, etc.)
- `derivedDataPath` (string): Path where build products and other derived data will go
- `extraArgs` (array): Additional xcodebuild arguments
- `preferXcodebuild` (boolean): If true, prefers xcodebuild over the experimental incremental build system
- `projectPath` (string): Path to the .xcodeproj file
- `scheme` (string, required): The scheme to use
- `testRunnerEnv` (object): Environment variables to pass to the test runner (TEST_RUNNER_ prefix added automatically)
- `workspacePath` (string): Path to the .xcworkspace file

### `scaffold_ios_project` (~290 tokens)

Scaffold a new iOS project from templates. Creates a modern Xcode project with workspace structure, SPM package for features, and proper iOS configuration.

Input parameters:

- `bundleIdentifier` (string): Bundle identifier (e.g., com.example.myapp). If not provided, will use com.example.projectname
- `currentProjectVersion` (string): Build number (e.g., 1, 42, 100). If not provided, will use 1
- `customizeNames` (boolean): Whether to customize project names and identifiers. Default is true.
- `deploymentTarget` (string): iOS deployment target (e.g., 18.4, 17.0). If not provided, will use 18.4
- `displayName` (string): App display name (shown on home screen/dock). If not provided, will use projectName
- `marketingVersion` (string): Marketing version (e.g., 1.0, 2.1.3). If not provided, will use 1.0
- `outputPath` (string, required): Path where the project should be created
- `projectName` (string, required): Name of the new project
- `supportedOrientations` (array): Supported orientations for iPhone
- `supportedOrientationsIpad` (array): Supported orientations for iPad
- `targetedDeviceFamily` (array): Targeted device families

### `scaffold_macos_project` (~248 tokens)

Scaffold a new macOS project from templates. Creates a modern Xcode project with workspace structure, SPM package for features, and proper macOS configuration.

Input parameters:

- `bundleIdentifier` (string): Bundle identifier (e.g., com.example.myapp). If not provided, will use com.example.projectname
- `currentProjectVersion` (string): Build number (e.g., 1, 42, 100). If not provided, will use 1
- `customizeNames` (boolean): Whether to customize project names and identifiers. Default is true.
- `deploymentTarget` (string): macOS deployment target (e.g., 15.4, 14.0). If not provided, will use 15.4
- `displayName` (string): App display name (shown on home screen/dock). If not provided, will use projectName
- `marketingVersion` (string): Marketing version (e.g., 1.0, 2.1.3). If not provided, will use 1.0
- `outputPath` (string, required): Path where the project should be created
- `projectName` (string, required): Name of the new project

### `boot_sim` (~74 tokens)

Boots an iOS simulator. After booting, use open_sim() to make the simulator visible. IMPORTANT: You MUST provide the simulatorUuid parameter. Example: boot_sim({ simulatorUuid: 'YOUR_UUID_HERE' })

Input parameters:

- `simulatorUuid` (string, required): UUID of the simulator to use (obtained from list_simulators)

### `build_run_sim` (~324 tokens)

Builds and runs an app from a project or workspace on a specific simulator by UUID or name. Provide exactly one of projectPath or workspacePath, and exactly one of simulatorId or simulatorName. IMPORTANT: Requires either projectPath or workspacePath, plus scheme and either simulatorId or simulatorName. Example: build_run_sim({ projectPath: '/path/to/MyProject.xcodeproj', scheme: 'MyScheme', simulatorName: 'iPhone 16' })

Input parameters:

- `configuration` (string): Build configuration (Debug, Release, etc.)
- `derivedDataPath` (string): Path where build products and other derived data will go
- `extraArgs` (array): Additional xcodebuild arguments
- `preferXcodebuild` (boolean): If true, prefers xcodebuild over the experimental incremental build system, useful for when incremental build system fails.
- `projectPath` (string): Path to .xcodeproj file. Provide EITHER this OR workspacePath, not both
- `scheme` (string, required): The scheme to use (Required)
- `simulatorId` (string): UUID of the simulator (from list_sims). Provide EITHER this OR simulatorName, not both
- `simulatorName` (string): Name of the simulator (e.g., 'iPhone 16'). Provide EITHER this OR simulatorId, not both
- `useLatestOS` (boolean): Whether to use the latest OS version for the named simulator
- `workspacePath` (string): Path to .xcworkspace file. Provide EITHER this OR projectPath, not both

### `build_sim` (~320 tokens)

Builds an app from a project or workspace for a specific simulator by UUID or name. Provide exactly one of projectPath or workspacePath, and exactly one of simulatorId or simulatorName. IMPORTANT: Requires either projectPath or workspacePath, plus scheme and either simulatorId or simulatorName. Example: build_sim({ projectPath: '/path/to/MyProject.xcodeproj', scheme: 'MyScheme', simulatorName: 'iPhone 16' })

Input parameters:

- `configuration` (string): Build configuration (Debug, Release, etc.)
- `derivedDataPath` (string): Path where build products and other derived data will go
- `extraArgs` (array): Additional xcodebuild arguments
- `preferXcodebuild` (boolean): If true, prefers xcodebuild over the experimental incremental build system, useful for when incremental build system fails.
- `projectPath` (string): Path to .xcodeproj file. Provide EITHER this OR workspacePath, not both
- `scheme` (string, required): The scheme to use (Required)
- `simulatorId` (string): UUID of the simulator (from list_sims). Provide EITHER this OR simulatorName, not both
- `simulatorName` (string): Name of the simulator (e.g., 'iPhone 16'). Provide EITHER this OR simulatorId, not both
- `useLatestOS` (boolean): Whether to use the latest OS version for the named simulator
- `workspacePath` (string): Path to .xcworkspace file. Provide EITHER this OR projectPath, not both

### `describe_ui` (~65 tokens)

Gets entire view hierarchy with precise frame coordinates (x, y, width, height) for all visible elements. Use this before UI interactions or after layout changes - do NOT guess coordinates from screenshots. Returns JSON tree with frame data for accurate automation.

Input parameters:

- `simulatorUuid` (string, required)

### `get_sim_app_path` (~280 tokens)

Gets the app bundle path for a simulator by UUID or name using either a project or workspace file. IMPORTANT: Requires either projectPath OR workspacePath (not both), plus scheme, platform, and either simulatorId OR simulatorName (not both). Example: get_sim_app_path({ projectPath: '/path/to/project.xcodeproj', scheme: 'MyScheme', platform: 'iOS Simulator', simulatorName: 'iPhone 16' })

Input parameters:

- `arch` (string): Optional architecture
- `configuration` (string): Build configuration (Debug, Release, etc.)
- `platform` (string, required): Target simulator platform (Required)
- `projectPath` (string): Path to .xcodeproj file. Provide EITHER this OR workspacePath, not both
- `scheme` (string, required): The scheme to use (Required)
- `simulatorId` (string): UUID of the simulator (from list_sims). Provide EITHER this OR simulatorName, not both
- `simulatorName` (string): Name of the simulator (e.g., 'iPhone 16'). Provide EITHER this OR simulatorId, not both
- `useLatestOS` (boolean): Whether to use the latest OS version for the named simulator
- `workspacePath` (string): Path to .xcworkspace file. Provide EITHER this OR projectPath, not both

### `install_app_sim` (~105 tokens)

Installs an app in an iOS simulator. IMPORTANT: You MUST provide both the simulatorUuid and appPath parameters. Example: install_app_sim({ simulatorUuid: 'YOUR_UUID_HERE', appPath: '/path/to/your/app.app' })

Input parameters:

- `appPath` (string, required): Path to the .app bundle to install (full path to the .app directory)
- `simulatorUuid` (string, required): UUID of the simulator to use (obtained from list_simulators)

### `launch_app_logs_sim` (~83 tokens)

Launches an app in an iOS simulator and captures its logs.

Input parameters:

- `args` (array): Additional arguments to pass to the app
- `bundleId` (string, required): Bundle identifier of the app to launch (e.g., 'com.example.MyApp')
- `simulatorUuid` (string, required): UUID of the simulator to use (obtained from list_simulators)

### `launch_app_sim` (~224 tokens)

Launches an app in an iOS simulator by UUID or name. If simulator window isn't visible, use open_sim() first. IMPORTANT: Provide either simulatorUuid OR simulatorName, plus bundleId. Note: You must install the app in the simulator before launching. The typical workflow is: build → install → launch. Example: launch_app_sim({ simulatorUuid: 'YOUR_UUID_HERE', bundleId: 'com.example.MyApp' }) or launch_app_sim({ simulatorName: 'iPhone 16', bundleId: 'com.example.MyApp' })

Input parameters:

- `args` (array): Additional arguments to pass to the app
- `bundleId` (string, required): Bundle identifier of the app to launch (e.g., 'com.example.MyApp')
- `simulatorName` (string): Name of the simulator (e.g., 'iPhone 16'). Provide EITHER this OR simulatorUuid, not both
- `simulatorUuid` (string): UUID of the simulator to use (obtained from list_simulators). Provide EITHER this OR simulatorName, not both

### `list_sims` (~35 tokens)

Lists available iOS simulators with their UUIDs.

Input parameters:

- `enabled` (boolean): Optional flag to enable the listing operation.

### `open_sim` (~15 tokens)

Opens the iOS Simulator app.

### `screenshot` (~37 tokens)

Captures screenshot for visual verification. For UI coordinates, use describe_ui instead (don't determine coordinates from screenshots).

Input parameters:

- `simulatorUuid` (string, required)

### `stop_app_sim` (~169 tokens)

Stops an app running in an iOS simulator by UUID or name. IMPORTANT: Provide either simulatorUuid OR simulatorName, plus bundleId. Example: stop_app_sim({ simulatorUuid: "UUID", bundleId: "com.example.MyApp" }) or stop_app_sim({ simulatorName: "iPhone 16", bundleId: "com.example.MyApp" })

Input parameters:

- `bundleId` (string, required): Bundle identifier of the app to stop (e.g., 'com.example.MyApp')
- `simulatorName` (string): Name of the simulator (e.g., 'iPhone 16'). Provide EITHER this OR simulatorUuid, not both
- `simulatorUuid` (string): UUID of the simulator (obtained from list_simulators). Provide EITHER this OR simulatorName, not both

### `test_sim` (~346 tokens)

Runs tests on a simulator by UUID or name using xcodebuild test and parses xcresult output. Works with both Xcode projects (.xcodeproj) and workspaces (.xcworkspace). IMPORTANT: Requires either projectPath or workspacePath, plus scheme and either simulatorId or simulatorName. Example: test_sim({ projectPath: "/path/to/MyProject.xcodeproj", scheme: "MyScheme", simulatorName: "iPhone 16" })

Input parameters:

- `configuration` (string): Build configuration (Debug, Release, etc.)
- `derivedDataPath` (string): Path where build products and other derived data will go
- `extraArgs` (array): Additional xcodebuild arguments
- `preferXcodebuild` (boolean): If true, prefers xcodebuild over the experimental incremental build system, useful for when incremental build system fails.
- `projectPath` (string): Path to .xcodeproj file. Provide EITHER this OR workspacePath, not both
- `scheme` (string, required): The scheme to use (Required)
- `simulatorId` (string): UUID of the simulator (from list_sims). Provide EITHER this OR simulatorName, not both
- `simulatorName` (string): Name of the simulator (e.g., 'iPhone 16'). Provide EITHER this OR simulatorId, not both
- `testRunnerEnv` (object): Environment variables to pass to the test runner (TEST_RUNNER_ prefix added automatically)
- `useLatestOS` (boolean): Whether to use the latest OS version for the named simulator
- `workspacePath` (string): Path to .xcworkspace file. Provide EITHER this OR projectPath, not both

### `reset_sim_location` (~39 tokens)

Resets the simulator's location to default.

Input parameters:

- `simulatorUuid` (string, required): UUID of the simulator to use (obtained from list_simulators)

### `set_sim_appearance` (~65 tokens)

Sets the appearance mode (dark/light) of an iOS simulator.

Input parameters:

- `mode` (string, required): The appearance mode to set (either "dark" or "light")
- `simulatorUuid` (string, required): UUID of the simulator to use (obtained from list_simulators)

### `set_sim_location` (~65 tokens)

Sets a custom GPS location for the simulator.

Input parameters:

- `latitude` (number, required): The latitude for the custom location.
- `longitude` (number, required): The longitude for the custom location.
- `simulatorUuid` (string, required): UUID of the simulator to use (obtained from list_simulators)

### `sim_statusbar` (~174 tokens)

Sets the data network indicator in the iOS simulator status bar. Use "clear" to reset all overrides, or specify a network type (hide, wifi, 3g, 4g, lte, lte-a, lte+, 5g, 5g+, 5g-uwb, 5g-uc).

Input parameters:

- `dataNetwork` (string, required): Data network type to display in status bar. Use "clear" to reset all overrides. Valid values: clear, hide, wifi, 3g, 4g, lte, lte-a, lte+, 5g, 5g+, 5g-uwb, 5g-uc.
- `simulatorUuid` (string, required): UUID of the simulator to use (obtained from list_simulators)

### `swift_package_build` (~86 tokens)

Builds a Swift Package with swift build

Input parameters:

- `architectures` (array): Target architectures to build for
- `configuration` (string): Swift package configuration (debug, release)
- `packagePath` (string, required): Path to the Swift package root (Required)
- `parseAsLibrary` (boolean): Build as library instead of executable
- `targetName` (string): Optional target to build

### `swift_package_clean` (~35 tokens)

Cleans Swift Package build artifacts and derived data

Input parameters:

- `packagePath` (string, required): Path to the Swift package root (Required)

### `swift_package_list` (~16 tokens)

Lists currently running Swift Package processes

### `swift_package_run` (~147 tokens)

Runs an executable target from a Swift Package with swift run

Input parameters:

- `arguments` (array): Arguments to pass to the executable
- `background` (boolean): Run in background and return immediately (default: false)
- `configuration` (string): Build configuration: 'debug' (default) or 'release'
- `executableName` (string): Name of executable to run (defaults to package name)
- `packagePath` (string, required): Path to the Swift package root (Required)
- `parseAsLibrary` (boolean): Add -parse-as-library flag for @main support (default: false)
- `timeout` (number): Timeout in seconds (default: 30, max: 300)

### `swift_package_stop` (~37 tokens)

Stops a running Swift Package executable started with swift_package_run

Input parameters:

- `pid` (number, required): Process ID (PID) of the running executable

### `swift_package_test` (~131 tokens)

Runs tests for a Swift Package with swift test

Input parameters:

- `configuration` (string): Swift package configuration (debug, release)
- `filter` (string): Filter tests by name (regex pattern)
- `packagePath` (string, required): Path to the Swift package root (Required)
- `parallel` (boolean): Run tests in parallel (default: true)
- `parseAsLibrary` (boolean): Add -parse-as-library flag for @main support (default: false)
- `showCodecov` (boolean): Show code coverage (default: false)
- `testProduct` (string): Optional specific test product to run

### `button` (~53 tokens)

Press hardware button on iOS simulator. Supported buttons: apple-pay, home, lock, side-button, siri

Input parameters:

- `buttonType` (string, required)
- `duration` (number)
- `simulatorUuid` (string, required)

### `gesture` (~221 tokens)

Perform gesture on iOS simulator using preset gestures: scroll-up, scroll-down, scroll-left, scroll-right, swipe-from-left-edge, swipe-from-right-edge, swipe-from-top-edge, swipe-from-bottom-edge

Input parameters:

- `delta` (number): Optional: Distance to move in pixels.
- `duration` (number): Optional: Duration of the gesture in seconds.
- `postDelay` (number): Optional: Delay after completing the gesture in seconds.
- `preDelay` (number): Optional: Delay before starting the gesture in seconds.
- `preset` (string, required): The gesture preset to perform. Must be one of: scroll-up, scroll-down, scroll-left, scroll-right, swipe-from-left-edge, swipe-from-right-edge, swipe-from-top-edge, swipe-from-bottom-edge.
- `screenHeight` (integer): Optional: Screen height in pixels. Used for gesture calculations. Auto-detected if not provided.
- `screenWidth` (integer): Optional: Screen width in pixels. Used for gesture calculations. Auto-detected if not provided.
- `simulatorUuid` (string, required)

### `key_press` (~77 tokens)

Press a single key by keycode on the simulator. Common keycodes: 40=Return, 42=Backspace, 43=Tab, 44=Space, 58-67=F1-F10.

Input parameters:

- `duration` (number)
- `keyCode` (integer, required)
- `simulatorUuid` (string, required)

### `key_sequence` (~46 tokens)

Press key sequence using HID keycodes on iOS simulator with configurable delay

Input parameters:

- `delay` (number)
- `keyCodes` (array, required)
- `simulatorUuid` (string, required)

### `long_press` (~60 tokens)

Long press at specific coordinates for given duration (ms). Use describe_ui for precise coordinates (don't guess from screenshots).

Input parameters:

- `duration` (number, required)
- `simulatorUuid` (string, required)
- `x` (integer, required)
- `y` (integer, required)

### `swipe` (~100 tokens)

Swipe from one point to another. Use describe_ui for precise coordinates (don't guess from screenshots). Supports configurable timing.

Input parameters:

- `delta` (number)
- `duration` (number)
- `postDelay` (number)
- `preDelay` (number)
- `simulatorUuid` (string, required)
- `x1` (integer, required)
- `x2` (integer, required)
- `y1` (integer, required)
- `y2` (integer, required)

### `tap` (~69 tokens)

Tap at specific coordinates. Use describe_ui to get precise element coordinates (don't guess from screenshots). Supports optional timing delays.

Input parameters:

- `postDelay` (number)
- `preDelay` (number)
- `simulatorUuid` (string, required)
- `x` (integer, required)
- `y` (integer, required)

### `touch` (~71 tokens)

Perform touch down/up events at specific coordinates. Use describe_ui for precise coordinates (don't guess from screenshots).

Input parameters:

- `delay` (number)
- `down` (boolean)
- `simulatorUuid` (string, required)
- `up` (boolean)
- `x` (integer, required)
- `y` (integer, required)

### `type_text` (~46 tokens)

Type text (supports US keyboard characters). Use describe_ui to find text field, tap to focus, then type.

Input parameters:

- `simulatorUuid` (string, required)
- `text` (string, required)

## Diagnostics

Captured diagnostic sections: Provenance, Dependencies. The full working is on the page: https://verifymcp.io/servers/cameroncooke-xcodebuildmcp/xcodebuildmcp#diagnostics

## Score history

- 2026-08-03: 55
- 2026-08-02: 54
- 2026-08-01: 13
- 2026-07-31: 13
- 2026-07-30: 36
- 2026-07-28: 18
- 2026-07-27: 36

## Links

- npm package: https://www.npmjs.com/package/xcodebuildmcp
- Socket report: https://socket.dev/npm/package/xcodebuildmcp
- Changelog RSS feed: https://verifymcp.io/servers/cameroncooke-xcodebuildmcp/xcodebuildmcp/changelog.xml
- Changelog JSON feed: https://verifymcp.io/servers/cameroncooke-xcodebuildmcp/xcodebuildmcp/changelog.json
- HTML version of this page: https://verifymcp.io/servers/cameroncooke-xcodebuildmcp/xcodebuildmcp