---
id: mypy-boto3
version: "1.43.0"
license: MIT
license_treatment: permissive
maintenance: active
---

# mypy-boto3 — Legacy type annotations for boto3, use types-boto3 instead.

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

## 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 above — 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

pip install mypy-boto3
uv add mypy-boto3
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_current
- Install friction: low
- Maintenance: active
- Downloads: 842.6K/month (top 5,000 on PyPI)
- Known vulnerabilities: none known

## Tags

boto3 type annotations, boto3 type stubs, mypy boto3 types, aws sdk type checking, boto3 autocomplete, static typing for boto3, boto3 type hints, type-stubs, aws-sdk, static-typing

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