io.github.cameroncooke/XcodeBuildMCP
NPM · XCODEBUILDMCP · SCANNED SEP 20
XcodeBuildMCP provides tools for Xcode project management, simulator management, and app utilities.
Available components
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. How we score → Why this is hard to score →
Supply Chain Security99
- No malware found by supply-chain analysis.Pass
- No known CVEs affecting this package version or its production dependencies.Pass
- No install/post-install scripts declared.Pass
- 34 of 127 dependencies flagged as unhealthy. View diagnostics → Partial
Provenance & Transparency23
- Repository check failed: the declared repository URL redirects; it must resolve directly. See how to fix → View diagnostics → Fail
- Provenance check failed: no build-provenance attestation is published. See how to fix → View diagnostics → Fail
- Clear OSI-approved license (MIT).Pass
- Actively maintained (last published 58 days ago).Pass
- Publishes a security disclosure policy (SECURITY.md).Pass
Schema Quality & AI Usability48
- 0% of prompts and resources have a non-trivial description (not blank, and not just the item's name).Fail
- AI-judged instruction clarity (excellent).Pass
- 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. See how to fix → Fail
- Usage-examples check failed: none of the tools include examples. See how to fix → Fail
Stability & Change Management93
- Stability observed for 28 of 30 days with no destabilising changes; credit accrues until the full window elapses.Partial
Tool Coverage95
- 100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
- 84% of tool parameters carry a description.Partial
Tool Safety100
- No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.Pass
- We read all 58 captured tool definition(s), and no name or description among them implies an irreversible operation.Pass
- An AI judge read all 59 captured unit(s) of tool text and found none that tries to manipulate the model reading it.Pass
Capabilities60
- Spec-recency check failed: implements MCP spec 2025-06-18; the latest is 2026-07-28. See how to fix → Fail
How do I install the io.github.cameroncooke/XcodeBuildMCP MCP server?
io.github.cameroncooke/XcodeBuildMCP runs locally as an npm package, launched with npx -y xcodebuildmcp. Ready-made configuration for Claude, Cursor, VS Code, Codex and 5 more is on this page, copied from each client's own documentation.
npm · xcodebuildmcp
claude mcp add cameroncooke-xcodebuildmcp -- npx -y xcodebuildmcp
{
"mcpServers": {
"cameroncooke-xcodebuildmcp": {
"command": "npx",
"args": [
"-y",
"xcodebuildmcp"
]
}
}
} {
"servers": {
"cameroncooke-xcodebuildmcp": {
"command": "npx",
"args": [
"-y",
"xcodebuildmcp"
]
}
}
} codex mcp add cameroncooke-xcodebuildmcp -- npx -y xcodebuildmcp
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"cameroncooke-xcodebuildmcp": {
"type": "local",
"command": [
"npx",
"-y",
"xcodebuildmcp"
],
"enabled": true
}
}
} openclaw mcp add cameroncooke-xcodebuildmcp --command npx --arg -y --arg xcodebuildmcp
mcp_servers:
cameroncooke-xcodebuildmcp:
command: "npx"
args: ["-y", "xcodebuildmcp"] {
"McpServers": {
"cameroncooke-xcodebuildmcp": {
"Transport": "stdio",
"Command": "npx",
"Arguments": [
"-y",
"xcodebuildmcp"
]
}
}
} assistant mcp add cameroncooke-xcodebuildmcp -t stdio -c npx -a -y xcodebuildmcp
{
"mcpServers": {
"cameroncooke-xcodebuildmcp": {
"command": "npx",
"args": [
"-y",
"xcodebuildmcp"
]
}
}
} Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.
- 19 Sept 26 +1
No change was recorded against any check on this day. Stability & Change Management went from 87 to 90. That category is still filling its 30-day observation window: 26 days of observed history at the previous scan, 27 at this one. The score rises as the window fills, whether or not the server changes.
- 17 Sept 26 +1
No change was recorded against any check on this day. Stability & Change Management went from 80 to 83. That category is still filling its 30-day observation window: 24 days of observed history at the previous scan, 25 at this one. The score rises as the window fills, whether or not the server changes.
- 16 Sept 26 −3
- Stability: pass → 0.80 functional
- 15 Sept 26 0
- Stability: 0.97 → pass security
- 14 Sept 26 +1
No change was recorded against any check on this day. Stability & Change Management went from 93 to 97. That category is still filling its 30-day observation window: 28 days of observed history at the previous scan, 29 at this one. The score rises as the window fills, whether or not the server changes.
- 12 Sept 26 +1
No change was recorded against any check on this day. Stability & Change Management went from 87 to 90. That category is still filling its 30-day observation window: 26 days of observed history at the previous scan, 27 at this one. The score rises as the window fills, whether or not the server changes.
- 10 Sept 26 −2
- Stability: pass → 0.83 functional
- 9 Sept 26 0
- Stability: 0.97 → pass security
Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.
Captured 20 Sept 2026 · Analysed npm/xcodebuildmcp@1.12.8
Provenance No attestation
The registry publishes no build provenance for this version, so there is nothing to verify.
| Result | No attestation |
|---|---|
| Ecosystem | npm |
Background: How many MCP packages publish verified provenance →
Dependencies 127 packages
| Packages resolved | 127 |
|---|---|
| Stale | 34 |
| Tree resolution | Complete |
Background: SBOMs and build attestations, explained →
The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability. A tool's description is untrusted text the model reads on every call, which is what makes this list a security surface and not just an inventory: how tool poisoning works →
boot_sim ~74
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' })
| Name | Type | Req | Description |
|---|---|---|---|
| simulatorUuid | string | yes | UUID of the simulator to use (obtained from list_simulators) |
No output schema declared.
No examples provided.
build_device ~158
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' })
| Name | Type | Req | Description |
|---|---|---|---|
| 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 | yes | The scheme to build |
| workspacePath | string | – | Path to the .xcworkspace file |
No output schema declared.
No examples provided.
build_macos ~195
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' })
| Name | Type | Req | Description |
|---|---|---|---|
| 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 | yes | The scheme to use |
| workspacePath | string | – | Path to the .xcworkspace file |
No output schema declared.
No examples provided.
build_run_macos ~198
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' })
| Name | Type | Req | Description |
|---|---|---|---|
| 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 | yes | The scheme to use |
| workspacePath | string | – | Path to the .xcworkspace file |
No output schema declared.
No examples provided.
build_run_sim ~324
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' })
| Name | Type | Req | Description |
|---|---|---|---|
| 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 | yes | 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 |
No output schema declared.
No examples provided.
build_sim ~320
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' })
| Name | Type | Req | Description |
|---|---|---|---|
| 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 | yes | 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 |
No output schema declared.
No examples provided.
button ~53
Press hardware button on iOS simulator. Supported buttons: apple-pay, home, lock, side-button, siri
| Name | Type | Req | Description |
|---|---|---|---|
| buttonType | string | yes | – |
| duration | number | – | – |
| simulatorUuid | string | yes | – |
No output schema declared.
No examples provided.
clean ~247
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' })
| Name | Type | Req | Description |
|---|---|---|---|
| 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 |
No output schema declared.
No examples provided.
describe_ui ~65
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.
| Name | Type | Req | Description |
|---|---|---|---|
| simulatorUuid | string | yes | – |
No output schema declared.
No examples provided.
discover_projs ~97
Scans a directory (defaults to workspace root) to find Xcode project (.xcodeproj) and workspace (.xcworkspace) files.
| Name | Type | Req | Description |
|---|---|---|---|
| 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 | yes | The absolute path of the workspace root to scan within. |
No output schema declared.
No examples provided.
doctor ~38
Provides comprehensive information about the MCP server environment, available dependencies, and configuration status.
| Name | Type | Req | Description |
|---|---|---|---|
| enabled | boolean | – | Optional: dummy parameter to satisfy MCP protocol |
No output schema declared.
No examples provided.
gesture ~221
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
| Name | Type | Req | Description |
|---|---|---|---|
| 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 | yes | 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 | yes | – |
No output schema declared.
No examples provided.
get_app_bundle_id ~99
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' })
| Name | Type | Req | Description |
|---|---|---|---|
| appPath | string | yes | Path to the .app bundle to extract bundle ID from (full path to the .app directory) |
No output schema declared.
No examples provided.
get_device_app_path ~146
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' })
| Name | Type | Req | Description |
|---|---|---|---|
| configuration | string | – | Build configuration (Debug, Release, etc.) |
| platform | string | – | Target platform (defaults to iOS) |
| projectPath | string | – | Path to the .xcodeproj file |
| scheme | string | yes | The scheme to use |
| workspacePath | string | – | Path to the .xcworkspace file |
No output schema declared.
No examples provided.
get_mac_app_path ~173
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' })
| Name | Type | Req | Description |
|---|---|---|---|
| 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 | yes | The scheme to use |
| workspacePath | string | – | Path to the .xcworkspace file |
No output schema declared.
No examples provided.
get_mac_bundle_id ~104
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.
| Name | Type | Req | Description |
|---|---|---|---|
| appPath | string | yes | Path to the macOS .app bundle to extract bundle ID from (full path to the .app directory) |
No output schema declared.
No examples provided.
get_sim_app_path ~280
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' })
| Name | Type | Req | Description |
|---|---|---|---|
| arch | string | – | Optional architecture |
| configuration | string | – | Build configuration (Debug, Release, etc.) |
| platform | string | yes | Target simulator platform (Required) |
| projectPath | string | – | Path to .xcodeproj file. Provide EITHER this OR workspacePath, not both |
| scheme | string | yes | 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 |
No output schema declared.
No examples provided.
install_app_device ~85
Installs an app on a physical Apple device (iPhone, iPad, Apple Watch, Apple TV, Apple Vision Pro). Requires deviceId and appPath.
| Name | Type | Req | Description |
|---|---|---|---|
| appPath | string | yes | Path to the .app bundle to install (full path to the .app directory) |
| deviceId | string | yes | UDID of the device (obtained from list_devices) |
No output schema declared.
No examples provided.
install_app_sim ~105
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' })
| Name | Type | Req | Description |
|---|---|---|---|
| appPath | string | yes | Path to the .app bundle to install (full path to the .app directory) |
| simulatorUuid | string | yes | UUID of the simulator to use (obtained from list_simulators) |
No output schema declared.
No examples provided.
key_press ~77
Press a single key by keycode on the simulator. Common keycodes: 40=Return, 42=Backspace, 43=Tab, 44=Space, 58-67=F1-F10.
| Name | Type | Req | Description |
|---|---|---|---|
| duration | number | – | – |
| keyCode | integer | yes | – |
| simulatorUuid | string | yes | – |
No output schema declared.
No examples provided.
key_sequence ~46
Press key sequence using HID keycodes on iOS simulator with configurable delay
| Name | Type | Req | Description |
|---|---|---|---|
| delay | number | – | – |
| keyCodes | array | yes | – |
| simulatorUuid | string | yes | – |
No output schema declared.
No examples provided.
launch_app_device ~85
Launches an app on a physical Apple device (iPhone, iPad, Apple Watch, Apple TV, Apple Vision Pro). Requires deviceId and bundleId.
| Name | Type | Req | Description |
|---|---|---|---|
| bundleId | string | yes | Bundle identifier of the app to launch (e.g., "com.example.MyApp") |
| deviceId | string | yes | UDID of the device (obtained from list_devices) |
No output schema declared.
No examples provided.
launch_app_logs_sim ~83
Launches an app in an iOS simulator and captures its logs.
| Name | Type | Req | Description |
|---|---|---|---|
| args | array | – | Additional arguments to pass to the app |
| bundleId | string | yes | Bundle identifier of the app to launch (e.g., 'com.example.MyApp') |
| simulatorUuid | string | yes | UUID of the simulator to use (obtained from list_simulators) |
No output schema declared.
No examples provided.
launch_app_sim ~224
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' })
| Name | Type | Req | Description |
|---|---|---|---|
| args | array | – | Additional arguments to pass to the app |
| bundleId | string | yes | 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 |
No output schema declared.
No examples provided.
launch_mac_app ~105
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.
| Name | Type | Req | Description |
|---|---|---|---|
| appPath | string | yes | Path to the macOS .app bundle to launch (full path to the .app directory) |
| args | array | – | Additional arguments to pass to the app |
No output schema declared.
No examples provided.
list_devices ~50
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.
Input schema present but exposes no named parameters.
No output schema declared.
No examples provided.
list_schemes ~82
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' })
| Name | Type | Req | Description |
|---|---|---|---|
| projectPath | string | – | Path to the .xcodeproj file |
| workspacePath | string | – | Path to the .xcworkspace file |
No output schema declared.
No examples provided.
list_sims ~35
Lists available iOS simulators with their UUIDs.
| Name | Type | Req | Description |
|---|---|---|---|
| enabled | boolean | – | Optional flag to enable the listing operation. |
No output schema declared.
No examples provided.
long_press ~60
Long press at specific coordinates for given duration (ms). Use describe_ui for precise coordinates (don't guess from screenshots).
| Name | Type | Req | Description |
|---|---|---|---|
| duration | number | yes | – |
| simulatorUuid | string | yes | – |
| x | integer | yes | – |
| y | integer | yes | – |
No output schema declared.
No examples provided.
open_sim ~15
Opens the iOS Simulator app.
Input schema present but exposes no named parameters.
No output schema declared.
No examples provided.
reset_sim_location ~39
Resets the simulator's location to default.
| Name | Type | Req | Description |
|---|---|---|---|
| simulatorUuid | string | yes | UUID of the simulator to use (obtained from list_simulators) |
No output schema declared.
No examples provided.
scaffold_ios_project ~290
Scaffold a new iOS project from templates. Creates a modern Xcode project with workspace structure, SPM package for features, and proper iOS configuration.
| Name | Type | Req | Description |
|---|---|---|---|
| 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 | yes | Path where the project should be created |
| projectName | string | yes | Name of the new project |
| supportedOrientations | array | – | Supported orientations for iPhone |
| supportedOrientationsIpad | array | – | Supported orientations for iPad |
| targetedDeviceFamily | array | – | Targeted device families |
No output schema declared.
No examples provided.
scaffold_macos_project ~248
Scaffold a new macOS project from templates. Creates a modern Xcode project with workspace structure, SPM package for features, and proper macOS configuration.
| Name | Type | Req | Description |
|---|---|---|---|
| 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 | yes | Path where the project should be created |
| projectName | string | yes | Name of the new project |
No output schema declared.
No examples provided.
screenshot ~37
Captures screenshot for visual verification. For UI coordinates, use describe_ui instead (don't determine coordinates from screenshots).
| Name | Type | Req | Description |
|---|---|---|---|
| simulatorUuid | string | yes | – |
No output schema declared.
No examples provided.
set_sim_appearance ~65
Sets the appearance mode (dark/light) of an iOS simulator.
| Name | Type | Req | Description |
|---|---|---|---|
| mode | string | yes | The appearance mode to set (either "dark" or "light") |
| simulatorUuid | string | yes | UUID of the simulator to use (obtained from list_simulators) |
No output schema declared.
No examples provided.
set_sim_location ~65
Sets a custom GPS location for the simulator.
| Name | Type | Req | Description |
|---|---|---|---|
| latitude | number | yes | The latitude for the custom location. |
| longitude | number | yes | The longitude for the custom location. |
| simulatorUuid | string | yes | UUID of the simulator to use (obtained from list_simulators) |
No output schema declared.
No examples provided.
show_build_settings ~108
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' })
| Name | Type | Req | Description |
|---|---|---|---|
| projectPath | string | – | Path to the .xcodeproj file |
| scheme | string | yes | Scheme name to show build settings for (Required) |
| workspacePath | string | – | Path to the .xcworkspace file |
No output schema declared.
No examples provided.
sim_statusbar ~174
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).
| Name | Type | Req | Description |
|---|---|---|---|
| dataNetwork | string | yes | 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 | yes | UUID of the simulator to use (obtained from list_simulators) |
No output schema declared.
No examples provided.
start_device_log_cap ~86
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.
| Name | Type | Req | Description |
|---|---|---|---|
| bundleId | string | yes | Bundle identifier of the app to launch and capture logs for. |
| deviceId | string | yes | UDID of the device (obtained from list_devices) |
No output schema declared.
No examples provided.
start_sim_log_cap ~89
Starts capturing logs from a specified simulator. Returns a session ID. By default, captures only structured logs.
| Name | Type | Req | Description |
|---|---|---|---|
| bundleId | string | yes | Bundle identifier of the app to capture logs for. |
| captureConsole | boolean | – | Whether to capture console output (requires app relaunch). |
| simulatorUuid | string | yes | UUID of the simulator to capture logs from (obtained from list_simulators). |
No output schema declared.
No examples provided.
stop_app_device ~79
Stops an app running on a physical Apple device (iPhone, iPad, Apple Watch, Apple TV, Apple Vision Pro). Requires deviceId and processId.
| Name | Type | Req | Description |
|---|---|---|---|
| deviceId | string | yes | UDID of the device (obtained from list_devices) |
| processId | number | yes | Process ID (PID) of the app to stop |
No output schema declared.
No examples provided.
stop_app_sim ~169
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" })
| Name | Type | Req | Description |
|---|---|---|---|
| bundleId | string | yes | 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 |
No output schema declared.
No examples provided.
stop_device_log_cap ~42
Stops an active Apple device log capture session and returns the captured logs.
| Name | Type | Req | Description |
|---|---|---|---|
| logSessionId | string | yes | The session ID returned by start_device_log_cap. |
No output schema declared.
No examples provided.
stop_mac_app ~68
Stops a running macOS application. Can stop by app name or process ID.
| Name | Type | Req | Description |
|---|---|---|---|
| appName | string | – | Name of the application to stop (e.g., "Calculator" or "MyApp") |
| processId | number | – | Process ID (PID) of the application to stop |
No output schema declared.
No examples provided.
stop_sim_log_cap ~41
Stops an active simulator log capture session and returns the captured logs.
| Name | Type | Req | Description |
|---|---|---|---|
| logSessionId | string | yes | The session ID returned by start_sim_log_cap. |
No output schema declared.
No examples provided.
swift_package_build ~86
Builds a Swift Package with swift build
| Name | Type | Req | Description |
|---|---|---|---|
| architectures | array | – | Target architectures to build for |
| configuration | string | – | Swift package configuration (debug, release) |
| packagePath | string | yes | Path to the Swift package root (Required) |
| parseAsLibrary | boolean | – | Build as library instead of executable |
| targetName | string | – | Optional target to build |
No output schema declared.
No examples provided.
swift_package_clean ~35
Cleans Swift Package build artifacts and derived data
| Name | Type | Req | Description |
|---|---|---|---|
| packagePath | string | yes | Path to the Swift package root (Required) |
No output schema declared.
No examples provided.
swift_package_list ~16
Lists currently running Swift Package processes
Input schema present but exposes no named parameters.
No output schema declared.
No examples provided.
swift_package_run ~147
Runs an executable target from a Swift Package with swift run
| Name | Type | Req | Description |
|---|---|---|---|
| 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 | yes | 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) |
No output schema declared.
No examples provided.
swift_package_stop ~37
Stops a running Swift Package executable started with swift_package_run
| Name | Type | Req | Description |
|---|---|---|---|
| pid | number | yes | Process ID (PID) of the running executable |
No output schema declared.
No examples provided.
What is the io.github.cameroncooke/XcodeBuildMCP MCP server?
io.github.cameroncooke/XcodeBuildMCP is an MCP server listed in the public MCP registry as io.github.cameroncooke/XcodeBuildMCP. XcodeBuildMCP provides tools for Xcode project management, simulator management, and app utilities. This page covers its npm package (xcodebuildmcp).
Is the io.github.cameroncooke/XcodeBuildMCP MCP server safe to use?
io.github.cameroncooke/XcodeBuildMCP scores 72 out of 100 on VerifyMCP. We found no known CVEs affecting it as of 20 September 2026. It declares no install or post-install scripts. That is a record of what we were able to check automatically, not an endorsement. The category breakdown on this page shows every signal behind the number, including the ones we could not confirm.
What tools does the io.github.cameroncooke/XcodeBuildMCP MCP server expose?
io.github.cameroncooke/XcodeBuildMCP exposes 58 tools: build_device, clean, discover_projs, get_app_bundle_id, get_device_app_path, and 53 more. Their descriptions and schemas cost roughly 6,992 tokens of context every time the server is loaded.
Is the io.github.cameroncooke/XcodeBuildMCP MCP server still maintained?
io.github.cameroncooke/XcodeBuildMCP is still listed as active in the MCP registry. We last reached this channel on 20 September 2026. Those dates come from our own scans of the registry and the channel itself, not from anything the publisher announced.
What licence is the io.github.cameroncooke/XcodeBuildMCP MCP server under?
io.github.cameroncooke/XcodeBuildMCP declares the MIT licence, which is OSI-approved. That covers the source only, and says nothing about the cost of any service it calls.