# ios-agent-skill

Give a coding agent Apple references and simulator tools to build SwiftUI apps or review Swift in an existing iOS project.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 40
- Author: Nagarjuna2997
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/Nagarjuna2997/ios-agent-skill
- Updated: 2026-10-22
- HTML: https://affpapa.org/en/nevibecode/mcp/ios-agent-skill

## What it does

The server connects an agent to local Apple documentation, Swift review support, and iOS Simulator tools. For a new app, `/ios-build` plans the project, writes SwiftUI code and an Xcode project, then builds and launches it in the simulator.

On a Mac, Claude Code needs Xcode 16 or later for this workflow. XcodeGen is optional; without it, the agent creates the Xcode project itself. Some capabilities depend on service accounts and keys. Until keys are configured, generated placeholders let the app build while it displays a configuration message. Device builds and publishing require Apple Developer Program membership.

## Requirements
- Needs: Node.js (commands run via npx)

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add ios-agent-skill -- npx -y ios-agent-mcp
```

### Codex

**Platform CLI**
```bash
codex mcp add ios-agent-skill -- npx -y ios-agent-mcp
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "ios-agent-skill": {
            "command": "npx",
            "args": [
                "-y",
                "ios-agent-mcp"
            ]
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "ios-agent-skill": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "ios-agent-mcp"
            ]
        }
    }
}
```

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add ios-agent-skill npx -y ios-agent-mcp
```

## When to use it
- scaffold an iOS app from a description
- write SwiftUI code and an Xcode project
- build and launch an app in the simulator
- review Swift in an existing project

## Example prompts
- Build a habit tracker with a list screen and settings using `/ios-build`
- Create a searchable notes app and run it in the simulator with `/ios-build`
- Review the Swift code in my iOS project

## Similar
- [mobile-mcp](https://affpapa.org/en/nevibecode/mcp/mobile-mcp.md) — MCP server · ★ 9946
- [mobilerun](https://affpapa.org/en/nevibecode/mcp/mobilerun.md) — MCP server · ★ 9751
- [e2e](https://affpapa.org/en/nevibecode/mcp/e2e.md) — MCP server · ★ 11912
- [XcodeBuildMCP](https://affpapa.org/en/nevibecode/mcp/xcodebuildmcp.md) — MCP server · ★ 6505
- [ShipSwift](https://affpapa.org/en/nevibecode/mcp/shipswift.md) — MCP server · ★ 3244
- [agent-device](https://affpapa.org/en/nevibecode/mcp/agent-device.md) — MCP server · ★ 5149

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md