Strava MCP Server

Instructions

Implementation Reference

• src/tools/connectStrava.ts:119-172 (handler)

  The implementation of the check-strava-connection tool, which verifies if a user is authenticated with Strava and returns their connection status.

  export const checkStravaConnectionTool = {
      name: 'check-strava-connection',
      description: 'Check if Strava is connected and show the current connection status. Use this when the user asks about their connection status.',
      inputSchema: z.object({}),
      execute: async (): Promise<{ content: Array<{ type: 'text'; text: string }> }> => {
          try {
              const config = await loadConfig();
              
              if (!hasClientCredentials(config) && !hasValidTokens(config)) {
                  return {
                      content: [{
                          type: 'text' as const,
                          text: '❌ Not connected to Strava.\n\nSay "Connect my Strava account" to get started!',
                      }],
                  };
              }
              
              if (!hasValidTokens(config)) {
                  return {
                      content: [{
                          type: 'text' as const,
                          text: '⚠️ Strava credentials found but not fully authenticated.\n\nSay "Connect my Strava account" to complete the connection.',
                      }],
                  };
              }
              
              // Try to verify the connection
              try {
                  const token = config.accessToken!;
                  const athlete = await getAuthenticatedAthlete(token);
                  return {
                      content: [{
                          type: 'text' as const,
                          text: `✅ Connected to Strava as ${athlete.firstname} ${athlete.lastname}\n\n📍 ${athlete.city || 'Location not set'}, ${athlete.country || ''}\n🏅 ${athlete.premium ? 'Premium' : 'Free'} account\n\nConfig stored at: ${getConfigPath()}`,
                      }],
                  };
              } catch {
                  return {
                      content: [{
                          type: 'text' as const,
                          text: '⚠️ Connection may have expired.\n\nSay "Connect my Strava account" to refresh the connection.',
                      }],
                  };
              }
          } catch (error: any) {
              return {
                  content: [{
                      type: 'text' as const,
                      text: `❌ Error checking connection: ${error.message}`,
                  }],
              };
          }
      },
  };