home / mcp / strava mcp server

Strava MCP Server

Provides an MCP bridge to Strava data for Claude, enabling activity queries and data interactions.

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "mariyafilippova-mcp-strava": {
      "command": "java",
      "args": [
        "-jar",
        "your/path/strava-mcp-server/build/libs/strava-mcp-server-1.0.0-all.jar"
      ],
      "env": {
        "CLIENT_ID": "YOUR_CLIENT_ID",
        "CLIENT_SECRET": "YOUR_CLIENT_SECRET"
      }
    }
  }
}

The MCP Strava Server lets you bridge Strava activity data with Claude for Desktop through MCP, enabling smooth data access and control of Strava data directly from your Claude workflows.

How to use

You run the Strava MCP server locally and connect it to Claude for Desktop. The server executes your Strava-related requests and returns structured data that Claude can consume. To start using it, first ensure the server is running, then register it in Claude so you can invoke Strava-based actions from your MCP client.

Once configured, you can perform actions such as listing activities, retrieving activity details, and filtering Strava data within Claude by selecting the Strava MCP server and issuing the corresponding actions exposed by the server. Each action maps to a Strava API call behind the scenes, and results are delivered back in a structured format suitable for Claude prompts and workflows.

How to install

Prerequisites you need before installation:

- Java Runtime Environment (JRE) 11 or newer installed on your machine.

- Git to clone the repository.

How to install

# 1. Clone the MCP Strava Server repository
git clone https://github.com/MariyaFilippova/mcp-strava.git

# 2. Configure your Strava API credentials
# Create or edit the environment file to include your credentials
# Example content for the file at src/main/resources/.env
CLIENT_ID="your-client-id"
CLIENT_SECRET="your-client-secret"

3. Build the project to generate the executable JAR.

gradle shadowJar
```

The built server JAR will be located at:
`build/libs/strava-mcp-server-1.0.0-all.jar

4. Configure Claude for Desktop by registering the MCP Strava Server.

{
  "mcpServers": {
    "strava": {
      "command": "java",
      "args": [
        "-jar",
        "your/path/strava-mcp-server/build/libs/strava-mcp-server-1.0.0-all.jar"
      ]
    }
  }
}
```

Replace `your/path` with the absolute path to where the JAR file is located.

5. Save the changes and restart Claude for Desktop to apply the new MCP server configuration.

Additional configuration notes

- The MCP server uses the Strava API credentials stored in the environment file. Ensure the file path is correct and that Claude can access it when launching the server.

- The JAR name and path in the configuration must match the actual build output. If you rename or relocate the JAR, update the args in the Claude configuration accordingly.

Security and maintenance

- Keep your Strava API credentials confidential. Do not commit the .env file to version control. Use environment-based configuration or secret management where possible.

- Periodically update dependencies and rebuild the JAR to incorporate security fixes and new features from Strava API changes.