{"id":"yuzehao2023-mcp-oura","name":"MCP-oura","homepage":null,"repo_url":"https://github.com/YuzeHao2023/MCP-oura","category":"ai-ml","subcategories":[],"tags":["mcp","oura","health","sleep","readiness","resilience","python","api-integration"],"what_it_does":"An MCP (Model Context Protocol) server that exposes Oura API data via MCP tools, allowing clients to fetch sleep, readiness, and resilience data for today or for arbitrary ISO date ranges using an Oura personal access token.","use_cases":["Ask an LLM assistant questions about sleep scores and trends","Retrieve readiness metrics for a specific date range","Fetch resilience metrics for analysis and reporting","Build an agent workflow that summarizes Oura data using MCP tool calls"],"not_for":["High-frequency/real-time monitoring with strict latency requirements","Systems that require a public OpenAPI/REST-first developer experience","Use without handling or securing an Oura API token","Use cases needing automated writes to Oura (this appears read-only)"],"best_when":"You want a local/agent-integrated interface (MCP) to query Oura’s sleep/readiness/resilience data over specific dates.","avoid_when":"You need fine-grained API rate-limit and pagination semantics documented for automated high-volume querying, or you require OAuth flows and scoped delegation beyond a single personal access token.","alternatives":["Directly call the Oura REST API from your own service/client","Use a community/official Oura SDK (if available) to query data and summarize it in your app","Build your own MCP server wrapper around the Oura API using httpx"],"af_score":60.0,"security_score":58.5,"reliability_score":26.2,"package_type":"mcp_server","discovery_source":["github"],"priority":"high","status":"evaluated","version_evaluated":null,"last_evaluated":"2026-03-30T13:45:21.430111+00:00","interface":{"has_rest_api":false,"has_graphql":false,"has_grpc":false,"has_mcp_server":true,"mcp_server_url":null,"has_sdk":false,"sdk_languages":[],"openapi_spec_url":null,"webhooks":false},"auth":{"methods":["OURA_API_TOKEN environment variable (personal access token)"],"oauth":false,"scopes":false,"notes":"Authentication is described as a required Oura API token provided via environment variable. The README does not mention OAuth delegation or fine-grained scopes."},"pricing":{"model":null,"free_tier_exists":false,"free_tier_limits":null,"paid_tiers":[],"requires_credit_card":false,"estimated_workload_costs":null,"notes":"No pricing information for the MCP server itself is provided; costs may depend on your usage of the Oura API and your deployment environment."},"requirements":{"requires_signup":false,"requires_credit_card":false,"domain_verification":false,"data_residency":[],"compliance":[],"min_contract":null},"agent_readiness":{"af_score":60.0,"security_score":58.5,"reliability_score":26.2,"mcp_server_quality":70.0,"documentation_accuracy":60.0,"error_message_quality":null,"error_message_notes":"The README mentions human-readable error messages for common issues, but does not show structured error formats, tool schemas, or example failure payloads.","auth_complexity":85.0,"rate_limit_clarity":15.0,"tls_enforcement":70.0,"auth_strength":65.0,"scope_granularity":20.0,"dependency_hygiene":55.0,"secret_handling":80.0,"security_notes":"Token is provided via environment variable (good practice vs hardcoding). However, the README does not describe TLS enforcement details, token handling/logging behavior, or fine-grained scopes. The project is marked Beta (risk of evolving behavior).","uptime_documented":0.0,"version_stability":35.0,"breaking_changes_history":40.0,"error_recovery":30.0,"idempotency_support":"true","idempotency_notes":"Data retrieval tools are naturally idempotent (querying past or today’s data). No explicit idempotency semantics are documented.","pagination_style":"none","retry_guidance_documented":false,"known_agent_gotchas":["Tool inputs require ISO date strings (YYYY-MM-DD); invalid formats should be handled by the calling agent.","Only date-range and 'today' retrieval tools are documented; if the agent attempts additional endpoints or fields not exposed by the server, it may fail.","The server requires an Oura token via environment variable; missing/invalid tokens will cause auth failures."]}}