Mobilerun

MCP Server

Give your AI agent control of Android devices with the Mobilerun MCP server.
Control devices, run agent tasks, manage apps, and build workflows on Mobilerun Cloud from any MCP client.

🔐 Hosted MCP endpoint — sign in with OAuth, no API key

https://cloud.mobilerun.ai/api/mcp

• 📱 List, create, and manage Android devices
• 📸 Inspect screenshots and UI state; tap, swipe, and type
• 🤖 Run agent tasks and chat with the Mobilerun Assistant
• 📦 Manage apps, device files, and settings
• 🔀 Build workflows with actions, triggers, and webhooks
• 🔑 Sign in with OAuth — no API key to copy, nothing to install for the hosted endpoint
• 🛠️ Open source and self-hostable

🚀 Quickstart

Connect to https://cloud.mobilerun.ai/api/mcp. Your first connection opens browser sign-in with your Mobilerun account (OAuth 2.1 + PKCE with dynamic client registration). No API key needed.

Claude Code

claude mcp add --transport http mobilerun https://cloud.mobilerun.ai/api/mcp

Run /mcp inside Claude Code to sign in.

Codex CLI

codex mcp add mobilerun --url https://cloud.mobilerun.ai/api/mcp
codex mcp login mobilerun

Cursor / VS Code

Click the install badge above and sign in when prompted. For manual Cursor setup, use the mcpServers JSON under Any other MCP client below.

{
  "servers": {
    "mobilerun": {
      "type": "http",
      "url": "https://cloud.mobilerun.ai/api/mcp"
    }
  }
}

Claude Desktop / claude.ai

Add a custom connector with this URL, then sign in:

https://cloud.mobilerun.ai/api/mcp

Any other MCP client

Add a remote HTTP server using your client's settings. For clients using mcpServers (including Cursor):

{
  "mcpServers": {
    "mobilerun": {
      "url": "https://cloud.mobilerun.ai/api/mcp"
    }
  }
}

💬 Try it

• “List my Mobilerun devices.”
• “Open Settings on my device and turn on dark mode.”
• “Take a screenshot of my device and describe what's on screen.”
• “Ask the Mobilerun assistant which of my devices are ready.”

🧰 Tools

The available tools and operations depend on the server's policy and your account permissions.

Some tools create billed resources (for example create_device, proxy purchases, or work the assistant does for you). Charges apply to the signed-in account. Only approve an assistant permission after the user explicitly confirms it.

🔑 API key (CI and headless)

For clients that cannot use OAuth, connect to https://api.mobilerun.ai/v1/mcp with an Authorization: Bearer dr_sk_... header. Create a key in Mobilerun Cloud; see API keys.

{
  "mcpServers": {
    "mobilerun": {
      "url": "https://api.mobilerun.ai/v1/mcp",
      "headers": {
        "Authorization": "Bearer dr_sk_YOUR_KEY"
      }
    }
  }
}

claude mcp add --transport http mobilerun https://api.mobilerun.ai/v1/mcp --header "Authorization: Bearer dr_sk_YOUR_KEY"

🛠️ Self-hosting & development

packages/tools contains the auth-agnostic tool core; packages/server provides the API-key HTTP and stdio transports. Run pnpm install && bun test to get started. See the server reference for setup, configuration, policies, and operation details. The roadmap describes the architecture; the tool contract covers compatibility and versioning.

🤝 Contributing

See CONTRIBUTING.md to get started.

🔒 Security

Report vulnerabilities using SECURITY.md.

📄 License

Licensed under Apache-2.0.