NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
PyPI
PyPI, #1263 most downloaded on PyPI
MQTT version 5.0/3.1.1 client class
Latest stable
2.2.0
Last release 18 days ago
04 Nov 2026
Release timing varies
gaps range from 2 weeks to 2.5 years
Most releases are documented
notes for 17 of 22 stable releases
Nothing withdrawn
no release was ever pulled
13 years old
23 releases · first in 2013
Drag across the ruler to compare, or tap a release to open it.
Possible breaking change: Change some exceptions from ValueError to TypeError (in max_queued_messages_set and Client callback_api_version parameter) (…
ValueError to TypeError
(in max_queued_messages_set and Client callback_api_version parameter) (Closes #972)
The breaking change is unlikely however, both exceptions are expected to only be
raised with broken code (e.g. need to pass wrong type - not just wrong value).bytearray was missing as alternative of some payload (Closes #918)drop_out_messages to discard outgoing message queue. This could be needed if broker lost
the session (Closes #935)reinitialise() (Closes #824)Your coding agent can read these notes before it upgrades. Set up the MCP server →
Make transition from 1.x to 2.x version smoother (Closes #831)
This release include breaking change. See https://eclipse.dev/paho/files/paho.mqtt.python/html/migrations.html for more details on how to upgrade.
This release include breaking change. See https://eclipse.dev/paho/files/paho.mqtt.python/html/migrations.html for more details on how to upgrade.
This release also introduce new documentation available online at https://eclipse.dev/paho/files/paho.mqtt.python/html/index.html
CallbackAPIVersion.VERSION1 to first argument of Client()max_packets argument in loop(), loop_write() and loop_forever() is removedforce argument in loop_stop() is removedmessage_retry_set() is removedlogger, if a sub-class defined logger, the two logger
will conflict.subscribe() when topic is an empty list. Closes #690.publish.multiple() when msgs is an empty list. Closes #684.This release include breaking change. See migrations.md for more details on how to upgrade.
This release include breaking change. See migrations.md for more details on how to upgrade.
CallbackAPIVersion.VERSION1 to first argument of Client()max_packets argument in loop(), loop_write() and loop_forever() is removedforce argument in loop_stop() is removedmessage_retry_set() is removedlogger, if a sub-class defined logger, the two logger
will conflict.subscribe() when topic is an empty list. Closes #690.publish.multiple() when msgs is an empty list. Closes #684.Yes it's an rc2 without rc1... that because rc1 failed due to README issue
- Fix Python 2.7 compatibility.
Changed default TLS version to 1.2 instead of 1.0.
rc parameter in the on_disconnect callback now has meaningful values
in the case of an error. Closes #441.Properties.json() now converts Correlation Data bytes() objects to hex.
Closes #555.Exceptions that occur in callbacks are no longer suppressed by default. They can optionally be suppressed by setting client.suppress_exceptions = True
client.suppress_exceptions = True.
Closes #365.Add support for clean_session on subscribe helper. Closes #219
Fix hang when client restarted and broker resumed a session with Qos2 message. Closes #284. Note: this change replace the hang by a message lost ! See
Fix reconnect_delay_set which ignored the max_delay. Closes #218.
BREAKING Requires Python 2.7 or 3.4+. Closes #163.
Fix possible hang of TLS connection during handshake. Closes #3.
Fix message lost when using paho.mqtt.publish helper with QoS=0 message. Closes #172.
Handle unicode username and passwords correctly. Closes #79.
Client.publish() now returns an MQTTMessageInfo object. The MQTTMessageInfo object behaves like a tuple of (rc, mid) for backwards compatibility but a
Add support for wildcard certificates. Closes #440547.
Default protocol is now MQTT v3.1.1.
Fix CONNECT packet for MQTT v3.1.1.
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
One column per quarter.