fastmcp/examples/auth/github_oauth
2026-04-13 17:11:17 -04:00
..
client.py AuthKit: auto-bind token audience to resource URL (RFC 8707) (#3905) 2026-04-13 17:11:17 -04:00
README.md AuthKit: auto-bind token audience to resource URL (RFC 8707) (#3905) 2026-04-13 17:11:17 -04:00
server.py AuthKit: auto-bind token audience to resource URL (RFC 8707) (#3905) 2026-04-13 17:11:17 -04:00

GitHub OAuth Example

Demonstrates FastMCP server protection with GitHub OAuth.

Setup

  1. Create a GitHub OAuth App:

    • Go to GitHub Settings > Developer settings > OAuth Apps
    • Set Authorization callback URL to: http://127.0.0.1:8000/auth/callback
    • Copy the Client ID and Client Secret
  2. Set environment variables:

    export FASTMCP_SERVER_AUTH_GITHUB_CLIENT_ID="your-client-id"
    export FASTMCP_SERVER_AUTH_GITHUB_CLIENT_SECRET="your-client-secret"
    
  3. Run the server:

    python server.py
    
  4. In another terminal, run the client:

    python client.py
    

The client will open your browser for GitHub authentication.