Oura MCP Server

Instructions

Implementation Reference

• src/oura_mcp_server/server.py:425-441 (handler)

  The handler function decorated with @mcp.tool(), implementing and registering the 'get_today_readiness_data' tool. It retrieves today's readiness data via the OuraClient or returns an error if not initialized.
  @mcp.tool() def get_today_readiness_data() -> dict[str, Any]: """ Get readiness data for today. Returns: Dictionary containing readiness data for today """ if oura_client is None: return {"error": "Oura client not initialized. Please provide an access token."} try: today = date.today() return oura_client.get_readiness_data(today, today) except Exception as e: return {"error": str(e)}
• src/oura_mcp_server/server.py:217-261 (helper)

  Helper method in the OuraClient class that fetches readiness data from the Oura API, transforms it by removing id and timestamp fields, and is called by the tool handler for today's data.
  def get_readiness_data( self, start_date: date, end_date: Optional[date] = None ) -> dict[str, Any]: """ Get readiness data for a specific date range. Args: start_date: Start date for the query end_date: End date for the query (optional, defaults to start_date) Returns: Dictionary containing readiness data """ if end_date is None: end_date = start_date params = { "start_date": start_date.isoformat(), "end_date": end_date.isoformat(), } url = f"{self.BASE_URL}/daily_readiness" response = self.client.get(url, headers=self.headers, params=params) if response.status_code != 200: error_msg = f"Error {response.status_code}: {response.text}" raise Exception(error_msg) # Get the raw response raw_data = response.json() # Transform the data - just return the data array directly transformed_data = [] for item in raw_data.get("data", []): # Create transformed item without the id field and timestamp fields transformed_item = { k: v for k, v in item.items() if k != "id" and not k.endswith("_timestamp") and k != "timestamp" } transformed_data.append(transformed_item) # Return with the original structure but with transformed data return {"data": transformed_data}