Home › Other › meshtastic-mcp

meshtastic-mcp

Discover, drive, observe, and test Meshtastic devices and companion apps over serial and TCP.

Python
★ 23 stars Last pushed 2026-11-17 License: GPL-3.0

Connect

Review any command before running it. Package names and URLs come from the server's own registry entry.

Package (pypi 0.3.0)

uvx meshtastic-mcp

Or add to your MCP client config:

{
  "mcpServers": {
    "meshtastic-mcp": {
      "command": "uvx",
      "args": [
        "meshtastic-mcp"
      ]
    }
  }
}
  • MESHTASTIC_FIRMWARE_ROOT — Path to a Meshtastic firmware checkout. Optional — enables the firmware capability (build/flash/boards/userprefs). Core device/admin/recorder tools work without it.
  • MESHTASTIC_MCP_TCP_HOST — host[:port] of a meshtasticd TCP node to surface in list_devices (default port 4403).
  • MESHTASTIC_MCP_TOOLSETS — Comma-separated tool groups to expose: core, firmware, hardware, android, discord, replay, rf, local-model. Unset or 'all' exposes every group; a hidden tool cannot be called.
  • MESHTASTIC_MCP_READ_ONLY — Set to 1 to hide every tool that can change device or host state.
  • MESHTASTIC_MCP_CONFIRM — Confirmation policy for destructive tools. 'agent' runs a tool called with confirm=True; 'human' asks the user through elicitation before an irreversible tool (factory_reset, erase_and_flash, nrf52_factory_erase, vanity_apply, destructive esptool/nrfutil/picotool calls) even when confirm=True is passed.
  • MESHTASTIC_MCP_DATA_DIR — Directory for recorder JSONL logs and persistent data. Defaults to platformdirs user-data-dir, then cwd. Set this to keep recorder data in a known location.
  • MESHTASTIC_UI_CAMERA_DEVICE — Camera device index or path for capture_screen (default: 0). Role-specific overrides: MESHTASTIC_UI_CAMERA_DEVICE_TESTER, _DUT, etc.
  • MESHTASTIC_UHUBCTL_LOCATION_TESTER — uhubctl USB hub location for the TESTER role port (e.g. '1-1'). Enables uhubctl_power/uhubctl_cycle against that role. Suffix varies by role: _DUT, _RELAY, etc.
  • MESHTASTIC_PIO_BIN — Path to the PlatformIO CLI binary. Searched in order: this env var, ~/.platformio/penv/bin/pio, then PATH. Only needed if PlatformIO is not on PATH.
  • MESHTASTIC_ANDROID_ROOT — Path to a Meshtastic-Android source checkout (directory containing gradlew). Optional — enables building the APK from source via scripts/build_android_apk.sh. If unset, scripts default to cloning fresh or using a release APK.
  • MESHTASTIC_APPLE_ROOT — Path to a Meshtastic-Apple source checkout (directory containing Meshtastic.xcworkspace). Optional — enables building the iOS Simulator .app from source via scripts/build_apple.sh. If unset, scripts clone fresh.

Related servers

Data from the Official MCP Registry