WebDriverIO MCP · webdriverio — Claude Code server: browser and mobile automation
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.
MIT ★ 45 updated 2026-10-21
claude mcp add mcp -- npx -y @wdio/mcpWhat mcp 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.
What it helps with
- 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 for the agent
- Open
google.comin Chrome and click the search button - Launch
com.example.appon iOS simulator and check the login screen - Take a screenshot of the homepage in Firefox
How to install mcp
Platform CLI
claude mcp add mcp -- npx -y @wdio/mcpPlatform CLI
codex mcp add webdriverio-mcp -- npx -y @wdio/mcpConfig file
{
"mcpServers": {
"webdriverio-mcp": {
"command": "npx",
"args": [
"-y",
"@wdio/mcp"
]
}
}
}Config file
{
"servers": {
"webdriverio-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@wdio/mcp"
]
}
}
}Platform CLI
gemini mcp add webdriverio-mcp npx -y @wdio/mcpStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about mcp
How to install WebDriverIO MCP in Claude Code?
Run claude mcp add mcp -- npx -y @wdio/mcp, then restart the client.
What does WebDriverIO MCP do?
Connects WebdriverIO to your agent: opens browsers, controls web pages and mobile apps on iOS and Android.
What do I need for mobile app automation?
Install Appium globally (npm install -g appium), add the platform driver (appium driver install xcuitest for iOS or appium driver install uiautomator2 for Android), start the Appium server with appium. iOS requires Xcode, Android requires Android Studio.
Similar MCP servers
All MCP servers for Testing and QA →mcp by other authors comes first.