Skip to main content

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.

Screen recording, sped up: one prompt posts a video from a Pixel emulator to YouTube Shorts, TikTok, and Instagram Reels, then deletes the copy from the phone.

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

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

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

Get started Use it Project
Step-by-step guide MCP tools Security and data flow
Setup on macOS Recipes Acceptable use
Setup on Windows (beta) Advanced MCP options Contributing
Setup on Linux (beta) Architecture Changelog
Connect your AI Troubleshooting License (MIT)

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)

Source distribution for tapherd 0.1.1
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)

Table of built distributions (wheels) for tapherd 0.1.1
File Interpreter ABI Platform Actions
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.

Release history Release notifications | RSS feed

This release

0.1.1 This release

2 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page