Skip to main content

litestar-oauth-server

pipeline status PyPI version Python versions License: MIT

An OAuth 2.1 authorization server plugin for Litestar: PKCE, client registration, token and refresh, with MCP-ready metadata

Install

pip install litestar-oauth-server

Requires Python 3.12+.

Quickstart

from litestar import Litestar, Request, get
from litestar_oauth_server import (
    AuthorizationServer, LitestarOAuth, OAuthConfig, bearer_guard, in_memory_stores, verified_token,
)

RESOURCE = "https://api.example.com/mcp"

server = AuthorizationServer(
    config=OAuthConfig(
        issuer="https://api.example.com",
        authorization_endpoint="https://app.example.com/oauth/authorize",  # your consent page
        resources=(RESOURCE,),
        scopes_supported=("things:read", "things:write"),
    ),
    stores=in_memory_stores(),  # use stores on your own database in production
)

@get("/mcp", guards=[bearer_guard(server, RESOURCE, scope="things:read")])
async def things(request: Request) -> str:
    token = verified_token(request)  # subject, binding, scopes
    return f"hello {token.subject}, pinned to {token.binding}"

app = Litestar([things], plugins=[LitestarOAuth(server)])

Your consent page signs the user in with your own login, then calls server.approve(request, Approval(subject=..., scopes=..., binding=...)) and sends the browser to the URL it returns. See examples/basic.py.

Why litestar-oauth-server

Adding "Connect to Claude", a CLI login or a third-party integration to a Litestar API needs an OAuth 2.1 authorization server: PKCE, client registration, token and refresh, discovery documents. This library provides that part and leaves the login, the consent screen and the database to your app. It is the server side an MCP connector needs, and it works the same for any other client.

Key features

  • Authorization code flow with PKCE (S256 only), public clients, refresh token rotation.
  • Server metadata (RFC 8414), protected resource metadata (RFC 9728), dynamic client registration (RFC 7591), revocation (RFC 7009), resource indicators (RFC 8707).
  • A binding on every token: the tenant chosen on the consent screen. The token never crosses it.
  • Narrow scopes: the user approves a subset of what the client asked for (read-only first).
  • Code and refresh token are single use; a reused refresh token revokes its whole family.
  • A bearer guard that answers 401 with WWW-Authenticate: Bearer resource_metadata=....
  • Frozen dataclasses throughout; storage is three small protocols you implement on your database.

Contributing

Developer setup, the dev loop, and the release process live in CONTRIBUTING.md. In short: uv sync && make install-hooks, then make check runs the same gate CI runs.

License

MIT © 2026 Jorge Cardona (see LICENSE).

Metadata

Release files for litestar-oauth-server 0.0.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for litestar-oauth-server 0.0.1
File Size Uploaded Provenance Actions
litestar_oauth_server-0.0.1.tar.gz 18.0 kB Without provenance Details for litestar_oauth_server-0.0.1.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for litestar-oauth-server 0.0.1
File Interpreter ABI Platform Actions
litestar_oauth_server-0.0.1-py3-none-any.whl Python 3 none any Details for litestar_oauth_server-0.0.1-py3-none-any.whl

Total release size: 33.5 kB

Release files / litestar_oauth_server-0.0.1.tar.gz

Download URL litestar_oauth_server-0.0.1.tar.gz
Size 18.0 kB
Tags Source
SHA-256 checksum
How to use checksums
18994d95440dda9d2a5e41fd50359cd675b9112a407df5872e85f057d3d92e96
BLAKE2b-256 checksum
How to use checksums
12603cf9e8cf5660b338d2813229cfffaf726f2d266a232d3aeef622e4cce2d0
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via uv/0.11.19 {"installer":{"name":"uv","version":"0.11.19","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Debian GNU/Linux","version":"12","id":"bookworm","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

Release files / litestar_oauth_server-0.0.1-py3-none-any.whl

Download URL litestar_oauth_server-0.0.1-py3-none-any.whl
Size 15.5 kB
Tags Python 3
SHA-256 checksum
How to use checksums
4389dc297f432d8c5dbbae6101e3492a8cd6a3d4a906c78a853a004eb1a98bff
BLAKE2b-256 checksum
How to use checksums
1f5c5fc65c9c2114605e66060f60c2f53052ef3bfdff07614b9826949557427a
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via uv/0.11.19 {"installer":{"name":"uv","version":"0.11.19","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Debian GNU/Linux","version":"12","id":"bookworm","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

Security for litestar-oauth-server 0.0.1

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page