Allows AI agents to interact with real Android phones through screen viewing, element reading, tapping, typing, and running workflows.
Also known as benchfleet/benchfleet-mcp, benchfleet-mcp
- Stars
- 0
- Tools
- —
- Downloads, 30 days
- —
- Latest version
- 1.0.4
- Last commit
- Oct 17, 2026
- License
- —
What is BenchFleet MCP?
BenchFleet allows AI agents to interact with real Android phones through screen viewing, element reading, tapping, typing, and running workflows.
Summary generated from the project's README
About BenchFleet MCP server
BenchFleet acts as a bridge between AI agents and physical Android devices. It connects MCP clients like Claude Desktop, Cursor, and Claude Code to the BenchFleet control hub, which is a self-hosted application running on your computer. This setup allows an agent to interact with real phones by viewing screens, reading UI elements, and performing physical actions like tapping or typing.
Users must install the BenchFleet app and generate a unique token to establish the connection. The server functions as a thin connector that forwards messages to the local app, ensuring that all permissions and phone management remain within the BenchFleet environment. You can control specific capabilities, such as choosing between look-only access or full operation, and you can monitor every action through an audit log.
Security is managed through granular tool access and manual approvals for sensitive tasks. The server provides specific tools including list_devices, get_ui_tree, tap_element, and run_workflow. It also includes a type_secret tool that retrieves passwords from a vault without exposing the actual values to the AI client.
What you can do with it
- 1Automate mobile app testingAn AI agent can navigate through an application by interacting with specific UI elements and reading the screen content.
- 2Securely handle sensitive credentialsAn agent can enter passwords during a workflow without ever seeing the actual text of the password.
Written from the project's README. Every use case is checked against a quote from it.
How to install BenchFleet MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall BenchFleet MCP in Claude Code
$ claude mcp add --env 'BENCHFLEET_TOKEN=<YOUR_BENCHFLEET_TOKEN>' benchfleet-mcp -- npx -y benchfleet-mcpInstall BenchFleet MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"benchfleet-mcp": {
"command": "npx",
"args": [
"-y",
"benchfleet-mcp"
],
"env": {
"BENCHFLEET_TOKEN": "<YOUR_BENCHFLEET_TOKEN>"
}
}
}
}Install BenchFleet MCP in VS Code
.vscode/mcp.json
{
"servers": {
"benchfleet-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"benchfleet-mcp"
],
"env": {
"BENCHFLEET_TOKEN": "<YOUR_BENCHFLEET_TOKEN>"
}
}
}
}Install BenchFleet MCP in VS Code CLI
$ code --add-mcp '{"name":"benchfleet-mcp","type":"stdio","command":"npx","args":["-y","benchfleet-mcp"],"env":{"BENCHFLEET_TOKEN":"<YOUR_BENCHFLEET_TOKEN>"}}'Install BenchFleet MCP in Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"benchfleet-mcp": {
"command": "npx",
"args": [
"-y",
"benchfleet-mcp"
],
"env": {
"BENCHFLEET_TOKEN": "<YOUR_BENCHFLEET_TOKEN>"
}
}
}
}Install BenchFleet MCP in Codex
$ codex mcp add benchfleet-mcp --env 'BENCHFLEET_TOKEN=<YOUR_BENCHFLEET_TOKEN>' -- npx -y benchfleet-mcpInstall BenchFleet MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.benchfleet-mcp] command = "npx" args = ["-y", "benchfleet-mcp"] [mcp_servers.benchfleet-mcp.env] BENCHFLEET_TOKEN = "<YOUR_BENCHFLEET_TOKEN>"
Install BenchFleet MCP in Gemini CLI
$ gemini mcp add -s user -e 'BENCHFLEET_TOKEN=<YOUR_BENCHFLEET_TOKEN>' benchfleet-mcp npx -- -y benchfleet-mcpInstall BenchFleet MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"benchfleet-mcp": {
"command": "npx",
"args": [
"-y",
"benchfleet-mcp"
],
"env": {
"BENCHFLEET_TOKEN": "<YOUR_BENCHFLEET_TOKEN>"
}
}
}
}Configuration
BENCHFLEET_TOKENRequiredSecretThe token from BenchFleet: Settings → AI clients → Connect an AI client
| Name | Description | |
|---|---|---|
| BENCHFLEET_TOKEN | The token from BenchFleet: Settings → AI clients → Connect an AI client | RequiredSecret |
Automated checks
Ran Nov 14, 2026Full report →Passed our automated checks. That is not a security audit: read the code and give the server the narrowest access it needs. How checks work · What to fix for more points
- Source repository linked and reachablebenchfleet/benchfleet-mcp is public and reachablegithub.com/benchfleet/benchfleet-mcp ↗Pass
- Package names this repository as its sourcebenchfleet-mcp names benchfleet/benchfleet-mcp as sourcenpmjs.com/package/benchfleet-mcp ↗Pass
- Build provenance (Sigstore attestation)No build attestation published for this releaseNot checked
- Open source license (OSI)No licenseFinding
- Commit or release in the last yearLast commit or release 2026-10-17github.com/benchfleet/benchfleet-mcp ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNo popular package one edit away from benchfleet-mcpPass
- No critical advisory in the package or its dependencies1 resolved dependencies checked; no critical advisoryosv.dev ↗Pass
- No hidden instructions to the model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNot checked
- Remote endpoint answers the MCP handshakeNot checked
README
View on GitHubbenchfleet-mcp
Let AI agents use your real Android phones, safely. benchfleet-mcp connects Claude Code, Codex, Cursor, Claude
Desktop and any other MCP client to BenchFleet, the
self-hosted control hub for real Android phones. The agent can list your phones, look at their screens, read the
elements on them, tap, type, open apps and run your published workflows — only on the phones and with the actions
you allow, with approvals for anything sensitive and every step in BenchFleet's audit log.
It is a thin connector: it forwards MCP messages to the BenchFleet app running on the same computer and reaches nothing else. The tools, the permissions and the phones are all in the app.
Set up
-
Install BenchFleet from https://benchfleet.com/download and connect your phones (or use its demo phones).
-
In BenchFleet: Settings → AI clients → Connect an AI client…, choose what the client may do (Look only, Look and operate, or chosen capabilities) and on which phones, and copy the token it shows once.
-
Add the server to your client:
Claude Code
claude mcp add benchfleet --env BENCHFLEET_TOKEN=<token> -- npx -y benchfleet-mcpCodex (
~/.codex/config.toml)[mcp_servers.benchfleet] command = "npx" args = ["-y", "benchfleet-mcp"] env = { BENCHFLEET_TOKEN = "<token>" }Claude Desktop, Cursor and other clients (
mcpServers){ "mcpServers": { "benchfleet": { "command": "npx", "args": ["-y", "benchfleet-mcp"], "env": { "BENCHFLEET_TOKEN": "<token>" } } } }
The app must be running. Disconnect in BenchFleet stops the token at once.
Tools
list_devices, get_device, get_screen, get_ui_tree, find_element, read_text, wait_for, tap_element,
long_press_element, type_text, type_secret (a password from BenchFleet's vault, never its value), swipe,
scroll_to, press_key, launch_app, stop_app, take_screenshot, get_device_logs, list_workflows,
run_workflow, queue_task (a workflow, or a goal in plain words for the phones' AI agents), get_task_status,
pause_device, resume_device, request_manual_control. A client sees only the tools its access allows. There is
no shell, file transfer or install tool. A phone a person is controlling, a paused phone and a phone without
Automation allowed refuse every action; CAPTCHAs and other human-only checks stop the agent and ask a person.
Settings
| Variable | Meaning |
|---|---|
BENCHFLEET_TOKEN |
Required: the client's token from the app (CONTROLHUB_TOKEN also works) |
BENCHFLEET_URL |
Optional: the app's address, when it is not found in its data folder |
CONTROLHUB_HOME |
Optional: the app's data folder, when it is not the default one |
Plans: AI clients need BenchFleet Pro or Team (https://benchfleet.com/pricing); the personal edition has no limits. Support: support@benchfleet.com.
Use it in Claude Code as a plugin
/plugin marketplace add benchfleet/benchfleet-mcp
/plugin install benchfleet@benchfleet-plugins
Set BENCHFLEET_TOKEN in your environment first (the token from BenchFleet: Settings → AI clients).
Use it in Gemini CLI
gemini extensions install https://github.com/benchfleet/benchfleet-mcp
BenchFleet MCP questions
How do I add BenchFleet MCP to Claude Code?
Run claude mcp add --env 'BENCHFLEET_TOKEN=<YOUR_BENCHFLEET_TOKEN>' benchfleet-mcp -- npx -y benchfleet-mcp in your terminal. Add --scope user to make it available in every project.
How do I add BenchFleet MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
How do I set up BenchFleet with Claude Code?
You can add it using the command: claude mcp add benchfleet --env BENCHFLEET_TOKEN=<token> -- npx -y benchfleet-mcp.
Can the AI agent access sensitive information like passwords?
The agent can use the type_secret tool to enter passwords from BenchFleet's vault without ever seeing the actual value.
What happens if the agent encounters a CAPTCHA?
CAPTCHAs and other human-only checks will stop the agent and require a person to intervene.
Does this server provide shell access or file transfers?
No, the server does not include shell, file transfer, or install tools; it only provides the specific tools allowed by the permissions.