📱 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

npm install mobile-use

Or run the MCP server (includes setup):

npx mobile-mcp install

---

🧠 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.

---

🙌 Built with love for devs by devs