
Xcodemcp
This server gives Claude direct control over Xcode through JavaScript for Automation, not just xcodebuild. You get build, run, test, and debug operations that actually manipulate the Xcode GUI, plus it parses build logs with XCLogParser to surface precise error locations. It includes project management tools and can extract test results from XCResult bundles. Now that Apple ships an official Xcode MCP, this one offers a sidekick mode that focuses on complementary features like XCResult analysis and project inspection while letting Apple's server handle the core build operations. Ships with a full CLI if you want to run commands outside the MCP context.
- GitHub stars
- 55
- tools
- 22
- transport
- STDIO
- last updated
- Sep 18, 2025
Tools
22 toolsPublic tool metadata for what this MCP can expose to an agent.
xcode_open_projectOpen projects and workspaces
Open projects and workspaces
No parameter schema in public metadata yet.
xcode_get_workspace_infoGet workspace status and details
Get workspace status and details
No parameter schema in public metadata yet.
xcode_get_projectsList projects in workspace
List projects in workspace
No parameter schema in public metadata yet.
xcode_open_fileOpen files with optional line number
Open files with optional line number
No parameter schema in public metadata yet.
xcode_buildBuild with detailed error parsing
Build with detailed error parsing
No parameter schema in public metadata yet.
xcode_cleanClean build artifacts
Clean build artifacts
No parameter schema in public metadata yet.
xcode_testRun tests with optional arguments
Run tests with optional arguments
No parameter schema in public metadata yet.
xcode_build_and_runBuild and run the active scheme
Build and run the active scheme
No parameter schema in public metadata yet.
xcode_debugStart debugging session
Start debugging session
No parameter schema in public metadata yet.
xcode_stopStop current operation
Stop current operation
No parameter schema in public metadata yet.
xcode_get_schemesList available schemes
List available schemes
No parameter schema in public metadata yet.
xcode_set_active_schemeSwitch active scheme
Switch active scheme
No parameter schema in public metadata yet.
xcode_get_run_destinationsList simulators and devices
List simulators and devices
No parameter schema in public metadata yet.
xcresult_browseBrowse test results and analyze failures
Browse test results and analyze failures
No parameter schema in public metadata yet.
xcresult_browser_get_consoleGet console output for specific tests
Get console output for specific tests
No parameter schema in public metadata yet.
xcresult_summaryQuick overview of test results
Quick overview of test results
No parameter schema in public metadata yet.
xcresult_get_screenshotExtract screenshots from test failures
Extract screenshots from test failures
No parameter schema in public metadata yet.
xcresult_get_ui_hierarchyGet UI hierarchy as AI-readable JSON with timestamp selection
Get UI hierarchy as AI-readable JSON with timestamp selection
No parameter schema in public metadata yet.
xcresult_get_ui_elementGet detailed properties of specific UI elements by index
Get detailed properties of specific UI elements by index
No parameter schema in public metadata yet.
xcresult_list_attachmentsList all attachments for a test
List all attachments for a test
No parameter schema in public metadata yet.
xcresult_export_attachmentExport specific attachments from test results
Export specific attachments from test results
No parameter schema in public metadata yet.
xcode_health_checkEnvironment validation and troubleshooting
Environment validation and troubleshooting
No parameter schema in public metadata yet.
Sponsors
Readme
Using with Apple's Official Xcode MCP: Apple now provides an official Xcode MCP server. XcodeMCP can run alongside it in sidekick mode (
--sidekick-only), providing complementary tools like project management and XCResult analysis. In a future version, XcodeMCP will transition to sidekick-only mode by default. See configuration below.
XcodeMCP
Model Context Protocol (MCP) server that controls Xcode directly through JavaScript for Automation (JXA). Available as both an MCP server and a standalone CLI.
What it does
Details
- Repository
- github.com/lapfelix/xcodemcp
- Category
- Mobile Development
- Package
xcodemcp- Transport
- STDIO
- Registry
- MCP registry, active