Skip to content
MCP server

Oh My Android

Let coding agents see and drive the Android Emulator from your Mac

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
macOS
Runs
Locally
Version
0.4.6
Listing updated
2 days ago

About Oh My Android

Oh My Android is an open-source MCP server for developer tools. It runs locally on your machine and is started by your AI client.

The MCP server is one part of Oh My Android, a native SwiftUI Mac app that docks beside the Android Emulator and replaces common adb chores with one-click toggles. The server lets an agent do the same things: take a screenshot, read the UI tree in dp, tap and type, switch dark mode or RTL, and read logcat and the app's database.

The site says the UI tree is about ten times smaller than raw uiautomator XML and that all 18 tool definitions fit in about 3k tokens. Access is set to Off, Read only or Full control and is checked on every call. It ships as one native binary with no runtime and no network use, and the project reports no telemetry.

It companions Android Studio rather than replacing it: it bundles no emulator or SDK and uses the one you already have. It also works with real phones over adb for the actions that apply.

Install

Run in a terminal

claude mcp add oh-my-android -- npx -y https://github.com/ateymoori/oh-my-android/releases/download/v0.4.6/oh-my-android-0.4.6.mcpb

Add to claude_desktop_config.json

{
  "mcpServers": {
    "oh-my-android": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/ateymoori/oh-my-android/releases/download/v0.4.6/oh-my-android-0.4.6.mcpb"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "oh-my-android": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/ateymoori/oh-my-android/releases/download/v0.4.6/oh-my-android-0.4.6.mcpb"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "oh-my-android": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/ateymoori/oh-my-android/releases/download/v0.4.6/oh-my-android-0.4.6.mcpb"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "oh-my-android": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/ateymoori/oh-my-android/releases/download/v0.4.6/oh-my-android-0.4.6.mcpb"
      ]
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "oh-my-android": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/ateymoori/oh-my-android/releases/download/v0.4.6/oh-my-android-0.4.6.mcpb"
      ]
    }
  }
}

What it does

Screenshots and UI tree
Agents see the screen and a compact UI tree measured in dp.
Eighteen tools
The site says 18 tools covering tap, type, appearance and logs.
Access levels
Off, Read only or Full control, checked on every call.
Control panel app
Dark mode, font scale, RTL, TalkBack, network speed and GPS in one click.
Layout Inspector
Measure any screen in dp and compare with a Figma export.
Accessibility audit
Checks TalkBack order and touch targets under 48 dp.

Good for

  • Have an agent build a screen, run it and fix what it sees
  • Test a layout in RTL and large fonts
  • Throttle the network to 3G for a test
  • Read logcat after a crash

Pricing

Open source

Free, MIT license

Prices change. Check royan.se before you buy.

Oh My Android FAQ

What does it need?

macOS 26 Tahoe or later on Apple silicon, plus the Android SDK you already have.

Is it free?

Yes, free and open source under the MIT license.

Does it work with a real phone?

Yes, over USB or Wi-Fi adb, though emulator-only actions such as GPS and battery do not apply.

How do I add it to Claude Code?

Run claude mcp add --scope user oh-my-android -- ohmyandroid-mcp.

Is Oh My Android free?

Yes. Oh My Android is open source, so you can use and self-host it for free.

How do I add Oh My Android to Claude Code?

Run this command in your terminal: claude mcp add oh-my-android -- npx -y https://github.com/ateymoori/oh-my-android/releases/download/v0.4.6/oh-my-android-0.4.6.mcpb

What are the best alternatives to Oh My Android?

The closest alternatives to Oh My Android are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

Alternatives to Oh My Android

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  3. GitHub

    MCP server

    Official MCP server connecting AI assistants to GitHub repos, issues and workflows

    Not checked yet
    • Remote
    • Open source
    • 34.5K GitHub stars
    • Developer tools
  4. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools
  5. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  6. Ouroboros

    MCP server

    Spec-first layer that pins requirements and verifies results of AI coding agent work

    Runs locally
    • Open source
    • 6.4K GitHub stars
    • Developer tools