meshtastic

meshtastic-mcp: Test Meshtastic Devices and Apps with MCP

meshtastic-mcp is a Python server built on the Model Context Protocol (MCP), with agent skills for discovering, controlling, observing, and testing Meshtastic devices and apps. Its core works with serial or TCP devices; optional capabilities support firmware builds and Android and Apple app testing.

Stars
19
Forks
8
Stars, last 30 days
+6
Last commit
3 days ago
Contributors
9

Our take

Newless than six months old and changing fast

Health score

51/100

How it is scored
Activity
52
Community
57
Issues
21
Pull requests
72

+6 stars in the last 30 days

This is a fast-moving, early-stage project with a broad Meshtastic testing surface, and its recent activity is encouraging but not yet evidence of long-term stability.

Good fit if

  • You work with Meshtastic devices or apps and want MCP-accessible device control, observation, or testing.
  • You need hardware-free app testing using simulated TCP nodes, or want to replay captures and generated mesh traffic.
  • Your team can work with Python 3.11 or later and can meet the optional platform-specific tool requirements for the capabilities it needs.

Look elsewhere if

  • You need a general-purpose MCP device server rather than tooling focused on Meshtastic.
  • You need a mature project with a longer release history; this repository is under six months old and has only one release so far.
  • GPL-3.0-only licensing does not fit your distribution or compliance requirements.
All health signals
Last commit2026-11-02 (3 days ago)
Commits, last 90 days46
Releases, last 12 months1 (latest v0.1.0, 2026-07-03)
Contributors9 (top contributor: 37% of commits)
Issues closed, last 90 days0
Pull requests merged, last 90 days44 (typically merged in 0 days)
Project age4 months

Checked on 2026-11-06 with the GitHub API.

Project history

Daily GitHub snapshots since Oct 7, 2026. History covers stars and forks; health signals are not tracked historically.

Selected snapshot

Stars

23

Forks

9

Change since Nov 16, 2026: 0 stars·0 forks

Overview

meshtastic-mcp is a Python server built on the Model Context Protocol (MCP), paired with agent skills for discovering, driving, observing, and testing Meshtastic devices and apps. It addresses the gap between AI tooling and end-to-end Meshtastic workflows by exposing device operations and test capabilities through MCP, including closed-loop device-to-app testing.

The core works with Meshtastic devices over serial or TCP without a firmware checkout. Optional integrations add firmware build and flash workflows, Android and Apple simulator testing, and a local web interface for managing a device bench. See the official repository for the full capability list and setup details.

Key Features

  • Provides MCP tools for device discovery, device information, node lists, administration, text messaging, and packet observation.
  • Records and queries logs, telemetry, packets, and events, and can replay captures as a simulated device over TCP.
  • Generates synthetic meshes and can fuzz replay traffic to exercise app decoders and interfaces without live radio traffic.
  • Bundles agent skills for device operations, end-to-end testing, and Meshtastic project knowledge.
  • Adds optional firmware build and flash, Android emulator, and Apple simulator workflows when their dependencies and source checkouts are available.
  • Offers FleetSuite, a local web control plane for device benches, including discovery, recovery, builds, and test runs.

Use Cases

  • Meshtastic developers can test device operations and inspect mesh traffic through an MCP client instead of building a separate integration for each AI tool.
  • App developers can connect an Android emulator to a simulated or native TCP node to test app behavior without LoRa hardware.
  • QA teams can replay captured or generated mesh traffic to reproduce scenarios and probe app handling of malformed or adversarial packets.
  • Teams with multiple boards can use FleetSuite to organize bench devices, run tests, and manage recovery workflows.

What you need

Detected in the repository

  • Python >=3.11 (from pyproject.toml)
  • A Dockerfile, so it can run in a container
  • A test suite and automated checks on GitHub Actions

License in plain words

GPL-3.0strong copyleft

  • Commercial use: yes
  • Modify and redistribute: yes
  • You must keep: the license notice
  • Share your changes: yes, the full source of anything you distribute that includes it, under the GPL
  • Includes an explicit patent grant from the contributors:

A summary, not legal advice: the LICENSE file is what applies.

Getting Started

Install and check the environment with uv:

uv tool install meshtastic-mcp
meshtastic-mcp doctor

For MCP client registration, optional capabilities, and device setup, see the README.

Considerations

The repository is new and changes quickly. Recent commit and pull request activity shows active development, but its short history and limited release record mean teams should validate the workflows they depend on before adopting it for critical test infrastructure. The project has multiple contributors, with no measured concentration around one contributor. The health data reports no issues closed in the recent measurement window, so issue-resolution responsiveness is not yet demonstrated by that measure.

Core device access does not require firmware sources, but optional firmware, Android, and Apple workflows depend on additional tools and checkouts. The README also describes some capabilities as experimental or dependent on external hardware, such as the SDK CLI bridge, SDR checks, and BLE sniffing. The project is licensed GPL-3.0-only, which teams should assess against their obligations before redistributing or integrating it into products.

Found this useful?

Share it with someone who would like meshtastic-mcp.