mcp-strava MCP Server

README

MCP Strava Server

Overview

The MCP Strava Server facilitates seamless integration between Strava APIs and Claude for Desktop. By using this server, you can process and interact with Strava activity data efficiently through Claude's MCP framework.

How to Set Up

1. Clone the Repository

Clone the MCP Strava Server repository to your local machine:

git clone https://github.com/MariyaFilippova/mcp-strava.git

2. Configure Your CLIENT_ID and CLIENT_SECRET

To set up your Strava API credentials, change src/main/resources/.env file. Add your CLIENT_ID and CLIENT_SECRET obtained from Strava API settings into the file as shown below:

CLIENT_ID="your-client-id"
CLIENT_SECRET="your-client-secret"

3. Build the Project

Use Gradle to build the project and generate the executable JAR file:

gradle shadowJar

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

4. Configure Claude for Desktop

To connect the MCP Strava Server to Claude for Desktop:

a. Install Claude for Desktop

Ensure that Claude for Desktop is installed on your machine. If you don’t already have it, download the latest version here.

b. Update Claude’s Configuration

Modify the configuration file for Claude to register the MCP Strava Server:

Open the Claude configuration file:

code ~/Library/Application\ Support/Claude/claude_desktop_config.json

Add the MCP Strava Server configuration:

{
  "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 where the JAR file is located.

Save your changes.

c. Restart Claude for Desktop

Restart the Claude for Desktop application to apply the updated configuration.

Congratulations!

The MCP Strava Server is now set up and configured. You are ready to use it with Claude for Desktop to interact with Strava activity data seamlessly.

Enjoy managing your Strava activities with ease! 🚴‍♀️ 🚴‍♂️

mcp-strava FAQ

How do I configure the Strava API credentials for the MCP Strava Server?

You need to add your CLIENT_ID and CLIENT_SECRET from Strava API settings into the src/main/resources/.env file.

What build tool is used to compile the MCP Strava Server?

The project uses Gradle to build and generate the executable JAR file.

Can the MCP Strava Server be used with other LLMs besides Claude?

Yes, while designed for Claude for Desktop, the MCP protocol supports other LLMs like OpenAI's GPT-4 and Anthropic's Claude.

Is the MCP Strava Server open source and where can I find the repository?

Yes, it is open source and available on GitHub at https://github.com/MariyaFilippova/mcp-strava.

What kind of data can I access through the MCP Strava Server?

You can access detailed Strava activity data such as workouts, routes, and performance metrics.

How secure is the MCP Strava Server when handling API credentials?

Credentials are stored locally in a .env file and should be kept secure; the server uses standard API authentication methods.

Does the MCP Strava Server support real-time updates from Strava?

It facilitates interaction with Strava APIs, enabling near real-time data retrieval depending on API limits.

What platforms can run the MCP Strava Server?

The server is Java-based and can run on any platform supporting Java and Gradle build tools.