termux-mcp 0.2.1

Powerful MCP server for Termux — let AI agents run shell commands on your Android device in real time

A lightweight HTTP server that exposes Termux Shell as a streaming API — built to pair with AI agents, Claude, or Postman.

---

📖 What is TermuxMCP?

TermuxMCP runs inside Termux and provides a simple HTTP interface so any AI agent can:

• 🖥️ Execute shell commands with real-time streaming output
• 📂 Navigate directories with persistent cd state
• 📦 Install packages non-interactively (pkg install, apt install)
• 💓 Check server health via /ping

AI / API Call ──►  POST /run {"cmd": "ls -la"}  ──►  TermuxMCP  ──►  Termux Shell
                                                         │
                         ◄── chunked streaming output ───┘

---

Quick Start

1 — Install in Termux

pkg update && pkg install python git -y;git clone https://github.com/termuxgpt/termux-mcp;cd termux-mcp;python -m termux_mcp

or Try below method (recommended)

curl -fSL https://termux-mcp.pages.dev/add-repo.sh | bash

pkg install termux-mcp

termux-mcp

2 — Test it

# Health check
curl http://localhost:8080/ping

# Run a command
curl -X POST http://localhost:8080/run \
     -H "Content-Type: application/json" \
     -d '{"cmd": "ls ~"}'

# Install a package (streaming output)
curl -X POST http://localhost:8080/run \
     -H "Content-Type: application/json" \
     -d '{"cmd": "pkg install python"}'

3 — Custom port

TERMUX_MCP_PORT=9090 python -m termux_mcp

---

API Reference

Method	Path	Body	Response
GET	/ping	—	{"status":"ok","cwd":"..."}
POST	/run	{"cmd": "<shell>"}	Chunked plain-text stream

Streaming Response Format

Output uses HTTP chunked transfer encoding (Transfer-Encoding: chunked).
Read it line by line — each line is real terminal output as it happens.

---

Configuration

All settings can be overridden via environment variables:

Variable	Default	Description
TERMUX_MCP_PORT	8080	HTTP listen port
TERMUX_MCP_HOST	0.0.0.0	Bind address
HOME	Termux home	Working directory base