Verified:GitHub

xcode-mcp

Run Xcode build, test, and diagnostics workflows via the MCP bridge.

Updated Apr 9, 2026

Search Tags:#workflow #build #mcp #diagnostics #xcode #test

One-click install

npx skills add https://github.com/productengineered/parsely --skill xcode-mcp-productengineered

Or copy as Structured Prompt for Agent▼

Please help me install this Agent Skill.
Skill: xcode-mcp
Source: https://github.com/productengineered/parsely/tree/main/.claude/skills/tooling/xcode-mcp
Command: npx skills add https://github.com/productengineered/parsely --skill xcode-mcp-productengineered

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Developers need a unified, reliable bridge to manage builds, tests, previews, and diagnostics inside Xcode projects using MCP, reducing manual toggling and context switching.

Core Features & Use Cases

Build and Test: Run BuildProject and RunAllTests through the MCP bridge with fallback to shell scripts.
Diagnostics & Preview: Access XcodeListNavigatorIssues, RenderPreview, and DocumentationSearch for quick QA and API exploration.
File & Workspace Ops: Read/Write/update and file-system navigation within the Xcode project context; manage tab-based workflows per session.
Use Case: Imagine a multi-module iOS project where you need to validate builds, collect logs, and preview SwiftUI changes across multiple targets in one session.

Quick Start

Detect MCP availability and start using the MCP tools for your project workspace.

Frequently Asked Questions about xcode-mcp

High-intent search queries and answers about installing and using this skill.

FAQPage Schema

How do I run Xcode builds and tests through an MCP bridge?▼

You can run Xcode builds and tests through an MCP bridge by invoking BuildProject and RunAllTests tools, which automatically fall back to shell scripts when MCP is unavailable.

Can I use MCP to access Xcode navigator issues and SwiftUI previews?▼

Yes, MCP provides access to XcodeListNavigatorIssues for diagnostics and RenderPreview for SwiftUI changes, streamlining QA and API exploration within your active workspace.

What Xcode project setup is required to use MCP tooling for diagnostics?▼

Using MCP tooling for diagnostics requires an Xcode 26.3+ project with an active workspace and a per-session tabIdentifier to manage tab-based workflows.

What happens when MCP is unavailable during an Xcode build workflow?▼

When MCP is unavailable during an Xcode build workflow, the system enforces modular tool invocation by automatically falling back to executing shell scripts to complete the build.