---
id: google-auth-stubs
version: "0.3.0"
license: Apache-2.0
license_treatment: permissive
maintenance: dormant
---

# google-auth-stubs — Type stubs for google-auth

License: permissive · Maintenance: dormant · Downloads: 1.1M/mo

## What it is and what it does

google-auth-stubs is a type stub package that adds static type information to the google-auth library. Type stubs are metadata files that tell type checkers like mypy what types and signatures exist in a package, enabling IDE autocompletion and catching type errors at development time. The stubs were generated automatically using stubgen and depend on google-auth, types-requests, and grpc-stubs.

You install this package alongside google-auth in development or testing environments where you want type checking. It does not change runtime behavior—it only provides type information to tools. Since the stubs are auto-generated and the project is dormant, there is a risk that they may lag behind google-auth releases or miss edge cases in the actual API.

Use it for:

- Enable mypy or pyright type checking in a project that uses google-auth for authentication
- Get IDE autocompletion and inline type hints when writing code that calls google-auth functions
- Catch type mismatches in authentication setup before runtime in CI/CD type-checking steps
- Support typed Python codebases that depend on google-auth without losing type safety

## Worth the install?

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

Provides type stubs for the google-auth package, enabling static type checking and IDE autocompletion for code using google-auth.

Yes, if you use google-auth and want static type checking. Install it as a dev dependency alongside google-auth. The low friction and permissive license make it a safe addition. However, dormant maintenance means stubs may not cover the latest google-auth features—verify coverage for your specific use case before relying on it in strict type-checking workflows.

## Install

pip install google-auth-stubs
uv add google-auth-stubs
poetry add google-auth-stubs

## Installing google-auth-stubs

Before you install: Low install friction with a pure-Python wheel. Maintenance is dormant—last release was 718 days ago—but the repository remains active and the package supports current Python versions.

License in practice: Apache-2.0 permissive license allows use in most projects without significant restrictions.

Quickstart:

pip install google-auth-stubs

Then in your Python code with google-auth:
import google.auth
credentials, project = google.auth.default()

Verify before relying:

- Whether stubs are kept in sync with google-auth releases and cover the full API surface
- Whether stubgen-generated stubs are sufficiently complete for complex authentication workflows

## Package facts

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

## Tags

type stubs google-auth, google-auth typing, mypy google-auth, static type checking authentication, google-auth type hints, IDE autocompletion google-auth, type-stubs, static-typing

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