Ramus Android MCP server
Commit Nov 7, 2026Provides disposable cloud Android emulators that allow AI agents to run APKs, interact with UI elements, take screenshots, and read system logs.
Also known as ramus-dev/android-use, android-use
- Stars
- 4
- Tools
- —
- Downloads, 30 days
- —
- Latest version
- 0.2.0
- Last commit
- Nov 7, 2026
- License
- MIT
What is Ramus Android MCP?
Ramus Android provides disposable cloud Android emulators that allow AI agents to run APKs, interact with UI elements, take screenshots, and read system logs.
Summary generated from the project's README
About Ramus Android MCP server
Ramus Android provides disposable cloud-based Android emulators designed specifically for AI coding agents. It allows agents to interact with mobile environments by running APKs and performing actions through a series of specialized tools. Users can connect via a remote MCP server using a streamable HTTP connection, which requires a Ramus API key for authentication. The system is compatible with various clients including Claude Desktop, Cursor, Windsurf, and Gemini CLI.
Developers use this server to implement an observe, act, and verify loop. The server exposes android_ prefixed tools that enable an agent to start sessions, snapshot the UI tree, tap, type, press, take screenshots, and read system logs. While the remote MCP server handles tool execution, the accompanying CLI is necessary for local APK uploads and managing the development loop. The emulators run stock Google images on the Ramus fleet and stream the interface via WebRTC.
What you can do with it
- 1Automated UI testingAn AI agent can interact with mobile elements to verify application behavior.
- 2Remote emulator controlAn agent can perform manual-style inputs like typing or tapping on a cloud device.
Written from the project's README. Every use case is checked against a quote from it.
How to install Ramus Android MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall Ramus Android MCP in Claude Code
$ claude mcp add --transport http android-use https://api.ramus.dev/api/mcpInstall Ramus Android MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"android-use": {
"url": "https://api.ramus.dev/api/mcp"
}
}
}Install Ramus Android MCP in VS Code
.vscode/mcp.json
{
"servers": {
"android-use": {
"type": "http",
"url": "https://api.ramus.dev/api/mcp"
}
}
}Install Ramus Android MCP in VS Code CLI
$ code --add-mcp '{"name":"android-use","type":"http","url":"https://api.ramus.dev/api/mcp"}'Install Ramus Android MCP in Codex
$ codex mcp add android-use --url https://api.ramus.dev/api/mcpInstall Ramus Android MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.android-use] url = "https://api.ramus.dev/api/mcp"
Install Ramus Android MCP in Gemini CLI
$ gemini mcp add -s user --transport http android-use https://api.ramus.dev/api/mcpInstall Ramus Android MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"android-use": {
"url": "https://api.ramus.dev/api/mcp",
"type": "http"
}
}
}Automated checks
Ran Nov 14, 2026Full report →Not verified yet. A server needs a score of 80, no serious finding, and enough data for us to check. How checks work · What to fix for more points
- Source repository linked and reachableramus-dev/android-use is public and reachablegithub.com/ramus-dev/android-use ↗Pass
- Package names this repository as its sourceNot checked
- Build provenance (Sigstore attestation)Not checked
- Open source license (OSI)MITspdx.org/licenses/MIT.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-11-07github.com/ramus-dev/android-use ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNot checked
- No critical advisory in the package or its dependenciesNot checked
- 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 handshakeHTTPS endpoint answered 401 (sign-in required)Pass
README
View on GitHubRamus android-use
Android-use for coding agents, powered by Ramus. Give Claude Code, Codex, Cursor, Gemini CLI or any agent with a shell a disposable cloud Android emulator it can see, tap, type on, screenshot and read logs from, then watch or take over in your browser.
This plugin connects to the Ramus hosted service. It needs a Ramus account (free during alpha) or a 60-minute CLI trial.
Install
Claude Code, as a plugin (the android-use skill plus the Ramus MCP server; you are asked for an optional API key):
/plugin marketplace add ramus-dev/android-use
/plugin install ramus@ramus
Cursor, Codex, GitHub Copilot, Kiro and other Agent Plugins clients: install this repository as a plugin (plugin.json at the root).
Any agent that supports skills, via the skills CLI:
npx skills add ramus-dev/android-use
Claude Code, by hand: copy skills/android-use/SKILL.md to .claude/skills/android-use/SKILL.md.
Gemini CLI, as an extension (bundles the skill and the Ramus MCP server):
gemini extensions install https://github.com/ramus-dev/android-use
Any MCP client (Cline, Claude Desktop, Cursor, Windsurf, VS Code), as a remote server. Streamable HTTP, no local process:
{
"mcpServers": {
"ramus": {
"url": "https://api.ramus.dev/api/mcp",
"headers": { "Authorization": "Bearer <RAMUS_API_KEY>" }
}
}
}
Create the key at https://ramus.dev/settings. The server exposes android_* tools (start a session from a demo app or pull request, snapshot the UI tree, tap, type, press, wait, screenshot, logs, share); list them with tools/list. Local APK upload and the dev loop need the CLI below.
The trial needs no account:
npx ramus-cli trial
npx ramus-cli session start --apk app-debug.apk --wait
ChatGPT and Codex (OpenAI plugin)
The same repository is the OpenAI plugin package: plugin.json carries the
directory listing under extensions.com.openai, mcp.json points at the
remote MCP server (people connect by signing in to Ramus; no API key), and
the skills declare where they run in skills/*/agents/openai.yaml.
The OpenAI package ships only android-mcp (MCP tools, ChatGPT and Codex):
android-use drives the CLI through the shell, which OpenAI's skill scan
flags, so the OpenAI packaging workflow leaves it out.
Maintainers can build the upload for the OpenAI plugin portal ("With MCP" path) using the manual Package OpenAI plugin workflow:
- Open Actions → Package OpenAI plugin → Run workflow and choose the branch or tag to package.
- After it succeeds, download the ramus-openai-upload artifact from the run and unpack it.
- Upload the enclosed
ramus-openai-plugin.zipto the OpenAI plugin portal.
The workflow checks the listing against OpenAI's limits and packages only
the OpenAI manifest, MCP configuration, license, logo and android-mcp skill.
It runs only in GitHub Actions when a maintainer requests an upload; the
installed plugin does not run the packaging code.
How it works
The device is a real Android emulator running stock Google images on the Ramus fleet, streamed over WebRTC. The skill teaches the agent the observe, act, verify loop: read a snapshot of the UI tree, act on a referenced element, then check the result before moving on.
Links
-
Agent reference: https://ramus.dev/agents.md
-
MCP endpoint (Streamable HTTP, API key): https://api.ramus.dev/api/mcp
-
CLI on npm: https://www.npmjs.com/package/ramus-cli
-
Privacy policy: https://ramus.dev/privacy
-
Terms: https://ramus.dev/terms
-
Acceptable use: https://ramus.dev/acceptable-use
-
Support: hello@ramus.dev · Security: security@ramus.dev
Android only. Free during alpha. For testing apps you build or are authorized to test.
SKILL.md is generated from the Ramus product contracts; the canonical copy is served at https://ramus.dev/skill.md.
Ramus Android MCP questions
How do I add Ramus Android MCP to Claude Code?
Run claude mcp add --transport http android-use https://api.ramus.dev/api/mcp in your terminal. Add --scope user to make it available in every project.
How do I add Ramus Android MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
How can I use Ramus with an MCP client like Claude Desktop or Cursor?
You can connect as a remote server using the streamable HTTP endpoint by providing your Ramus API key in the headers.