---
id: grpc-interceptor
version: "0.15.4"
license: MIT
license_treatment: permissive
maintenance: dormant
---

# grpc-interceptor — Simplifies gRPC interceptors

License: permissive · Maintenance: dormant · Popularity: top 1,000 on PyPI

## Install

pip install grpc-interceptor
uv add grpc-interceptor
poetry add grpc-interceptor

## Description

[![Tests](https://github.com/d5h-foss/grpc-interceptor/workflows/Tests/badge.svg)](https://github.com/d5h-foss/grpc-interceptor/actions?workflow=Tests)
[![Codecov](https://codecov.io/gh/d5h-foss/grpc-interceptor/branch/master/graph/badge.svg)](https://codecov.io/gh/d5h-foss/grpc-interceptor)
[![Read the Docs](https://readthedocs.org/projects/grpc-interceptor/badge/)](https://grpc-interceptor.readthedocs.io/)
[![PyPI](https://img.shields.io/pypi/v/grpc-interceptor.svg)](https://pypi.org/project/grpc-interceptor/)

# Summary

Simplified Python gRPC interceptors.

The Python `grpc` package provides service interceptors, but they're a bit hard to
use because of their flexibility. The `grpc` interceptors don't have direct access
to the request and response objects, or the service context. Access to these are often
desired, to be able to log data in the request or response, or set status codes on the
context.

# Installation

To just get the interceptors (and probably not write your own):

```console
$ pip install grpc-interceptor
```

To also get the testing framework, which is good if you're writing your own interceptors:

```console
$ pip install grpc-interceptor[testing]
```

#...

## AI interpretation — verify before relying

Provides simplified server and client interceptors for gRPC services, making it easier to access request/response objects and service context for logging, error handling, and metadata injection.

Verdict: Stable, low-friction utility for simplifying gRPC interceptor patterns in Python. No known vulnerabilities and permissive licensing make it safe to adopt. Dormant maintenance (1001 days since last release) is acceptable for a mature, focused library, but users should be prepared to maintain a fork or patch if breaking changes in grpcio emerge.

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