agent-device
Mobile app automation and verification for AI coding agents. CLI, MCP server, and typed Node.js API for iOS, Android, HarmonyOS, TV, web, macOS, and Linux.
agent-device is an MCP server, CLI tool, and Node.js API that enables AI coding agents to automate, inspect, and verify mobile and desktop applications. It provides agents with accessibility-tree snapshots, element interaction capabilities, and diagnostic tools for iOS, Android, HarmonyOS, tvOS, web, macOS, and Linux platforms. Agents read token-efficient accessibility data instead of relying solely on screenshots, execute interactions through refs and selectors, and capture evidence like logs, traces, and performance profiles for review.
Key Features
Use Cases
- 01AI coding agents verifying UI changes in running mobile apps on simulators, emulators, or physical devices
- 02Automated bug reproduction with diagnostic logs, crash details, and performance traces
- 03Pull request validation with screenshots and evidence attached by AI agents
- 04Recording agent exploration sessions as replay scripts for CI/CD pipeline execution
- 05Detecting React Native performance issues and unnecessary re-renders during development
- 06Cross-platform app testing workflows coordinated by AI agents across iOS, Android, and web
Related MCP Servers
View moremarkitdown
Python tool for converting files and office documents to Markdown.
firecrawl
The context API to search, scrape, and interact with the web at scale. 🔥
prompts.chat
f.k.a. Awesome ChatGPT Prompts. Share, discover, and collect prompts from the community. Free and open source — self-host for your organization with complete privacy.
langflow
Langflow is a powerful tool for building and deploying AI-powered agents and workflows.
agent-device — FAQ
What is agent-device?+
agent-device is a command-line tool, MCP server, and Node.js API that enables AI coding agents to inspect, control, and verify mobile and desktop applications across iOS, Android, HarmonyOS, TV platforms, web, macOS, and Linux. It provides accessibility-based inspection, element interactions, and diagnostic evidence capture.
How do I install the agent-device MCP server?+
Install the CLI globally with npm install -g agent-device@latest, then add the MCP server configuration to your AI client's settings with command 'agent-device' and args ['mcp']. Requires Node.js 22.12 or newer (Node.js 24+ for web automation).
Which AI clients work with agent-device?+
agent-device works with Claude Code, Codex, Cursor, Windsurf, Cline, Goose, and any agent that supports MCP protocol or can run CLI commands. It also integrates with the Vercel AI SDK and Eve for custom agent development.
Do I need API keys or device setup?+
No API keys are required. You need the target platform development tools installed (Xcode for iOS/tvOS, Android SDK for Android, HarmonyOS SDK for HarmonyOS, etc.) and configured simulators, emulators, or physical devices. Run agent-device doctor to verify your setup.
Is agent-device free and open source?+
Yes, agent-device is open source under the MIT license and free to use. It is developed by Callstack and available on npm and GitHub.
Can agent-device run in CI/CD pipelines?+
Yes, you can record agent workflows as .ad replay scripts and execute them in CI/CD environments. The project provides an EAS workflow template for automated testing with artifact capture of screenshots and logs.
How do I install agent-device?+
Open the source repository on GitHub and follow its README. agent-device is a mcp server — MCP Agents Market links you directly to the official repo.
Is agent-device free?+
agent-device is an open-source project hosted on GitHub. Check the repository for its license and any usage requirements.