⚡
Termux
Model Context Protocol (MCP) server for controlling Android devices via Termux
0 installs
Trust: 37 — Low
Automation
Ask AI about Termux
Powered by Claude · Grounded in docs
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-apipackage 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-toolsin 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"]
}
}
}
License
MIT © akashagg30
