xcode-mcp-workflow

xcode-mcp-workflow is a single-skill Claude Code plugin that teaches the agent to stay inside the Xcode MCP toolchain whenever work is happening inside an open Xcode workspace.

It improves behavior for tasks like project navigation, project-scoped search, file reads and edits, builds, diagnostics, targeted tests, SwiftUI preview rendering, and Swift snippet execution.

Why this plugin exists

Without a focused workflow skill, agents often fall back to shell habits such as raw filesystem search, cat, rg, or generic build commands even when an Xcode MCP server is available and can provide better context. This plugin makes the MCP-first workflow explicit and discoverable.

What gets installed

• One skill: xcode-mcp-workflow
• UI metadata in agents/openai.yaml for skill discovery and invocation
• Claude plugin metadata in .claude-plugin/plugin.json
• A self-hosted marketplace catalog in .claude-plugin/marketplace.json

Installation

Claude Code via self-hosted marketplace

/plugin marketplace add leepepe/xcode-mcp-workflow
/plugin install xcode-mcp-workflow@xcode-mcp-workflow

Claude Code via local path

cc --plugin-dir /absolute/path/to/xcode-mcp-workflow

Searchability

The plugin manifest and skill metadata include search terms for:

• Xcode MCP
• Swift and SwiftUI
• iOS and macOS projects
• Builds, tests, diagnostics, previews, and snippet execution

That improves discovery in plugin marketplaces and in-product skill search.

Requirements

• Claude Code with plugin support
• An available Xcode MCP server
• An open Xcode workspace or project when invoking the workflow

Repository layout

xcode-mcp-workflow/
├── .claude-plugin/
│   ├── marketplace.json
│   └── plugin.json
├── skills/
│   └── xcode-mcp-workflow/
│       ├── agents/
│       │   └── openai.yaml
│       └── SKILL.md
├── LICENSE
└── README.md

License

MIT