# mcp

mcp runs WebdriverIO from your agent to automate web pages and mobile apps. Useful when you need to test interfaces or run scenarios in Chrome, Safari, iOS or Android.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 45 repo stars
- Author: webdriverio
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/webdriverio/mcp
- Updated: 2026-10-21
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/webdriverio-mcp

## What it does

Gives the agent access to WebdriverIO: opens browsers, controls page elements, launches apps on simulators and real devices. Supports Chrome, Firefox, Edge, Safari, Electron, iOS and Android through a single interface. Web automation works out of the box; mobile platforms require Appium with xcuitest or uiautomator2 drivers.

iOS needs Xcode, Android needs Android Studio. Appium must run separately on port 4723. Without it, mobile app interactions will fail.

Supports stdio or HTTP transport. The latter is for clients that cannot spawn subprocesses. Works with cloud platforms BrowserStack, Sauce Labs, LambdaTest, TestingBot and Digital.ai Testing.

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

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add mcp -- npx -y @wdio/mcp
```

### Codex

**Platform CLI**
```bash
codex mcp add webdriverio-mcp -- npx -y @wdio/mcp
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "webdriverio-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "@wdio/mcp"
            ]
        }
    }
}
```

### GitHub Copilot

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

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add webdriverio-mcp npx -y @wdio/mcp
```

## When to use it
- run E2E scenarios across multiple browsers
- test mobile app on iOS or Android devices
- click elements, fill forms, capture page screenshots
- execute one test on BrowserStack cloud devices
- verify interface behavior in Safari and Chrome

## Example prompts
- Open `google.com` in Chrome and click the search button
- Launch `com.example.app` on iOS simulator and check the login screen
- Take a screenshot of the homepage in Firefox

## Similar
- [browser-automation](https://affpapa.org/en/nevibecode/skills/coco-research-browser-automation.md) — skill · ★ 328 repo stars
- [momentic-spec](https://affpapa.org/en/nevibecode/skills/momentic-spec.md) — skill · 28300 installs
- [Momentic](https://affpapa.org/en/nevibecode/mcp/momentic.md) — MCP server · ★ 17 repo stars
- [shaft-mcp](https://affpapa.org/en/nevibecode/mcp/shaft-mcp.md) — MCP server · ★ 422 repo stars
- [call-draft](https://affpapa.org/en/nevibecode/prompts/call-draft.md) — prompt · ★ 1754 repo stars
- [mobile-testing](https://affpapa.org/en/nevibecode/skills/mobile-testing.md) — skill · 177 installs

## Other versions with the same name
- [mcp · kubeshark](https://affpapa.org/en/nevibecode/mcp/kubeshark-mcp.md) — ★ 12142 repo stars
- [mcp · butterbase-ai](https://affpapa.org/en/nevibecode/mcp/butterbase-ai-mcp.md) — ★ 3033 repo stars
- [mcp · medplum](https://affpapa.org/en/nevibecode/mcp/mcp.md) — ★ 2812 repo stars
- [mcp · sceneview](https://affpapa.org/en/nevibecode/mcp/sceneview-mcp.md) — ★ 1379 repo stars
- [mcp · buoy-gg](https://affpapa.org/en/nevibecode/mcp/buoy-gg-mcp.md) — ★ 696 repo stars

---
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
