[](https://github.com/hivemq/mqtt-cli/releases)
[](https://github.com/hivemq/mqtt-cli/actions/workflows/check.yml?query=branch%3Amaster)
[](https://github.com/hivemq/mqtt-cli/releases)
[](https://github.com/hivemq/mqtt-cli/blob/develop/LICENSE)
mqtt-cli is a feature-rich MQTT Command Line Interface.
[Getting Started](#getting-started) • [Publish](#publish) • [Subscribe](#subscribe) • [Shell](#shell) • [Test](#test) • [How to Contribute](#how-to-contribute)
Getting Started
Publish
- Publish a message
- Quick start:
mqtt pub -t your-topic -m "your message" -h your-mqtt-broker.com - Further documentation
Subscribe
- Subscribe to topics and receive output directly on the console
- Quick start:
mqtt sub -t your-topic -h your-mqtt-broker.com - Further documentation
Shell
- Enter the mqtt-cli shell mode to access more MQTT functionality
- Quick start:
mqtt sh - Further documentation
Test
- Run tests against a broker to find out its features and limitations
- Quick start:
mqtt test -h your-mqtt-broker.com - Further documentation
How to Contribute
- If you want to request a feature or report a bug, please create a GitHub Issue using one of the provided templates
- If you want to make a contribution to the project, please have a look at the contribution guide