How do I install the xcodemcp mcp server?

Use a recorded configuration for your client, replace example credential values and paths, and verify the documented runtime. Restart or reconnect the client, then inspect the available tools.

What credentials does it need?

It reads `XCODE_MCP_PREFERRED_SCHEME`, `XCODE_MCP_PREFERRED_XCODEPROJ`, `LOG_LEVEL`, `XCODEMCP_LOG_FILE`, `XCODEMCP_CONSOLE_LOGGING` from the environment. Store these in your client's env block or a secrets manager — never commit them to a repository — and grant the narrowest scope that still covers your use case.

SSyncDev

Start a project

XcodeMCP MCP Server

Model Context Protocol server for Xcode build automation and log parsing

Local serverstdioTypeScript

What is the XcodeMCP MCP Server?

Model Context Protocol server for Xcode build automation and log parsing

What it actually does

Model Context Protocol (MCP) server that controls Xcode directly through JavaScript for Automation (JXA). Available as both an MCP server and a standalone CLI.

Controls Xcode directly through JavaScript for Automation (not xcodebuild CLI)
Opens projects, builds, runs, tests, and debugs from within Xcode
Parses build logs with precise error locations using XCLogParser
Provides comprehensive environment validation and health checks
Supports graceful degradation when optional dependencies are missing
NEW — Includes a full-featured CLI with 100% MCP server feature parity

Configuration

macOS with Xcode installed - Node.js 18+ - XCLogParser (recommended): brew install xclogparser

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

Tool	What it does
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	Get console output for specific tests
xcresult_summary	Quick overview of test results
xcresult_get_screenshot	Extract screenshots from test failures
xcresult_get_ui_hierarchy	Get UI hierarchy as AI-readable JSON with timestamp selection
xcresult_get_ui_element	Get detailed properties of specific UI elements by index
xcresult_list_attachments	List all attachments for a test
xcresult_export_attachment	Export specific attachments from test results
xcode_health_check	Environment validation and troubleshooting

How to install the XcodeMCP MCP Server

{
  "mcpServers": {
    "xcodemcp": {
      "command": "npx",
      "args": [
        "-y",
        "xcodemcp@latest"
      ],
      "env": {}
    }
  }
}

From the project documentation. Replace placeholders and example paths before connecting.

Configuration

macOS with Xcode installed - Node.js 18+ - XCLogParser (recommended): brew install xclogparser

Example prompts to try

“Use XcodeMCP to xcode open project.”
“Use XcodeMCP to xcode get workspace info.”
“Use XcodeMCP to xcode get projects.”

Frequently asked questions

Model Context Protocol server for Xcode build automation and log parsing Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.