G
GreenPeaas/tapherd
Your AI can now use Android apps.
updated 2026-11-19
View on GitHub ↗Direct link · no redirect page
Official descriptionYour AI can now use Android apps. Free MCP connector for Codex, Claude, and Cursor. Up to 3 devices free.
After install: how to tell it works
- What you see after install — The command exits 0 and the terminal shows no "command not found" or "permission denied".
- One-line self-check — Run the smallest usage example from that repository's README. If the output matches what the README describes, it is working.
- If that does not work — The repository README has a troubleshooting or FAQ section - look there first.
The install command comes from the repository; these checks describe observable results only and do not replace the project's own docs.
- Star count
- 0 ★ · GreenPeaas/tapherd · read from the GitHub search API · (checked 2026-11-19 20:00:48)
- Source
- read directly from its GitHub page · type: open-source project
- Harvest history
- first seen 2026-11-20 · last seen 2026-11-20 · seen 1× · listed by 2 sources
- Score
- score 203 · 2 sources · repo
- Install
- see Install & config above
FAQ (answers come from our records)
Who is it for?
We filed it under these tags: Open Source. The tags come from the entry itself, not a taxonomy we imposed.
Who maintains it?
repository
GreenPeaas/tapherd;first catalogued 2026-11-20;last seen 2026-11-20。There is no official certification or quality rating here — we record sources and dates only.README excerpt (English, untranslated) · Read the full README on GitHub →
# TapHerd
Excerpted from the repository README (abridged)
Your AI can now use Android apps.
TapHerd is a free, open-source connector that lets Codex, Claude, Cursor, or any MCP client control your Android phones and emulators. Your AI sees the screen, taps, types, opens apps, and copies media, on up to three devices for free.
Real screen recording, sped up, account names blurred: one prompt posted a scheduled video from one Pixel emulator to three platforms on 2026-11-19.
Website and illustrated guide: tapherd.info · macOS: tested · Windows and Linux: beta
## Install
You need a computer and an Android device: a free emulator from Android Studio, or your own phone with USB debugging on. How to get the emulator
sh
# macOS and Linux
curl -LsSf https://raw.githubusercontent.com/GreenPeaas/tapherd/main/scripts/install.sh | sh
powershell
# Windows (PowerShell, no administrator rights needed)
irm https://raw.githubusercontent.com/GreenPeaas/tapherd/main/scripts/install.ps1 | iex
The installer sets up uv and TapHerd for your user, offers to install Android's adb tool, and runs tapherd doctor. It explains and asks before anything that needs sudo. Read the macOS/Linux installer · Read the Windows installer
Already have uv? Run uv tool install tapherd, then tapherd doctor. For the latest code from this repository, run uv tool install git+https://github.com/GreenPeaas/tapherd instead.
tapherd doctor lists your Python, adb, and online devices, and ends with Ready when everything works. If something is missing, it tells you the next command to run.
## Your first AI-controlled tap
1. Connect your AI. Print the settings for your client and paste them where TapHerd says. Steps for each client
sh
tapherd config mcp --client claude-code # or codex, claude-desktop, cursor
2. Ask it to do something:
> Use TapHerd to list my devices. On the first one, open Settings, read the screen, tap Network & internet, and tell me what opened.
You should see Network & internet open on the device.
New to this? Follow the step-by-step guide.
### Or try it in one command with Claude Code
This uses a temporary MCP config and only the four tools it needs. tapherd config mcp also prints a reminder about where to save the config; the command below already saves it for you, so you can ignore that line.
sh
TAPHERD_FIRST_TAP_DIR=$(mktemp -d)
tapherd config mcp --client claude-code > "$TAPHERD_FIRST_TAP_DIR/mcp.json"
cd "$TAPHERD_FIRST_TAP_DIR" || exit
claude --print \
'Use only TapHerd MCP. List devices. On the first active device, open com.android.settings, use read_screen to find Network & internet, tap that row, and tell me what opened.' \
--mcp-config "$TAPHERD_FIRST_TAP_DIR/mcp.json" --strict-mcp-config \
--no-session-persistence --tools '' \
--allowedTools mcp__tapherd__list_devices mcp__tapherd__open_app \
mcp__tapherd__read_screen mcp__tapherd__tap
Menu labels can vary by Android version or language. If Settings opens on a subpage, go back to its home screen and try again.
## What it's for
Posting. Post a video to TikTok, Instagram Reels, and YouTube Shorts from your phones, with captions your AI writes. The same tools work in other apps, such as X and the main YouTube app.
TapHerd is a free, open-source connector that lets Codex, Claude, Cursor, or any MCP client control your Android phones and emulators. Your AI sees the screen, taps, types, opens apps, and copies media, on up to three devices for free.
Real screen recording, sped up, account names blurred: one prompt posted a scheduled video from one Pixel emulator to three platforms on 2026-11-19.
Website and illustrated guide: tapherd.info · macOS: tested · Windows and Linux: beta
## Install
You need a computer and an Android device: a free emulator from Android Studio, or your own phone with USB debugging on. How to get the emulator
sh
# macOS and Linux
curl -LsSf https://raw.githubusercontent.com/GreenPeaas/tapherd/main/scripts/install.sh | sh
powershell
# Windows (PowerShell, no administrator rights needed)
irm https://raw.githubusercontent.com/GreenPeaas/tapherd/main/scripts/install.ps1 | iex
The installer sets up uv and TapHerd for your user, offers to install Android's adb tool, and runs tapherd doctor. It explains and asks before anything that needs sudo. Read the macOS/Linux installer · Read the Windows installer
Already have uv? Run uv tool install tapherd, then tapherd doctor. For the latest code from this repository, run uv tool install git+https://github.com/GreenPeaas/tapherd instead.
tapherd doctor lists your Python, adb, and online devices, and ends with Ready when everything works. If something is missing, it tells you the next command to run.
## Your first AI-controlled tap
1. Connect your AI. Print the settings for your client and paste them where TapHerd says. Steps for each client
sh
tapherd config mcp --client claude-code # or codex, claude-desktop, cursor
2. Ask it to do something:
> Use TapHerd to list my devices. On the first one, open Settings, read the screen, tap Network & internet, and tell me what opened.
You should see Network & internet open on the device.
New to this? Follow the step-by-step guide.
### Or try it in one command with Claude Code
This uses a temporary MCP config and only the four tools it needs. tapherd config mcp also prints a reminder about where to save the config; the command below already saves it for you, so you can ignore that line.
sh
TAPHERD_FIRST_TAP_DIR=$(mktemp -d)
tapherd config mcp --client claude-code > "$TAPHERD_FIRST_TAP_DIR/mcp.json"
cd "$TAPHERD_FIRST_TAP_DIR" || exit
claude --print \
'Use only TapHerd MCP. List devices. On the first active device, open com.android.settings, use read_screen to find Network & internet, tap that row, and tell me what opened.' \
--mcp-config "$TAPHERD_FIRST_TAP_DIR/mcp.json" --strict-mcp-config \
--no-session-persistence --tools '' \
--allowedTools mcp__tapherd__list_devices mcp__tapherd__open_app \
mcp__tapherd__read_screen mcp__tapherd__tap
Menu labels can vary by Android version or language. If Settings opens on a subpage, go back to its home screen and try again.
## What it's for
Posting. Post a video to TikTok, Instagram Reels, and YouTube Shorts from your phones, with captions your AI writes. The same tools work in other apps, such as X and the main YouTube app.
Listed badge (optional)
Copy this line into the README if you want the listing mark. Optional, and it does not affect being listed.
[](https://anclum.com/en/s/greenpeaas-tapherd/)
- Source
- github · https://github.com/GreenPeaas/tapherd
- Browse by field
- Open source
- Listed by
- 2 independent sources
- added
- today
More entries
Filed under
Every tag opens the full list for that filter. Counts are the live catalogue figures.