# agent-device MCP server

> Enables AI agents to inspect, control, and debug mobile, web, TV, and desktop applications on physical devices, simulators, and emulators.

- Repository: https://github.com/callstackincubator/agent-device
- Page: https://hostedmcp.org/servers/callstackincubator/agent-device
- Transport: stdio
- Stars: 5403
- License: MIT
- Latest version: 0.16.9

## Install

### Claude Code

```sh
claude mcp add agent-device -- npx -y agent-device
```

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

```json
{
  "mcpServers": {
    "agent-device": {
      "command": "npx",
      "args": [
        "-y",
        "agent-device"
      ]
    }
  }
}
```

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

```json
{
  "servers": {
    "agent-device": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "agent-device"
      ]
    }
  }
}
```

### VS Code CLI

```sh
code --add-mcp '{"name":"agent-device","type":"stdio","command":"npx","args":["-y","agent-device"]}'
```

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

```json
{
  "mcpServers": {
    "agent-device": {
      "command": "npx",
      "args": [
        "-y",
        "agent-device"
      ]
    }
  }
}
```

### Codex

```sh
codex mcp add agent-device -- npx -y agent-device
```

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

```toml
[mcp_servers.agent-device]
command = "npx"
args = ["-y", "agent-device"]
```

### Gemini CLI

```sh
gemini mcp add -s user agent-device npx -- -y agent-device
```

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

```json
{
  "mcpServers": {
    "agent-device": {
      "command": "npx",
      "args": [
        "-y",
        "agent-device"
      ]
    }
  }
}
```

## FAQ

### What is agent-device?

It is a command-line tool and MCP server that allows AI coding agents to inspect, control, and verify mobile apps while saving evidence for review.

### Does it work with React Native, Expo, Flutter, and native apps?

Yes, it supports native iOS and Android apps, as well as React Native, Expo, and Flutter apps on supported targets.

### Is there an MCP server for mobile app automation?

Yes, running 'agent-device mcp' starts the official stdio MCP server.

### Can I build my own agent or QA product on agent-device?

Yes, you can use the typed Node.js client to build your own agent or orchestration code.