Strava MCP Server

What is Strava MCP Server?

Strava MCP Server is a Model Context Protocol (MCP) server that enables AI assistants to interact with the Strava API. It is designed for developers using MCP‑compatible clients like Claude Desktop to retrieve and analyze Strava activities, segments, and leaderboards.

How to use Strava MCP Server?

Install with uvx strava-mcp. Configure by setting STRAVA_CLIENT_ID and STRAVA_CLIENT_SECRET environment variables, then authorize via the automatic OAuth flow. Use it with MCP clients such as Claude Desktop by adding the appropriate configuration entry.

Key features of Strava MCP Server

• Retrieve authenticated user’s activities with filters
• Get detailed information of a specific activity
• Fetch segments from a given activity
• Obtain leaderboard data for a specific segment
• Supports OAuth authentication with automatic token refresh

Use cases of Strava MCP Server

• Ask an AI assistant to list recent runs within a date range
• Analyze a specific workout’s details in a chat conversation
• Compare performance on a favorite segment via its leaderboard
• Automate periodic Strava data retrieval in MCP‑based workflows

FAQ from Strava MCP Server

What is required to use Strava MCP Server?

You need a Strava API application (Client ID and Client Secret) and an MCP client like Claude Desktop. Credentials are set as environment variables.

How does authentication work?

On first use, an OAuth flow automatically starts and opens your browser to the Strava authorization page. After authorizing, the refresh token is saved locally for future use.

What tools are available?

The server provides four tools: Get User Activities, Get Activity, Get Activity Segments, and Get Segment Leaderboard. Each supports optional parameters like time filters or effort inclusion.

How do I configure it for Claude Desktop?

Add an entry to claude_desktop_config.json that runs bash -c "source ~/.ssh/strava.sh && uvx strava-mcp", where strava.sh exports your Client ID and Client Secret.

Can I manually obtain a refresh token?

Yes, run python get_token.py from the project directory to manually get a refresh token.