Nano MCP Termux
Single-file, zero-dependency MCP server for Termux on Android, Raspberry Pi and Linux
- Pricing
- Open source
- Platforms
- Android, Linux, CLI
- Runs
- Locally
- Version
- 1.1.1
- Listing updated
- today
Similar MCP servers
About Nano MCP Termux
Nano MCP Termux is an open-source MCP server for developer tools. It runs locally on your machine and is started by your AI client.
This is a small Python server meant to run on constrained devices, including phones under Termux. It exposes four tools: device_status for battery, storage, architecture and memory, server_health for pid, uptime, counters and live children, resolve_path for Android path details, and path_adapter for environment profile and storage roots.
Most of the engineering goes into lifecycle behaviour. Version 1.1.0 fixed a bug where timed-out commands left orphaned grandchildren, by starting each command in its own process group and killing the whole tree. It also exits when its parent dies or stdin closes, and warns about Android 12+ Phantom Process Killer risk. The path adapter handles /sdcard and /storage/emulated/0 equivalents, noexec mounts and case-insensitive filesystems.
It speaks newline-delimited JSON-RPC over stdio and echoes the client's protocol version among 2024-11-05, 2025-06-18 and 2025-11-25. Install with uvx or pip, run the file directly, or use Docker. MIT licensed.
Install
Run in a terminal
claude mcp add nano-mcp-termux -- uvx nano-mcp-termuxAdd to claude_desktop_config.json
{
"mcpServers": {
"nano-mcp-termux": {
"command": "uvx",
"args": [
"nano-mcp-termux"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"nano-mcp-termux": {
"command": "uvx",
"args": [
"nano-mcp-termux"
]
}
}
}Add to .vscode/mcp.json
{
"servers": {
"nano-mcp-termux": {
"type": "stdio",
"command": "uvx",
"args": [
"nano-mcp-termux"
]
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"nano-mcp-termux": {
"command": "uvx",
"args": [
"nano-mcp-termux"
]
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"nano-mcp-termux": {
"command": "uvx",
"args": [
"nano-mcp-termux"
]
}
}
}Using several servers? Build one config file with the MCP config generator.
What it does
- Device status
- Reports battery, storage, architecture and memory, marking unavailable fields.
- Server health
- Shows uptime, children, memory use and Android kill risk.
- Android path resolver
- Maps equivalent paths and flags noexec and quoting hazards.
- Clean process teardown
- Kills whole process groups on timeout.
- Self-terminating
- Exits when the client disappears.
- Single file
- No dependencies beyond Python.
Good for
- Let an assistant inspect a Termux phone's resources
- Check mount flags before running a script on Android
- Run a lightweight MCP sidecar on a Raspberry Pi
- Diagnose Android background process kills
Pricing
Open source
Nano MCP Termux FAQ
What does it depend on?
Nothing beyond Python; it is a single file.
How do I install it?
With uvx or pip, by running the file directly, or with Docker.
What licence?
MIT.
Is Nano MCP Termux free?
Yes. Nano MCP Termux is open source, so you can use and self-host it for free.
How do I add Nano MCP Termux to Claude Code?
Run this command in your terminal: claude mcp add nano-mcp-termux -- uvx nano-mcp-termux
What are the best alternatives to Nano MCP Termux?
The closest alternatives to Nano MCP Termux are REA, Context7, Chrome DevTools MCP, Codebase Memory and GitHub.
Where this comes from
- Description: written from the project's README.
- Install steps: from the official MCP Registry entry.


