Awesome Open Source
Awesome Open Source

GitHub Release Support Platforms build packages Total Downloads Slack Discord Community YouTube Twitter

English | |

MQTT X is a cross-platform MQTT 5.0 client tool open sourced by EMQ, which can run on macOS, Linux and Windows, and supports formatting MQTT payload.

MQTT X simplifies the operation logic of the page with the help of chatting software, makes it easy and quick to create multiple simultaneous online MQTT client connections, test the connection, publish, and subscribe functions of MQTT/TCP, MQTT/TLS, MQTT/WebSocket as well as other MQTT protocol features.

MQTT stands for MQ Telemetry Transport. It is a publish/subscribe, extremely simple and lightweight messaging protocol, designed for constrained devices and low-bandwidth, high-latency or unreliable networks.




Currently available for download from these app stores

macOS App Store

Download on the Mac App Store


The macOS users can install MQTT X using brew cask

brew install --cask mqttx


Get it from the Snap Store Download on Flathub

Released Packages

Download from GitHub Releases and install it.

Alternative, you can download here.


See our blog or manual for details.

  1. Get MQTT Broker Ready.

    • If you do not need to deploy the MQTT Broker locally, you can use the public MQTT 5.0 Broker provided by EMQ X Cloud for testing:

      Broker IP:
      Broker TCP Port: 1883
      Broker SSL Port: 8883
    • To run MQTT Broker locally, EMQ X is recommended: An Open-Source, Cloud-Native, Distributed MQTT Broker for IoT.

  2. Connection configuration. Click the + button in the left menu bar and fill in the corresponding required fields in the form.

  3. After the connection information is configured, click the Connect button in the upper right corner to create a connection and connect to MQTT Broker.

  4. After the MQTT is connected successfully, you can perform MQTT publish and subscription tests.



The MQTT X community can be found on GitHub Discussions, where you can ask questions, voice ideas, and share your projects.

To chat with other community members you can join the EMQ X Slack or Discord.


Recommended version for Node environment:

  • v14.*.*
# Clone
git clone [email protected]:emqx/MQTTX.git

# Install dependencies
yarn install

# Compiles and hot-reloads for development
yarn run electron:serve

# Compiles and minifies for production
yarn run electron:build

After the building is successful, the corresponding installation file for the successful build ing will appear in the dist_electron directory.

If you need to package it as an installation package for an independent operating system, please refer to the following command:

# For Windows
yarn run electron:build-win

# For Linux
yarn run electron:build-linux

# For macOS
yarn run electron:build-mac


Please make sure to read the Contributing Guide before making a pull request.

Technology Stack


Apache License 2.0, see LICENSE.

Get A Weekly Email With Trending Projects For These Topics
No Spam. Unsubscribe easily at any time.
Typescript (264,406
Vue (83,229
Linux (17,098
Macos (9,206
Electron (6,060
Iot (5,834
Cross Platform (3,371
Mqtt (3,007
Electron App (1,153
Mqtt Client (445
Iot Application (320
Emq (21
Snap Store (13
Mqtt Tool (4
Mqttx (3
Related Projects