# agent-device MCP server

> Enables AI agents to inspect, control, and verify mobile, web, TV, and desktop applications through accessibility snapshots and interactive commands.

- Repository: https://github.com/callstack/agent-device
- Page: https://hostedmcp.org/servers/callstack/agent-device
- Official: yes
- Transport: stdio
- Stars: 5403
- License: MIT
- Latest version: 0.21.37

## 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 platforms.

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

Yes, running 'agent-device mcp' starts the official stdio MCP server which exposes commands as structured tools.

### 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 agents or orchestration code.
