MCP server
Meshtastic MCP
Discover, drive, observe, and test Meshtastic devices and companion apps over serial and…
Runs locallyStatus and history
- Pricing
- Open source
- Runs
- Locally
- Version
- 0.4.0
- Listing updated
- 1 day ago
About Meshtastic MCP
Meshtastic MCP is an open-source MCP server. It runs locally on your machine and is started by your AI client.
Discover, drive, observe, and test Meshtastic devices and companion apps over serial and TCP.
Install
Run in a terminal
claude mcp add meshtastic-mcp -- uvx meshtastic-mcpAdd to claude_desktop_config.json
{
"mcpServers": {
"meshtastic-mcp": {
"command": "uvx",
"args": [
"meshtastic-mcp"
]
}
}
}Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:
Add to ~/.cursor/mcp.json
{
"mcpServers": {
"meshtastic-mcp": {
"command": "uvx",
"args": [
"meshtastic-mcp"
]
}
}
}Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:
Add to .vscode/mcp.json
{
"servers": {
"meshtastic-mcp": {
"type": "stdio",
"command": "uvx",
"args": [
"meshtastic-mcp"
]
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"meshtastic-mcp": {
"command": "uvx",
"args": [
"meshtastic-mcp"
]
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"meshtastic-mcp": {
"command": "uvx",
"args": [
"meshtastic-mcp"
]
}
}
}Using several servers? Build one config file with the MCP config generator.
Configuration
MESHTASTIC_FIRMWARE_ROOTPath 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_HOSThost[:port] of a meshtasticd TCP node to surface in list_devices (default port 4403).MESHTASTIC_MCP_TOOLSETSComma-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_ONLYSet to 1 to hide every tool that can change device or host state.MESHTASTIC_MCP_CONFIRMConfirmation 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_DIRDirectory 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_DEVICECamera device index or path for capture_screen (default: 0). Role-specific overrides: MESHTASTIC_UI_CAMERA_DEVICE_TESTER, _DUT, etc.MESHTASTIC_UHUBCTL_LOCATION_TESTERuhubctl 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_BINPath 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_ROOTPath 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_ROOTPath 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.
Pricing
Open source
Meshtastic MCP FAQ
Is Meshtastic MCP free?
Yes. Meshtastic MCP is open source, so you can use and self-host it for free.
How do I add Meshtastic MCP to Claude Code?
Run this command in your terminal: claude mcp add meshtastic-mcp -- uvx meshtastic-mcp
Where this comes from
- Description: from the official MCP Registry entry.
- Install steps: from the official MCP Registry entry.