⚡

Termux

Model Context Protocol (MCP) server for controlling Android devices via Termux

0 installs

Trust: 37 — Low

Automation

Ask AI about Termux

I know everything about Termux. Ask me about installation, configuration, usage, or troubleshooting.

0/500

Loading tools...

Reviews

Documentation

termux-mcp

A Model Context Protocol (MCP) server that provides a bridge between Large Language Models and Android device features via Termux.

This server allows LLMs to interact with your Android device by getting battery status, location, sending notifications, controlling media, taking screenshots, and even performing UI interactions like tapping and swiping.

Prerequisites

To use this MCP server, you need:

Termux installed on your Android device.
Termux:API app installed and the termux-api package installed within Termux:
```
pkg install termux-api
```
ADB (Android Debug Bridge) (Optional, for advanced UI automation tools):
- Enable Developer Options and USB/Wireless Debugging on your device.
- Install android-tools in Termux:
```
pkg install android-tools
```

Installation

Clone the repository:

git clone https://github.com/akashagg30/termux-mcp.git
cd termux-mcp

Install dependencies:
```
npm install
```

Available Tools

System & Sensors

battery_status: Get current battery level and health.
location: Get GPS coordinates.
wifi_info: Get current WiFi connection details.
sensor: Read data from various device sensors (accelerometer, gyroscope, etc.).
device_info: Get telephony/device information.

Interaction & Feedback

vibrate: Vibrate the device.
toast: Display a transient popup message.
notification: Show a system notification with title and content.
torch: Toggle the flashlight.
clipboard_get / clipboard_set: Access and modify the system clipboard.
volume: Control volume levels for different streams (music, alarm, etc.).

App Management

list_apps: List installed applications.
open_url: Open a URL in the browser or a file in a supported app.
launch_app: Launch an app by its package name.

UI Automation (Requires ADB)

tap: Tap at specific (x, y) coordinates.
swipe: Perform a swipe gesture.
type_text: Type text into the focused field.
keyevent: Send hardware key events (BACK, HOME, etc.).
screenshot: Capture the current screen.
get_ui_hierarchy: Get the XML UI tree for screen analysis.

Usage in Claude/MCP Clients

Add this server to your MCP configuration:

{
  "mcpServers": {
    "termux": {
      "command": "node",
      "args": ["/path/to/termux-mcp/index.js"]
    }
  }
}