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:

1. Termux installed on your Android device.
2. Termux:API app installed and the termux-api package installed within Termux:

   pkg install termux-api
   

3. 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

1. Clone the repository:

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

2. 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