---
id: types-grpcio
version: "1.83.0.20260730"
license: Apache-2.0
license_treatment: permissive
maintenance: active
---

# types-grpcio — Typing stubs for grpcio

License: permissive · Maintenance: active · Downloads: 2.4M/mo

## What it is and what it does

types-grpcio is a type stub package that provides type annotations for the grpcio library. It allows static type checkers to understand and validate code that calls gRPC functions and classes, catching type errors before runtime. The stubs are generated from the typeshed project and kept in sync with grpcio versions.

This is a stub-only package with no runtime dependencies—it exists purely to improve your development experience through type checking. It's marked as partial, meaning some annotations may be incomplete; the typeshed project welcomes contributions to fill gaps. The package is tested against mypy 2.3.0, pyright 1.1.411, and ty 0.0.59.

Use it for:

- Enable type checkers to validate gRPC client and server code in your project.
- Catch type mismatches in gRPC service definitions and method calls during development.
- Improve IDE autocomplete and inline documentation for grpcio APIs.
- Validate gRPC message marshalling and RPC handler signatures in a type-safe workflow.

## Worth the install?

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

Provides type stubs for the grpcio package, enabling static type checkers like mypy and pyright to validate code that uses gRPC.

Yes, if you use grpcio and want static type checking. Install it alongside grpcio to enable type checkers to validate your gRPC code. No runtime cost, low friction, and actively maintained. The partial coverage is not a blocker unless you hit unannotated APIs.

## Install

pip install types-grpcio
uv add types-grpcio
poetry add types-grpcio

## Installing types-grpcio

Before you install: Low install friction with no runtime dependencies. Actively maintained as part of the typeshed project, with a recent release 15 days old.

License in practice: Licensed under Apache-2.0 (permissive), imposing no restrictions on use in proprietary or open-source projects.

Quickstart:

pip install types-grpcio

import grpcio
# Type checkers now understand grpcio APIs

Requires Python 3.10 or later.

Verify before relying:

- Whether coverage of grpcio's API surface is sufficient for your specific use cases, given the package is marked as partial.
- Compatibility with type checkers other than mypy 2.3.0, pyright 1.1.411, and ty 0.0.59.

## Package facts

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

## Tags

grpc type stubs, grpcio type hints, grpc static type checking, type annotations for grpc, grpcio type checking, type-stubs, grpc

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