tailshell

GitHub

Pair an Android phone over your tailnet and get an MCP URL for it.

Server

Checking…

Authorize access

Already set up?

Paste a tailshell MCP URL, HTTP URL or token you already have, and it is handed back as is. No pairing needed.

1. Join your tailnet

Create a one-time auth key in Tailscale (Settings → Keys). It is sent once to add a node named tailshell to your tailnet and is never stored.

Already have node state?

2. Choose a device

Machines on your tailnet.

Node state

This is the identity of the node created above. It is already embedded in the MCP URL you will get; keep it private.

3. Pair the phone

  1. On the phone: Settings → Developer options → Wireless debugging → on.
  2. Note the IP address & Port on that screen (the connect port).
  3. Tap Pair device with pairing code and note its port and code.
Keep it working without Wi-Fi (optional)

Wireless debugging only runs while the phone is on Wi-Fi. Turn USB debugging on too, then tick this: after pairing, tailshell switches the phone to adb over TCP on port 5555, which keeps working over mobile data through Tailscale. The setting resets when the phone restarts, and port 5555 is also open to other devices on the phone's networks (they still need your approval to connect).

Only Android phones are supported right now.

MCP URL

Paste this into ChatGPT as an MCP server URL, with authentication set to none.

HTTP API

The same tools over plain HTTP. GET the base URL to list endpoints; /openapi.json is an OpenAPI spec.

Treat these URLs like passwords. They contain the phone's adb key and your tailnet node identity, so anyone who has one can control the phone while it is reachable.

Wireless debugging port changed?

Turning wireless debugging off and on changes its port. The pairing stays valid; paste your MCP URL and the new connect port to get an updated URL.