Open an Xcode project or workspace

Close the currently active Xcode project or workspace (automatically stops any running actions first)

Build a specific Xcode project or workspace with the specified scheme. If destination is not provided, uses the currently active destination. ⏱️ Can take minutes to hours - do not timeout.

Get list of available schemes for a specific project

Set the active scheme for a specific project

Clean the build directory for a specific project

Run tests for a specific project. Optionally run only specific tests or test classes by temporarily modifying the test plan (automatically restored after completion). ⏱️ Can take minutes to hours - do not timeout.

Build and run a specific project with the specified scheme. ⏱️ Can run indefinitely - do not timeout.

Start debugging session for a specific project. ⏱️ Can run indefinitely - do not timeout.

Stop the current scheme action for a specific project

Find all XCResult files for a specific project with timestamps and file information

Get list of available run destinations for a specific project

Get information about a specific workspace

Get list of projects in a specific workspace

Open a file in Xcode

Perform a comprehensive health check of the XcodeMCP environment and configuration

Browse XCResult files - list all tests or show details for a specific test. Returns comprehensive test results including pass/fail status, failure details, and browsing instructions. Large console output (>20 lines or >2KB) is automatically saved to a temporary file.

Get console output and test activities for a specific test in an XCResult file. Large output (>20 lines or >2KB) is automatically saved to a temporary file.

Get a quick summary of test results from an XCResult file

Get screenshot from a failed test at specific timestamp - extracts frame from video attachment using ffmpeg

Get UI hierarchy attachment from test. Returns raw accessibility tree (best for AI), slim AI-readable JSON (default), or full JSON.

Get full details of a specific UI element by index from a previously exported UI hierarchy JSON file

List all attachments for a specific test - shows attachment names, types, and indices for export

Export a specific attachment by index - can convert App UI hierarchy attachments to JSON

Refresh/reload an Xcode project by closing and reopening it to pick up external changes like modified .xctestplan files

Get information about test targets in a project, including names and identifiers