TapHerd
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
# macOS and Linux
curl -LsSf https://raw.githubusercontent.com/GreenPeaas/tapherd/main/scripts/install.sh | sh
# 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
-
Connect your AI. Print the settings for your client and paste them where TapHerd says. Steps for each client
tapherd config mcp --client claude-code # or codex, claude-desktop, cursor
-
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.
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.
- QA testing. Let an agent walk through your Android app on several emulators at once.
- Store screenshots. Capture the same screens on several devices.
- Mobile-only apps. Use apps that have no web or API version.
- Your own analytics. Read numbers from your own accounts' in-app dashboards.
TapHerd only acts on devices you connect, through apps you're signed into. Its recipes only support posting to accounts you own. Acceptable use
Free and Pro
| Free (this repository, MIT) | Pro (planned) | |
|---|---|---|
| Active devices | Up to 3 | 50+ |
| AI control of any Android app | ✓ | ✓ |
| Posting recipes | 1 sample (unverified) | Maintained recipe library |
| Scheduling | Run on demand | Scheduled posting |
| Dashboard and browser control | — | Planned |
Try the interactive Pro concept or run tapherd pro to join the waitlist. The CLI shows a short Pro notice at most once a day; set TAPHERD_NO_TEASE=1 to turn it off.
Docs
Privacy
The connector runs entirely on your computer and has no telemetry. Screenshots and the optional action log stay local. TapHerd never asks for or stores passwords; you sign in to apps on the device yourself. Security and data flow · Website privacy
Help
Open an issue with the output of tapherd doctor, or email support@tapherd.info. Report security problems privately: how.
TapHerd is not affiliated with or endorsed by TikTok, Meta, Google, or X. All trademarks belong to their owners.
Metadata
Release files for tapherd 0.1.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| tapherd-0.1.1.tar.gz | 53.0 kB | Without provenance | Details for tapherd-0.1.1.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| tapherd-0.1.1-py3-none-any.whl | Python 3 | none | any | Details for tapherd-0.1.1-py3-none-any.whl |
Total release size: 95.1 kB
Release files / tapherd-0.1.1.tar.gz
| Download URL | tapherd-0.1.1.tar.gz |
|---|---|
| Size | 53.0 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
ccd8fbff9418e843c83404989c7529c869fe07654abe424733f1fb258422c02a
|
|
BLAKE2b-256 checksum How to use checksums |
99576eaa2ad65c6505f03d9208f6eb95e85066c768dfa19361a335b7b98a12de
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.13.7 {"installer":{"name":"uv","version":"0.13.7","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Release files / tapherd-0.1.1-py3-none-any.whl
| Download URL | tapherd-0.1.1-py3-none-any.whl |
|---|---|
| Size | 42.1 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
da4032ee3517a7952a8154afb96a875cf5296f2c9ae046843c312266ce28efdb
|
|
BLAKE2b-256 checksum How to use checksums |
f2febd5976d627b91bf7d05fdf173e0169e1418be1064eaafc1d67ecc9a300b5
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.13.7 {"installer":{"name":"uv","version":"0.13.7","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Security for tapherd 0.1.1
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.