MCPSERV.CLUB
hyhAsma

Termux API Tools MCP Server

MCP Server

Remote Android control via MCP on Termux

Stale(55)
7stars
2views
Updated 22 days ago

About

A lightweight MCP server that connects to a Termux environment over SSH, enabling remote access to Android device information and telephony functions such as call logs, SMS, dialing, and messaging.

Capabilities

Resources
Access data sources
Tools
Execute functions
Prompts
Pre-built templates
Sampling
AI model interactions

Termux API MCP Server in Action

The Termux‑API‑Tools MCP Server is a lightweight bridge that lets AI assistants such as Claude reach into an Android device running Termux and perform a range of phone‑related tasks over the local network. By exposing the Termux API through the Model Context Protocol, developers can write AI‑driven scripts that query device state or trigger actions—everything from retrieving device identifiers to initiating phone calls and reading SMS history—without needing direct access to the Android OS or ADB.

At its core, the server listens for MCP client connections and forwards JSON‑encoded requests to a Termux instance that has SSHD enabled. The server pulls environment variables (host, port, user, password) to establish a secure SSH tunnel and then executes Termux‑API commands via the package. This design keeps the sensitive logic on the Android side while allowing the AI to issue high‑level commands, thereby minimizing the attack surface for remote code execution.

Key capabilities include:

  • Device introspection: gather phone model, OS version, battery status, and network interfaces.
  • Telephony control: read call logs, send SMS, place outgoing calls, and access cellular network information.
  • Messaging access: pull SMS history for analysis or backup purposes.
  • Remote management: all interactions are triggered through a single MCP client configuration, making it trivial to integrate into existing AI workflows or conversational agents.

Typical use cases span from building personal productivity bots that can schedule calls or send reminders, to creating debugging tools for mobile app developers that automatically report crash logs and device state. In a research setting, the server enables rapid prototyping of privacy‑aware assistants that can interact with user devices while keeping sensitive operations encapsulated within the Termux environment.

What sets this MCP server apart is its minimal footprint and straightforward integration. Developers already familiar with Termux and the MCP ecosystem can drop in a JSON configuration, point it at their device’s SSH credentials, and immediately start issuing commands from an AI assistant. The server also includes basic error handling for common issues such as unsupported APIs or connectivity hiccups, and it is designed to be extended with additional Termux‑API endpoints as needed.