GitHub OAuth Mock

About

A lightweight mock server that simulates GitHub's OAuth endpoints. Perfect for E2E testing when you need to test authentication flows without hitting real GitHub servers.

The mock is completely stateless — tokens are self-contained and encode user information directly, eliminating the need for shared storage across replicas.

Accounts

Email verification status is determined by the email pattern you enter:

✓

Verified User

Any email not starting with "unverified"

[email protected]

✗

Unverified User

Emails starting with "unverified"

[email protected]

API

GET /login/oauth/authorize Login form

POST /login/oauth/authorize Process login

POST /login/oauth/access_token Token exchange

GET /api/user User profile

GET /api/user/emails Email verification

Run locally

$ uv run fastapi dev # or with custom port $ uv run fastapi dev --port 9000

Live Demo API Docs GitHub