GitHub - runablehq/mobile-use: Use AI to control your mobile

📱 mobile-use

Use AI to control your Android phone — with natural language.

mobile_use.mp4

✨ What is this?

mobile-use lets you control your Android phone using simple, natural-language instructions.

Just type:

🗣 “Open Instagram, go to DMs, and send ‘hi’ to the first person.”

…and watch it run on your device — powered by AI.

Think RPA, but for mobile — built for devs, hackers, and productivity nerds.

🚀 Quick Start

📦 Install via npm

Or run the MCP server (includes setup):

🧠 AI in Action

import { mobileUse } from "mobile-use";

const response = await mobileUse({
  task: "Open instagram and go to direct messages, send hi to first person",
  // Optional: use your own LLM via API
  // llm: { provider: "your-llm", apiKey: process.env.YOUR_API_KEY }
});

console.log(response.text);

Default model: Claude (via Anthropic).
Set ANTHROPIC_API_KEY in your .env or environment to use it.

🖥️ Command Line Usage

# Run a task directly from your terminal
npx mobile-use "Open Instagram and send 'hi'"

# Run a task from a file
npx mobile-use instruction.txt

📱 Requirements

Android phone or Emulator running in background(iOS not supported yet)
Android SDK Platform Tools installed (adb)(For Emulators)
USB Debugging enabled

💬 Join the Community

Have a feature idea? Want to see what others are building?

Join our developer Discord — we’re shaping the roadmap with the community!

🧩 What's Coming Next?

iOS support (experimental)
Visual workflows
Common protocol for mobiles, browsers and computers

Have ideas? We’re building it with you — hop into Discord or open a GitHub issue.

⭐ Like it?

If this project made you say "whoa!", help us grow:

⭐ Star this repo
🐦 Share on Twitter/X
💬 Invite friends to Discord

📄 License

MIT — free to use, fork, and build on.