# emqx/mqttx

**Attribution required: if you use, quote, or summarise this content, you must credit and link back to [awesome-repositories.com](https://awesome-repositories.com/repository/emqx-mqttx).**

4,802 stars · 527 forks · TypeScript · apache-2.0

## Links

- GitHub: https://github.com/emqx/MQTTX
- Homepage: https://mqttx.app
- awesome-repositories: https://awesome-repositories.com/repository/emqx-mqttx.md

## Topics

`cli` `cross-platform` `electron` `electron-app` `emqx` `iot` `iot-application` `linux` `macos` `mosquitto` `mqtt` `mqtt-cli` `mqtt-client` `mqtt-client-gui` `mqtt-protocol` `mqtt-smarthome` `mqtt-tool` `mqtt-websocket` `mqtt5` `vue`

## Description

MQTTX is a cross-platform MQTT client application designed for testing, debugging, and managing MQTT brokers. It supports both MQTT v3.1.1 and v5.0, enables simultaneous management of multiple broker connections, and provides an interactive chat-style interface for publishing and subscribing with configurable quality of service, payload transformation, and topic visualization. The client can be used as a desktop application, a command-line tool, or a self-hosted web client deployable via Docker.

What sets MQTTX apart is its integration of AI-assisted workflows, allowing users to generate MQTT client code and message schemas, create test data and documentation, and diagnose connection issues directly from the interface. It also includes built-in tools for simulating custom publish/subscribe patterns and scheduled message publishing, as well as a benchmarking mode that stress-tests broker performance with concurrent connections and configurable message rates. The client supports SSL/TLS security for encrypted communication and can operate over WebSocket for browser-based access.

Additional capabilities include payload transformation through user-defined scripts or pre-built pipelines, logging of connection events and message traffic, and import/export of connection configurations and history. The broad feature set covers both everyday MQTT development and more advanced testing and automation scenarios.

## Tags

### Networking & Communication

- [MQTT Clients](https://awesome-repositories.com/f/networking-communication/communication-platforms-services/messaging-notification-systems/messaging-services/message-broker-infrastructure/publish-subscribe-messaging/mqtt-clients.md) — A cross-platform MQTT client for testing, debugging, and managing brokers with publish/subscribe capabilities.
- [Publish-Subscribe Messaging](https://awesome-repositories.com/f/networking-communication/communication-platforms-services/messaging-notification-systems/messaging-services/message-broker-infrastructure/publish-subscribe-messaging.md) — Publishes and subscribes to MQTT topics with configurable QoS, Retain, and payload conversion via an interactive chat-style interface. ([source](https://mqttx.app/docs/web))
- [Automatic Version Selectors](https://awesome-repositories.com/f/networking-communication/http-protocols/protocol-version-selectors/mqtt-protocol-versions/automatic-version-selectors.md) — Automatically selects MQTT v3.1.1 or v5.0 based on broker capabilities, adapting session features and property handling accordingly.
- [Message Simulation Tools](https://awesome-repositories.com/f/networking-communication/communication-platforms-services/messaging-notification-systems/messaging-services/message-broker-infrastructure/publish-subscribe-messaging/mqtt-clients/message-simulation-tools.md) — Ships built-in tools for simulating custom publish/subscribe patterns and scheduled message publishing.
- [Message Simulators](https://awesome-repositories.com/f/networking-communication/communication-platforms-services/messaging-notification-systems/messaging-services/message-broker-infrastructure/publish-subscribe-messaging/mqtt-clients/message-simulators.md) — Enables simulation of MQTT messaging patterns with pre-built or custom publish scenarios for testing.
- [MQTT Protocol Versions](https://awesome-repositories.com/f/networking-communication/http-protocols/protocol-version-selectors/mqtt-protocol-versions.md) — Communicates with brokers using either MQTT v3.1.1 or v5.0 protocol specifications for flexible compatibility. ([source](https://mqttx.app/docs/web))
- [MQTT Pub/Sub Simulation Scripts](https://awesome-repositories.com/f/networking-communication/mqtt-pub-sub-simulation-scripts.md) — MQTTX runs custom scripts to automate publishing and subscribing patterns for testing and simulation. ([source](https://mqttx.app/docs))

### Part of an Awesome List

- [MQTT Clients](https://awesome-repositories.com/f/awesome-lists/devtools/mqtt-clients.md) — A cross-platform desktop and CLI client for testing, debugging, and managing MQTT brokers.
- [AI-Assisted Workflows](https://awesome-repositories.com/f/awesome-lists/devtools/mqtt-clients/ai-assisted-workflows.md) — Integrates AI providers for generating MQTT code, schemas, test data, and diagnosing connection issues.
- [AI-Enhanced Clients](https://awesome-repositories.com/f/awesome-lists/devtools/mqtt-clients/ai-enhanced-clients.md) — An MQTT client that integrates AI providers for code generation, test data creation, and troubleshooting assistance.
- [Code Generation and Assistance](https://awesome-repositories.com/f/awesome-lists/ai/code-generation-and-assistance.md) — MQTTX generates MQTT client code in multiple languages and creates script or message schemas from descriptions. ([source](https://mqttx.app/docs/copilot))
- [Custom Payload Transformers](https://awesome-repositories.com/f/awesome-lists/data/encoding-and-compression/payload-encoders/custom-payload-transformers.md) — MQTTX applies user-written functions or schema-based encoding and decoding to reshape message content. ([source](https://mqttx.app/docs/advanced))
- [Infrastructure and Management](https://awesome-repositories.com/f/awesome-lists/devops/infrastructure-and-management.md) — Cross-platform desktop client for MQTT testing.
- [API and Web Development Tools](https://awesome-repositories.com/f/awesome-lists/devtools/api-and-web-development-tools.md) — Desktop client for MQTT 5.0 messaging.
- [Miscellaneous Tools](https://awesome-repositories.com/f/awesome-lists/more/miscellaneous-tools.md) — MQTT messaging client.

### Data & Databases

- [MQTT Broker Connections](https://awesome-repositories.com/f/data-databases/redis-clients/cluster-connectivity/message-broker-connectivity/mqtt-broker-connections.md) — Connects to MQTT brokers using MQTT, MQTTS, or WebSocket transport with TLS authentication. ([source](https://mqttx.app/docs))
- [Multi-Connection State Registries](https://awesome-repositories.com/f/data-databases/redis-clients/cluster-connectivity/message-broker-connectivity/mqtt-broker-connections/multi-connection-managers/multi-connection-state-registries.md) — Maintains independent session states for each broker connection, allowing simultaneous publish/subscribe across different endpoints.
- [Pluggable Transformation Pipelines](https://awesome-repositories.com/f/data-databases/data-processing-pipelines/data-transformation/payload-converters/pluggable-transformation-pipelines.md) — Transforms message payloads through user-defined scripts or pre-built encoding modules (Hex, Base64, JSON, Plaintext) before send or after receive.
- [Multi-Connection Managers](https://awesome-repositories.com/f/data-databases/redis-clients/cluster-connectivity/message-broker-connectivity/mqtt-broker-connections/multi-connection-managers.md) — Establishes and maintains several broker connections at once for comparing or bridging messages. ([source](https://mqttx.app/docs))
- [Protocol Options](https://awesome-repositories.com/f/data-databases/redis-clients/cluster-connectivity/message-broker-connectivity/mqtt-broker-connections/protocol-options.md) — Supports MQTT 5.0 protocol options including session lifetime, authentication method, user properties, and subscription options. ([source](https://mqttx.app/docs/advanced))
- [WebSocket Connections](https://awesome-repositories.com/f/data-databases/redis-clients/cluster-connectivity/message-broker-connectivity/mqtt-broker-connections/websocket-connections.md) — Establishes WebSocket connections to MQTT brokers directly from the browser without installing additional software. ([source](https://mqttx.app/docs/web))

### Development Tools & Productivity

- [MCP-Based Plugin Frameworks](https://awesome-repositories.com/f/development-tools-productivity/ai-assistant-integrations/mcp-based-plugin-frameworks.md) — Integrates a configurable AI backend that can be extended via the Model Context Protocol to interact with brokers and local files.
- [AI Prompt Dispatchers](https://awesome-repositories.com/f/development-tools-productivity/cli-command-dispatchers/ai-prompt-dispatchers.md) — MQTTX uses preset commands, custom prompts, and contextual keywords to retrieve specific information via AI. ([source](https://mqttx.app/docs/copilot))
- [Data Transformation Pipelines](https://awesome-repositories.com/f/development-tools-productivity/data-transformation-pipelines.md) — MQTTX transforms incoming MQTT messages through pre-built pipelines to simplify data handling without custom code. ([source](https://mqttx.app/docs/cli/get-started))
- [MQTT Broker Testing Tools](https://awesome-repositories.com/f/development-tools-productivity/mqtt-broker-testing-tools.md) — Includes a benchmarking mode that stress-tests broker performance with concurrent connections and configurable message rates.
- [Broker Benchmarking Tools](https://awesome-repositories.com/f/development-tools-productivity/mqtt-broker-testing-tools/broker-benchmarking-tools.md) — Stress-tests broker performance by simulating multiple concurrent connections, subscriptions, and publish streams with configurable rates. ([source](https://mqttx.app/docs/cli/get-started))

### Security & Cryptography

- [MQTT TLS Encryption](https://awesome-repositories.com/f/security-cryptography/ssl-tls-connection-security/mqtt-tls-encryption.md) — Supports one-way and two-way SSL/TLS certificate authentication and encryption for MQTT connections. ([source](https://mqttx.app/docs/cli))

### Testing & Quality Assurance

- [Test Data and Documentation Generators](https://awesome-repositories.com/f/testing-quality-assurance/software-testing/testing-frameworks/unit/unit-testing/ai-assisted-test-generators/test-data-and-documentation-generators.md) — MQTTX produces test payloads and automatically writes test documentation for current MQTT scenarios. ([source](https://mqttx.app/docs/copilot))
