# Oh My Android

> Oh My Android is an open-source MCP server for developer tools. Let coding agents see and drive the Android Emulator from your Mac. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** macOS
- **Website:** https://royan.se/work/oh-my-android/
- **Repository:** https://github.com/ateymoori/oh-my-android
- **MCP Registry name:** io.github.ateymoori/oh-my-android
- **Categories:** developer tools
- **Listing updated:** 2026-11-15

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
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
```

### Claude Desktop (claude_desktop_config.json)

```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"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```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"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```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"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```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"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```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"
      ]
    }
  }
}
```

## 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

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/oh-my-android
