Skip to content
MCP server

Nano MCP Termux

Single-file, zero-dependency MCP server for Termux on Android, Raspberry Pi and Linux

Runs locallyStatus and history
Install
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-termux

Add to claude_desktop_config.json

{
  "mcpServers": {
    "nano-mcp-termux": {
      "command": "uvx",
      "args": [
        "nano-mcp-termux"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "nano-mcp-termux": {
      "command": "uvx",
      "args": [
        "nano-mcp-termux"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

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.

How AIPoweredBot checks servers