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

  1. 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
  2. Said no? Turn it on later:
    hermes plugins enable mqtt
  3. 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_URL MQTT_HERMES_PASSWORD API 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
Hermes desktop Capabilities page, Plugins tab filtered to Official plugins built by Nous Research, each with an add button.
The official plugin catalog built into the app.Hermes desktop v0.22.5 · Capabilities > Plugins · Windows · captured Nov 1, 2026

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

← All plugins