# Meshtastic-MCP: AI Tooling for Meshtastic Device Control and Testing This repository profile is provided by osrepos.com, an open source repository discovery platform. Source: osrepos.com Repository profile: https://osrepos.com/repo/meshtastic-meshtastic-mcp Generated for open source discovery and AI-assisted research. Meshtastic-MCP provides an MCP server and agent skills designed for AI tooling to discover, drive, observe, and test Meshtastic devices and applications. It offers a comprehensive suite of capabilities, from portable device control to advanced hardware-free end-to-end testing and replay functionalities. This project aims to streamline the development and testing of Meshtastic ecosystems. GitHub: https://github.com/meshtastic/meshtastic-mcp OSRepos URL: https://osrepos.com/repo/meshtastic-meshtastic-mcp ## Summary Meshtastic-MCP provides an MCP server and agent skills designed for AI tooling to discover, drive, observe, and test Meshtastic devices and applications. It offers a comprehensive suite of capabilities, from portable device control to advanced hardware-free end-to-end testing and replay functionalities. This project aims to streamline the development and testing of Meshtastic ecosystems. ## Topics - Python - Meshtastic - AI - IoT - Testing - Automation - MCP ## Repository Information Last analyzed by OSRepos: Sun Sep 27 2026 08:14:23 GMT+0100 (Western European Summer Time) Detail views: 2 GitHub clicks: 2 ## Safety Notice OSRepos shares public repositories for knowledge and discovery only. Review source code, dependencies, licenses, and security implications before running or installing anything. ## Content ## 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: bash # 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: bash 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: bash uvx meshtastic-mcp doctor # check what's available Inside an MCP client like Claude Code, you can interact with your Meshtastic devices: python 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