lapfelix avatar

Xcodemcp

lapfelix/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 tools

Public 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

npm version Test Status

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


View the full README on GitHub

Details

Repository
github.com/lapfelix/xcodemcp
Category
Mobile Development
Package
xcodemcp
Transport
STDIO
Registry
MCP registry, active

Related Mobile Development MCP servers

View all
1chrisgleissner avatarC64 Bridgechrisgleissner/c64bridgeMCP server for Commodore 64 Ultimate hardware and VICE emulator control.41stars
2paulhkang94 avatarMarkViewpaulhkang94/markviewNative macOS markdown preview with MCP server for Claude Code. Swift/SwiftUI, no Electron.38stars
3johnzfitch avatarPyghidra Litejohnzfitch/pyghidra-liteToken-efficient Ghidra RE: decompile, xrefs, Swift/ObjC, ELF/Mach-O, async analysis36stars
4kiki830621 avatarmacOS Calendar & Reminderskiki830621/che-ical-mcpmacOS Calendar & Reminders MCP server (24 tools). Native Swift EventKit, iCloud/Google/Exchange.27stars
5voidmobcom avatarVoidmob Mcpvoidmobcom/voidmob-mcpMobile proxies, non-VoIP SMS verifications, dedicated numbers, and global eSIMs for AI agents.22stars
6vikas9793 avatarAndroJack MCPvikas9793/androjack-mcpAndroid engineering MCP server with verified documentation grounding and AI validation tools.21stars