---
id: grpc-stubs
version: "1.53.0.6"
license: MIT
license_treatment: permissive
maintenance: abandoned
---

# grpc-stubs — Mypy stubs for gRPC

License: permissive · Maintenance: abandoned · Downloads: 3.4M/mo

## What it is and what it does

grpc-stubs is a PEP 561-compliant stub-only package that provides type information for the gRPC library, allowing developers to use static type checkers like mypy to validate gRPC code. It depends only on grpcio and installs as a pure Python wheel with no compiled dependencies.

The package is now archived and abandoned as of 2025-04-28. The maintainer has transferred active development to typeshed, the community-maintained repository of type stubs for the Python ecosystem. While the last release was recent, no new features or fixes should be expected from this repository; users should plan to migrate to typeshed's gRPC stubs for ongoing support.

Use it for:

- Type-check gRPC service definitions and client code with mypy before runtime.
- Enable IDE autocompletion and inline type hints for gRPC imports and calls.
- Validate gRPC message and service definitions in a CI/CD pipeline using mypy.
- Provide type safety for gRPC-based microservices during development.

## Worth the install?

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

Provides type stubs for gRPC Python, enabling static type checking of gRPC code with mypy and other type checkers.

No. The package is archived and abandoned; the maintainer explicitly directs users to typeshed for ongoing support. While it has no known vulnerabilities and low install friction, installing a stub package with no active maintenance creates a maintenance debt. Install typeshed's gRPC stubs instead, or use a tool that automatically pulls stubs from typeshed.

## Install

pip install grpc-stubs
uv add grpc-stubs
poetry add grpc-stubs

## Installing grpc-stubs

Before you install: Low install friction with a single runtime dependency on grpcio. However, the package is archived as of 2025-04-28 and marked abandoned; active development has moved to typeshed. The last release was 473 days ago.

License in practice: MIT license is permissive and imposes no restrictions on use, modification, or distribution.

Quickstart:

pip install grpc-stubs

Then use with mypy or another PEP 561-compliant type checker to validate gRPC code:

mypy your_grpc_code.py

Requires grpcio to be installed; intended for development/type-checking workflows, not runtime.

Verify before relying:

- Whether typeshed's gRPC stubs are a drop-in replacement or require migration steps.
- Current compatibility with Python versions beyond 3.8, given the package is archived.
- Whether the stubs remain accurate for recent grpcio versions post-abandonment.

## Package facts

- License: MIT (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: abandoned
- Downloads: 3.4M/month (top 5,000 on PyPI)
- Known vulnerabilities: none known

## Tags

grpc type stubs, mypy stubs for grpc, grpc typing, type checking grpc python, pep 561 grpc stubs, grpc type hints, static type checking grpc, type-stubs, grpc, archived

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