StravaMcp.Server 0.3.0

Strava MCP Server

A Model Context Protocol (MCP) server that exposes the Strava API as tools for LLM assistants. Built with C# / .NET 8.

Features

• OAuth2 token management with automatic refresh and persistent token storage
• 21 tools covering the full Strava read API plus activity updates
• Stdio transport — works with Claude Desktop, Claude Code, and any MCP-compatible client

Available Tools

Prerequisites

• .NET 8 SDK or later
• A Strava API application (create one here)
• A valid refresh token with read_all,activity:read_all,activity:write scopes

Getting a Refresh Token

1. Create an app at https://www.strava.com/settings/api
2. Use the OAuth2 authorization flow to get a refresh token with the required scopes. You can use the Strava OAuth2 playground or a manual flow:

https://www.strava.com/oauth/authorize?client_id=YOUR_CLIENT_ID&response_type=code&redirect_uri=http://localhost&scope=read_all,activity:read_all,activity:write&approval_prompt=force

3. Exchange the authorization code for tokens:

curl -X POST https://www.strava.com/oauth/token \
  -d client_id=YOUR_CLIENT_ID \
  -d client_secret=YOUR_CLIENT_SECRET \
  -d code=AUTHORIZATION_CODE \
  -d grant_type=authorization_code

Installation

As a .NET global tool (recommended)

dotnet tool install --global StravaMcp.Server

Then run it anywhere with:

strava-mcp-server

From source

cd src/StravaMcp.Server
dotnet build

Set environment variables:

export STRAVA_CLIENT_ID="your_client_id"
export STRAVA_CLIENT_SECRET="your_client_secret"
export STRAVA_REFRESH_TOKEN="your_refresh_token"
# Optional: custom path for cached tokens
export STRAVA_TOKEN_FILE="/path/to/strava_tokens.json"

Usage

With Claude Desktop

If installed as a global tool:

{
  "mcpServers": {
    "strava": {
      "command": "strava-mcp-server",
      "env": {
        "STRAVA_CLIENT_ID": "your_client_id",
        "STRAVA_CLIENT_SECRET": "your_client_secret",
        "STRAVA_REFRESH_TOKEN": "your_refresh_token"
      }
    }
  }
}

Or from source:

{
  "mcpServers": {
    "strava": {
      "command": "dotnet",
      "args": ["run", "--project", "/path/to/src/StravaMcp.Server"],
      "env": {
        "STRAVA_CLIENT_ID": "your_client_id",
        "STRAVA_CLIENT_SECRET": "your_client_secret",
        "STRAVA_REFRESH_TOKEN": "your_refresh_token"
      }
    }
  }
}

With Claude Code

# Global tool
claude mcp add strava -- strava-mcp-server

# Or from source
claude mcp add strava -- dotnet run --project /path/to/src/StravaMcp.Server

Make sure the environment variables are set in your shell before launching.

Direct / Standalone

strava-mcp-server
# or: dotnet run --project src/StravaMcp.Server

The server communicates via JSON-RPC over stdin/stdout. Diagnostic output goes to stderr.

Architecture

src/StravaMcp.Server/
├── Program.cs              # Entry point, wires up config + tools + server
├── Strava/
│   ├── StravaClient.cs     # HTTP client with auto token refresh
│   ├── StravaConfig.cs     # Configuration model
│   ├── StravaApiException.cs
│   └── TokenData.cs        # Token persistence model
├── Mcp/
│   ├── McpServer.cs        # JSON-RPC stdio server loop
│   ├── JsonRpcMessage.cs   # Request/response models
│   └── ToolDefinition.cs   # Tool + result models
└── Tools/
    ├── IStravaTool.cs      # Tool interface
    ├── ToolHelpers.cs      # Schema builder + argument helpers
    └── *.cs                # One file per tool (21 tools)