Oura Ring OAuth2 MCP Server
Complete Oura Ring integration with OAuth2 authentication and sleep data access using FastMCP and Smithery.
Setup
- Install dependencies:
uv sync
- Test locally:
uv run playground
MCP Tools
OAuth2 Authentication
get_auth_url- Get OAuth2 authorization URLexchange_code- Exchange code for access token (auto-stores token)parse_redirect_url- Parse redirect URL and auto-extract token (smoother UX)set_access_token- Manually set access token (backup method)
Sleep Data
get_sleep_last_night- Get sleep data from last nightget_sleep_last_week- Get sleep data from past week with average scoreget_sleep_by_date- Get sleep data for specific date (YYYY-MM-DD)
Usage
1. OAuth2 Authentication
- Set session configuration with your Oura API credentials (
client_id,client_secret,redirect_uri) - Call
get_auth_urlto get authorization URL - Visit URL and authorize
- Copy the entire redirect URL
- Use
parse_redirect_urlwith the full URL (auto-extracts and stores token)
2. Access Sleep Data
Once authenticated, use any sleep data tool:
- "What was my sleep score last night?"
- "Show me my sleep data from the past week"
- "Get my sleep data for 2024-10-01"
Session Configuration
Set these in Smithery dashboard:
client_id- Oura API client ID (required)client_secret- Oura API client secret (required)redirect_uri- OAuth2 redirect URI (default: http://localhost:8080/callback)access_token- Auto-populated after OAuth2 authentication
Deploy
Push to GitHub and deploy via Smithery dashboard.