Strava MCP Server

Instructions

Implementation Reference

• src/tools/listAthleteClubs.ts:5-52 (handler)

  The `listAthleteClubs` object contains the tool definition, including its name, description, and the `execute` function which handles the logic of calling the Strava API and formatting the output.

  export const listAthleteClubs = {
      name: "list-athlete-clubs",
      description: "Lists the clubs the authenticated athlete is a member of.",
      inputSchema: undefined,
      execute: async () => {
          const token = process.env.STRAVA_ACCESS_TOKEN;
  
          if (!token || token === 'YOUR_STRAVA_ACCESS_TOKEN_HERE') {
              console.error("Missing or placeholder STRAVA_ACCESS_TOKEN in .env");
              return {
                  content: [{ type: "text" as const, text: "❌ Configuration Error: STRAVA_ACCESS_TOKEN is missing or not set in the .env file." }],
                  isError: true,
              };
          }
  
          try {
              console.error("Fetching athlete clubs...");
              const clubs = await fetchClubs(token);
              console.error(`Successfully fetched ${clubs?.length ?? 0} clubs.`);
  
              if (!clubs || clubs.length === 0) {
                  return { content: [{ type: "text" as const, text: " MNo clubs found for the athlete." }] };
              }
  
              const clubText = clubs.map(club =>
                  `
  👥 **${club.name}** (ID: ${club.id})
     - Sport: ${club.sport_type}
     - Members: ${club.member_count}
     - Location: ${club.city}, ${club.state}, ${club.country}
     - Private: ${club.private ? 'Yes' : 'No'}
     - URL: ${club.url || 'N/A'}
          `.trim()
              ).join("\n---\n");
  
              const responseText = `**Your Strava Clubs:**\n\n${clubText}`;
  
              return { content: [{ type: "text" as const, text: responseText }] };
          } catch (error) {
              const errorMessage = error instanceof Error ? error.message : "An unknown error occurred";
              console.error("Error in list-athlete-clubs tool:", errorMessage);
              return {
                  content: [{ type: "text" as const, text: `❌ API Error: ${errorMessage}` }],
                  isError: true,
              };
          }
      }
  };