Xcodemcp
by lapfelixcommunityv2.1.4
55
4
XcodeMCP is a Model Context Protocol (MCP) server that controls Xcode directly through JavaScript for Automation (JXA), allowing users to manage projects, build, run, test, and debug within Xcode. It also includes a CLI with full feature parity to the MCP server.
From the registry: Control Xcode directly via JXA for build, test, debug operations with XCLogParser integration
Install & configure
Prerequisites
- requiredmacOSPlatform requirement (JXA-based)
- requiredXcodeMust be installed
- requiredNode.js 18+Required runtime
- optionalXCLogParser (recommended)For build error parsing
$ brew install xclogparser
Install in your client
Paste into the AI you're chatting with — it will figure out the rest
Please install the `xcodemcp` MCP server into my current AI client (that's you).
Required prerequisites (do these first if not already done):
- **macOS** — Platform requirement (JXA-based)
- **Xcode** — Must be installed
- **Node.js 18+** — Required runtime
Optional prerequisites:
- XCLogParser (recommended) — For build error parsing Run: `brew install xclogparser`
Canonical MCP server config (stdio transport):
- command: `npx`
- args: ["-y","xcodemcp@latest"]
- optional environment variables:
- `XCODE_MCP_PREFERRED_SCHEME`: Default scheme to avoid passing it every call (example: `MyApp`)
- `XCODE_MCP_PREFERRED_XCODEPROJ`: Default xcodeproj path (example: `MyApp.xcodeproj`)
Note: Controls Xcode via JXA. Includes sidekick mode (--sidekick-only) for use alongside Apple's official Xcode MCP. Also provides xcodecontrol CLI.
Add this MCP server to my current client's config in the correct format for you. If you need secrets or credentials I haven't provided, ASK me — do not invent values or leave raw placeholders. After adding it, tell me how to verify the server is connected.Note: Controls Xcode via JXA. Includes sidekick mode (--sidekick-only) for use alongside Apple's official Xcode MCP. Also provides xcodecontrol CLI.
Tools (22)
xcode_open_project
Open projects and workspaces
xcode_get_workspace_info
Get workspace status and details
xcode_get_projects
List projects in workspace
xcode_open_file
Open files with optional line number
xcode_build
Build with detailed error parsing
xcode_clean
Clean build artifacts
xcode_test
Run tests with optional arguments
xcode_build_and_run
Build and run the active scheme
xcode_debug
Start debugging session
xcode_stop
Stop current operation
xcode_get_schemes
List available schemes
xcode_set_active_scheme
Switch active scheme
xcode_get_run_destinations
List simulators and devices
xcresult_browse
Browse test results and analyze failures
xcresult_browser_get_console
Environment variables
XCODE_MCP_PREFERRED_SCHEMEPreferred scheme for single project workflowsXCODE_MCP_PREFERRED_XCODEPROJPreferred Xcode project for single project workflowsPrerequisites
- • Node.js 18+
Packages
xcodemcp
npmv2.1.4transport: stdio
Details
- Language
- TypeScript
- License
- Apache-2.0
- Released
- Sep 18, 2025
- Last commit
- Feb 5, 2026
- Registry name
- io.github.lapfelix/xcodemcp