Oura MCP Server

Instructions

Get sleep data for today.

Returns:
    Dictionary containing sleep data for today

Implementation Reference

• src/oura_mcp_server/server.py:407-422 (handler)

  The handler function for the 'get_today_sleep_data' tool. It is decorated with @mcp.tool(), which registers it as an MCP tool. The function fetches sleep data for today using the oura_client, or returns an error if the client is not initialized.

  @mcp.tool()
  def get_today_sleep_data() -> dict[str, Any]:
      """
      Get sleep data for today.
  
      Returns:
          Dictionary containing sleep 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_sleep_data(today, today)
      except Exception as e:
          return {"error": str(e)}