# Mobster MCP server

> Allows AI agents to control iPhones and iOS simulators by reading screens, performing taps and typing, and running accessibility assertions.

- Repository: https://github.com/RadishSoftware/mobster
- Page: https://hostedmcp.org/servers/radishsoftware/mobster
- Transport: stdio
- Stars: 7
- License: MIT
- Latest version: 0.4.3

## Install

### Claude Code

```sh
claude mcp add mobster -- uvx mobster-cli
```

### Cursor (`~/.cursor/mcp.json`)

```json
{
  "mcpServers": {
    "mobster": {
      "command": "uvx",
      "args": [
        "mobster-cli"
      ]
    }
  }
}
```

### VS Code (`.vscode/mcp.json`)

```json
{
  "servers": {
    "mobster": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "mobster-cli"
      ]
    }
  }
}
```

### VS Code CLI

```sh
code --add-mcp '{"name":"mobster","type":"stdio","command":"uvx","args":["mobster-cli"]}'
```

### Claude Desktop (`claude_desktop_config.json`)

```json
{
  "mcpServers": {
    "mobster": {
      "command": "uvx",
      "args": [
        "mobster-cli"
      ]
    }
  }
}
```

### Codex

```sh
codex mcp add mobster -- uvx mobster-cli
```

### Codex config.toml (`~/.codex/config.toml`)

```toml
[mcp_servers.mobster]
command = "uvx"
args = ["mobster-cli"]
```

### Gemini CLI

```sh
gemini mcp add -s user mobster uvx -- mobster-cli
```

### Gemini settings.json (`~/.gemini/settings.json`)

```json
{
  "mcpServers": {
    "mobster": {
      "command": "uvx",
      "args": [
        "mobster-cli"
      ]
    }
  }
}
```

## FAQ

### What hardware and software is required to run Mobster?

Running a device requires macOS and Xcode, and the server requires Python 3.12 or later.

### Can I use Mobster with Claude Code or Cursor?

Yes, Mobster lets Claude Code, Cursor, and Codex drive a real iPhone or iOS simulator via MCP.
