Strava MCP Server

Instructions

Get activities within a specific date range.

Args:
    start_date: Start date in ISO format (YYYY-MM-DD)
    end_date: End date in ISO format (YYYY-MM-DD)
    limit: Maximum number of activities to return (default: 30)

Returns:
    Dictionary containing activities data

Implementation Reference

• src/strava_mcp_server/server.py:237-267 (handler)

  The handler function for the 'get_activities_by_date_range' tool, decorated with @mcp.tool() for registration. Parses input dates, queries Strava API via client, and returns activities or error.

  @mcp.tool()
  def get_activities_by_date_range(start_date: str, end_date: str, limit: int = 30) -> dict[str, Any]:
      """
      Get activities within a specific date range.
  
      Args:
          start_date: Start date in ISO format (YYYY-MM-DD)
          end_date: End date in ISO format (YYYY-MM-DD)
          limit: Maximum number of activities to return (default: 30)
  
      Returns:
          Dictionary containing activities data
      """
      if strava_client is None:
          return {
              "error": "Strava client not initialized. Please provide refresh token, client ID, and client secret."  # noqa: E501
          }
  
      try:
          start = parse_date(start_date)
          end = parse_date(end_date)
  
          # Convert dates to timestamps
          after = int(datetime.combine(start, datetime.min.time()).timestamp())
          before = int(datetime.combine(end, datetime.max.time()).timestamp())
  
          activities = strava_client.get_activities(limit=limit, before=before, after=after)
          return {"data": activities}
      except Exception as e:
          return {"error": str(e)}

• src/strava_mcp_server/server.py:184-198 (helper)

  Helper function to parse ISO date strings, used in the tool handler to convert start_date and end_date.

  def parse_date(date_str: str) -> date:
      """
      Parse a date string in ISO format (YYYY-MM-DD).
  
      Args:
          date_str: Date string in ISO format
  
      Returns:
          Date object
      """
      try:
          return date.fromisoformat(date_str)
      except ValueError as err:
          raise ValueError(f"Invalid date format: {date_str}. Expected format: YYYY-MM-DD") from err

• src/strava_mcp_server/server.py:82-106 (helper)

  StravaClient method called by the tool handler to fetch activities from Strava API using the computed timestamps.

  def get_activities(
      self, limit: int = 10, before: Optional[int] = None, after: Optional[int] = None
  ) -> list:
      """
      Get the authenticated athlete's activities.
  
      Args:
          limit: Maximum number of activities to return
          before: Unix timestamp to filter activities before this time
          after: Unix timestamp to filter activities after this time
  
      Returns:
          List of activities
      """
      params = {"per_page": limit}
  
      if before:
          params["before"] = before
  
      if after:
          params["after"] = after
  
      activities = self._make_request("athlete/activities", params)
      return self._filter_activities(activities)