Meshtastic-MCP: AI Tooling for Meshtastic Device Control and Testing

Introduction

Meshtastic-MCP is a powerful Python project designed to provide an MCP (Model Context Protocol) server and a suite of agent skills for interacting with Meshtastic devices and applications. It enables AI tooling to seamlessly discover, drive, observe, and test Meshtastic ecosystems, offering a robust framework for automation and development.

Why Use It and Key Features

This repository is crucial for anyone looking to automate or deeply test Meshtastic setups, especially with AI integration. It offers a comprehensive set of capabilities:

• AI-Driven Device Control and Testing: Meshtastic-MCP allows AI agents to perform closed-loop device and app end-to-end testing, streamlining development workflows.
• Portable Core: Works with any connected Meshtastic device, supporting serial and TCP connections for basic operations like discovery, device information, sending messages, and recording data, without requiring firmware checkouts.
• Firmware Management: Integrates with PlatformIO to build, clean, flash, and perform OTA updates for Meshtastic firmware.
• Hardware-Free End-to-End Testing: Orchestrates Android emulators and iOS simulators for comprehensive testing of Meshtastic apps without physical hardware.
• RF Compliance with SDR: Utilizes SDR dongles for RF compliance checks, including occupancy scans and on-air TX verification.
• Local Model Integration: Offloads token-heavy tasks like summarizing recorder windows or triaging e2e failures to local GPUs via Ollama or OpenAI-compatible servers.
• Replay Functionality: Simulates Meshtastic devices by serving captured mesh data over TCP, allowing for reproducible app/UI development and testing with fully controllable, synthetic meshes.
• FleetSuite Web Control Plane: Provides a local web UI for managing a multi-board hardware bench, offering live device registry, build queues, flashing, recovery, and camera streams for screen assertions.
• Hardware Test Suite: Includes a tiered pytest suite for unit, mesh, telemetry, and recovery tests, supporting various Meshtastic boards on a USB-hub bench.
• Decoupled Design: Extracted from the main Meshtastic firmware repository, it can be installed and distributed independently, with firmware-build tools activating only when a firmware checkout is present.

Installation

To get started with Meshtastic-MCP, you can install it using uv (recommended) or pipx.

First, install the CLI and MCP server:

# Install the CLI + MCP server (uv recommended; also works with pipx)
uv tool install 'meshtastic-mcp[ui]'       # includes camera/OCR support
# or without UI extras:
uv tool install meshtastic-mcp

Then, register the server with your MCP client and install the bundled skills:

meshtastic-mcp install                 # claude-code user scope; --client cursor|windsurf|claude-desktop

Examples

Here are some quick examples to demonstrate how to use Meshtastic-MCP:

Check available components and dependencies:

uvx meshtastic-mcp doctor          # check what's available

Inside an MCP client like Claude Code, you can interact with your Meshtastic devices:

list_devices()                          # find your device port
device_info(port="/dev/cu.usbmodem101") # firmware, region, node count
list_nodes(port="/dev/cu.usbmodem101")  # mesh peers
send_text(port="/dev/cu.usbmodem101", text="hello mesh")
packets_window(port="/dev/cu.usbmodem101", start="-30s")  # confirm TX packet

Links

• GitHub Repository: meshtastic/meshtastic-mcp