skillfed

mypy-boto3

Legacy type annotations for boto3, use types-boto3 instead.

mypy-boto3 v1.43.0 842.6K downloads/30d#4,925 on PyPI670
Permissive license MIT Active released

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-boto3

uv

uv add mypy-boto3

poetry

poetry add mypy-boto3

Installing 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

Development Status :: 5 - Production/StableEnvironment :: ConsoleIntended Audience :: DevelopersNatural Language :: EnglishOperating System :: OS IndependentProgramming Language :: Python :: 3Programming Language :: Python :: 3 :: OnlyProgramming Language :: Python :: 3.10Programming Language :: Python :: 3.11Programming Language :: Python :: 3.12Programming Language :: Python :: 3.13Programming Language :: Python :: 3.14Programming Language :: Python :: 3.9Programming Language :: Python :: Implementation :: CPythonTyping :: Stubs Only

Tags

boto3 type annotationsboto3 type stubsmypy boto3 typesaws sdk type checkingboto3 autocompletestatic typing for boto3boto3 type hints
type-stubsaws-sdkstatic-typing

More Software Development packages