Discover, drive, observe, and test Meshtastic devices and companion apps over serial and TCP.
Maintain this server? Claim it
This server only runs locally, from a package. Install it with the instructions on this page to try it.
Pick your client. Values in capitals, like YOUR_TOKEN, are yours to fill in.
Run in a terminal
claude mcp add meshtastic-mcp \ -- uvx meshtastic-mcp==0.3.0
Environment
MESHTASTIC_FIRMWARE_ROOT (optional, not in the config above): 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 (optional, not in the config above): host[:port] of a meshtasticd TCP node to surface in list_devices (default port 4403).MESHTASTIC_MCP_TOOLSETS (optional, not in the config above): 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 (optional, not in the config above): Set to 1 to hide every tool that can change device or host state.MESHTASTIC_MCP_CONFIRM (optional, not in the config above): 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 (optional, not in the config above): 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 (optional, not in the config above): Camera device index or path for capture_screen (default: 0). Role-specific overrides: MESHTASTIC_UI_CAMERA_DEVICE_TESTER, _DUT, etc.MESHTASTIC_UHUBCTL_LOCATION_TESTER (optional, not in the config above): 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 (optional, not in the config above): 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 (optional, not in the config above): 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 (optional, not in the config above): 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.We don't run packages, so we can't list this server's tools.