explaingit

x0root/claude_droid

Analysis updated 2026-05-18

4PythonAudience · developerComplexity · 3/5LicenseSetup · moderate

TLDR

A Termux based server that lets Claude run shell commands and manage files directly on your Android phone through a public tunnel.

Mindmap

mindmap
  root((Claude Droid))
    What it does
      Remote phone control
      Nine file and shell tools
      MCP connector for Claude
    Tech stack
      Python
      Termux
      Cloudflare Tunnel
    Use cases
      Manage files by chat
      Run scripts on phone
      Experiment with MCP servers
    Audience
      Developers
      Termux hobbyists
    Security
      No authentication by default
      Recommended for secondary devices

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Ask Claude to organize files, install packages, or run scripts directly on your Android phone.

USE CASE 2

Give Claude shell access to a secondary or development phone for hands on experimentation.

USE CASE 3

Learn how to build a minimal MCP server using only Python's standard library.

What is it built with?

PythonTermuxCloudflare TunnelMCP

How does it compare?

x0root/claude_droid1038lab/agnes-ai3eyedtiger/video2vrcemote
Stars444
LanguagePythonPythonPython
Setup difficultymoderateeasyeasy
Complexity3/52/51/5
Audiencedevelopervibe codervibe coder

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

No built in authentication, the public tunnel URL grants full shell access to anyone who has it.

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

In plain English

Claude Droid turns an Android phone into a remote control target for the Claude AI assistant, letting you ask Claude in a normal chat to run commands, read and write files, and manage folders directly on your phone. It works through Termux, a terminal app for Android that does not require rooting the device, and connects to Claude using the Model Context Protocol, a standard way for AI apps to talk to outside tools. A single Python script starts a small web server on the phone using only Python's built in library, so nothing extra needs to be installed. That server is then made reachable from the internet using a free Cloudflare Quick Tunnel, which gives it a temporary public web address. You paste that address into Claude's custom connector settings, and from then on Claude can call nine tools such as running a shell command, reading or writing a file, listing a folder, or moving and deleting files. Because the run command tool can execute anything Termux is capable of running, this effectively gives Claude the same level of access to the phone as the person using Termux directly, including installing software or running scripts. The README is upfront that this setup has no login or authentication built in: anyone who obtains the tunnel address has the same access you do, and there is no confirmation step before commands run. It recommends using this on a secondary or development device rather than a primary phone with sensitive accounts, and suggests optional steps like adding a shared secret check for anyone who wants stronger protection. Setup involves installing Python and Cloudflare's tunnel tool through Termux's package manager, running the script, and adding the printed web address as a custom connector inside the Claude app. The free tunnel address changes each time the script restarts, so it needs to be updated in Claude's settings after every restart.

Copy-paste prompts

Prompt 1
Help me set up Claude Droid on my Android phone using Termux and connect it to the Claude app.
Prompt 2
Explain the security tradeoffs of running Claude Droid and how I could add authentication to it.
Prompt 3
Walk me through what each of the nine tools in claude_droid.py lets Claude do on my phone.
Prompt 4
Show me how to keep the Cloudflare tunnel and Termux session running after I close the app.

Frequently asked questions

What is claude_droid?

A Termux based server that lets Claude run shell commands and manage files directly on your Android phone through a public tunnel.

What language is claude_droid written in?

Mainly Python. The stack also includes Python, Termux, Cloudflare Tunnel.

What license does claude_droid use?

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

How hard is claude_droid to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is claude_droid for?

Mainly developer.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.