strava-mcp

strava-mcp

3

The Strava MCP Server is a Model Context Protocol server that facilitates interaction with the Strava API, offering tools for retrieving user activities, activity details, and segment leaderboards. It provides a comprehensive user and developer guide to set up and manage authentication, project setup, and deployment processes effectively.

Strava MCP Server

A Model Context Protocol (MCP) server for interacting with the Strava API.

User Guide

Installation

  • Install Strava MCP with uvx.

Setting Up Strava Credentials

  1. Create a Strava API Application.
  2. Configure your credentials.
  3. Configure Claude Desktop.

Authentication

  • An automatic authentication flow connects to Strava.

Available Tools

  • Get User Activities: Retrieves user activities.
  • Get Activity: Provides activity details.
  • Get Activity Segments: Retrieves segments from an activity.
  • Get Segment Leaderboard: Gets leaderboard for a segment.

Developer Guide

Project Setup

  1. Clone the repository.
  2. Install dependencies.
  3. Set up environment variables.

Running in Development Mode

  • Use MCP CLI.

Manual Authentication

  • Get a refresh token using a script.

Project Structure

  • Detailed structure for package and testing.

Running Tests

  • Use pytest.

Publishing to PyPI

  • Build and publish packages.