---
id: types-paho-mqtt
version: "1.6.0.20240321"
license: Apache-2.0 license
license_treatment: permissive
maintenance: active
---

# types-paho-mqtt — Typing stubs for paho-mqtt

License: permissive · Maintenance: active · Downloads: 135.3K/mo

## What it is and what it does

This package provides PEP 561 type stubs for the paho-mqtt MQTT client library, version 1.6.*. Type stubs are metadata files that tell static type checkers like mypy and pyright what types to expect from paho-mqtt's functions and classes, enabling type-safe code development without requiring the library itself to include annotations.

The stubs are maintained in the Python typeshed repository and tested against multiple type checkers. If you are using paho-mqtt 1.6.x and want static type checking support, install this package alongside paho-mqtt. Note that paho-mqtt 2.0.0 and later versions include their own type annotations, making this stub package unnecessary for newer releases.

Use it for:

- Enable mypy or pyright to type-check code that imports and uses paho-mqtt 1.6.x.
- Catch type errors in MQTT client setup and message handling before runtime.
- Provide IDE autocomplete and type hints for paho-mqtt APIs in editors like PyCharm.
- Maintain type safety in projects locked to paho-mqtt 1.6.* for compatibility reasons.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Provides type stubs for paho-mqtt 1.6.* to enable static type checking with mypy, pyright, pytype, and other tools.

Yes, if you use paho-mqtt 1.6.* and want static type checking. Install friction is negligible, maintenance is active, and the Apache-2.0 license poses no restrictions. Do not install if you are already on paho-mqtt 2.0.0 or later, as those versions include built-in type annotations.

## Install

pip install types-paho-mqtt
uv add types-paho-mqtt
poetry add types-paho-mqtt

## Installing types-paho-mqtt

Before you install: Low friction: pure Python wheel with no runtime dependencies. Actively maintained via typeshed with recent updates.

License in practice: Apache-2.0 permissive license allows use in most projects with minimal restrictions.

Quickstart:

pip install types-paho-mqtt

# In your code using paho-mqtt, type checkers will now understand the types
import paho.mqtt.client as mqtt
client: mqtt.Client = mqtt.Client()

Requires paho-mqtt 1.6.* to be installed separately; paho-mqtt 2.0.0+ includes its own type stubs and makes this package redundant.

Verify before relying:

- Whether type coverage is complete for all paho-mqtt 1.6.* APIs and edge cases.
- Compatibility with paho-mqtt 1.6.x patch versions beyond the latest tested release.

## Package facts

- License: Apache-2.0 license (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 135.3K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

type stubs paho-mqtt, paho-mqtt type hints, mqtt type checking, mypy paho-mqtt, python mqtt typing, paho mqtt annotations, type-stubs, mqtt

[View on SkillFed](https://skillfed.io/packages/types-paho-mqtt) · [View on PyPI](https://pypi.org/project/types-paho-mqtt/)