MQTT

From its catalog listing
MQTT as a Hermes platform: one authenticated broker connection, per-topic routing (deliver, agent, job, drop) and JSON replies published outside the consumed namespace; ships its own standard-library MQTT 3.1.1/5.0 client over TCP or TLS (verified by default, optional private CA/mTLS) with keepalive, reconnect and opt-in burst coalescing, and drops unmatched topics.
Good to know before installing
holds one outbound broker connection and its reconnect loop, reads the MQTT username/password through Hermes's scoped secret route and optional TLS files at operator-provided paths, and enables trusted_inbound (the broker's authentication is the trust boundary): any publisher the broker's ACL admits can start agent turns, and on topics you map to deliver or job it can post text to the chat you name on another connected platform or run the cron job you name, while payload text can never issue gateway commands; job and cross-platform delivery go through Hermes internals (tools.cronjob_tools, the gateway runner), so a Hermes update can disable them; no telemetry, no shell, no writes.
From its catalog listing.
How to install
- Install it. Hermes asks for any API keys it needs (this one needs
MQTT_HERMES_URL,MQTT_HERMES_PASSWORD), then asks whether to turn it on.hermes plugins install mqtt - Said no? Turn it on later:
hermes plugins enable mqtt - Restart Hermes so it loads the plugin.
Some plugins also need a sign-in or settings: see Full setup & settings. Memory plugins ask whether to become your memory provider instead. Steps follow the official plugins guide (opens in a new tab).
- Category
- Coding & developer tools · Work & business · Chat apps & voice
- Maintained by
- JasonSwindle (Community)
- Needs
MQTT_HERMES_URLMQTT_HERMES_PASSWORDAPI keys- Works on
- linux, macos, windows
- Needs Hermes
- 0.22.3 or newer, below 0.23
- Version
- 0.7.0
- In the catalog
- 2026-11-02
- GitHub stars
- 1
Known issues (from its catalog listing)
- Intel Macs are not tested or supported (CI covers macos-latest, which is Apple Silicon).
- trusted_inbound is on: every publisher the broker's ACL admits can start agent turns, so scope the broker account to the subscription filter and reply topic.
Using the Hermes desktop app? See where plugins live

Full setup & settings ↗Source code ↗
More in coding & developer tools
All coding & developer tools plugins
New Hermes Agent updates every day on X. Follow @HermesWatcher