mypy-boto3
Legacy type annotations for boto3, use types-boto3 instead.
What it is and what it does
mypy-boto3 is a type stub package that adds static type checking and IDE autocompletion support to boto3, the AWS SDK for Python. It works by providing type annotations that map boto3's dynamic client and resource creation to concrete, typed service classes. The package is generated automatically from boto3's API definitions and versioned to match boto3 releases, with version 1.43.0 corresponding to boto3 1.43.0.
The package depends on boto3 and typing-extensions, and supports Python 3.9 through 3.14. The summary notes it is a legacy package and recommends an alternative, suggesting this may be superseded; however, it remains actively maintained with 842595 monthly downloads and is in the top 5000 PyPI packages.
Use it for:
- Enable mypy or pyright to catch type errors in AWS SDK calls before runtime.
- Get IDE autocomplete and inline documentation for boto3 service clients and resources.
- Write type-safe wrapper functions around boto3 that enforce correct service and method usage.
- Migrate existing boto3 code to static typing without rewriting the underlying AWS calls.
- Validate boto3 configuration and client initialization in test suites with type checking.
Worth the install?
AI-flagged interpretation of the facts on this page — verify before relying
Provides type stubs and annotations for boto3 to enable static type checking, IDE autocompletion, and type-safe AWS SDK usage in Python.
Yes, if you use boto3 and want static type checking and IDE support. Install friction is minimal and maintenance is active. However, the package summary recommends an alternative; verify whether that better suits your needs before committing to this one.
Install
mypy-boto3 on PyPI
pip
pip install mypy-boto3uv
uv add mypy-boto3poetry
poetry add mypy-boto3Installing mypy-boto3
Before you install
Low install friction with just two runtime dependencies (boto3 and typing-extensions). Actively maintained with a recent release; repository shows 670 stars and a commit history through 2026-06-22.
License in practice
MIT license permits unrestricted use, modification, and distribution in both open-source and proprietary projects without restriction.
Quickstart
pip install mypy-boto3
import boto3
s3_client = boto3.client("s3") # Now type-checked and auto-completed
Requires Python 3.9 or later; boto3 must be installed separately as a runtime dependency.
Verify before relying
- Whether this package is actively maintained or if types-boto3 is the recommended replacement going forward.
- Coverage and accuracy of type annotations across all boto3 services and their latest API changes.
- How service-specific type annotations are installed and managed alongside the base package.
Package facts
| License | MIT (permissive) |
| Python support | supports the current Python release (>=3.9) |
| Install friction | low — pure-Python wheel |
| Runtime dependencies | 2 — boto3, typing-extensions |
| Maintenance | actively maintained — 107 days since the last release |
| Last repo commit | |
| First released | |
| Downloads | 842,595/month — #4,925 on PyPI (30-day window, as of 2026-08-14) |
| Known vulnerabilities | none known (OSV.dev, checked 2026-08-14) |
Evidence: mypy_boto3-1.43.0-py3-none-any.whl
Keywords: boto3, type-annotations, boto3-stubs, mypy, typeshed, autocomplete, autogenerated
Tags
More Software Development packages
Provides backported and experimental type hints…
permissive · top 100 on PyPI
numpyNumPy provides an N-dimensional array object…
permissive · top 100 on PyPI
fastapiFastAPI is a Python web framework for building…
permissive · top 100 on PyPI
annotated-docProvides a way to document function parameters,…
permissive · top 100 on PyPI
typerTyper builds command-line applications from…
permissive · top 1,000 on PyPI
distlibDistlib provides low-level packaging utilities…
permissive · top 1,000 on PyPI
types-boto3-s3Provides type annotations and IDE…
permissive · top 5,000 on PyPI
botocore-stubsProvides type stubs and code completion for the…
permissive · top 1,000 on PyPI
types-boto3Provides type annotations and IDE…
permissive · top 5,000 on PyPI
types-s3transferProvides type annotations and IDE code…
permissive · top 1,000 on PyPI
types-awscrtProvides type annotations and IDE code…
permissive · top 1,000 on PyPI
mypy-boto3-s3filesProvides type annotations and IDE…
permissive · top 15,000 on PyPI
boto3-stubs-fullProvides type annotations for boto3 1.43.71 to…
permissive · top 5,000 on PyPI
types-boto3-ec2Provides type annotations and IDE autocomplete…
permissive · top 5,000 on PyPI
boto3-type-annotations-with-docsProvides type-annotated stand-in classes for…
permissive · top 15,000 on PyPI
boto3-type-annotationsProvides type-annotated stand-in classes for…
permissive · top 5,000 on PyPI