Tomekkorbak Strava MCP Server

A server based on the Model Context Protocol (MCP) that provides access to the Strava API, allowing language models to query athlete activity data.

Health and wellness Developer tools #Sports data #API service #Activity query .Python

rating : 2 points

downloads : 14

update time : 2025-04-29

What is Strava MCP Server?

The Strava MCP Server acts as a bridge between your Strava fitness data and AI language models. It securely accesses your workout information from Strava and makes it available for querying through conversational interfaces like Claude.

How does it work?

After connecting your Strava account, you can ask questions about your activities in natural language. The server translates these requests into Strava API calls and returns structured data that AI can understand and respond with.

When would I use this?

Perfect for fitness enthusiasts who want to analyze their workout patterns, track progress over time, or get quick summaries of their activities without digging through the Strava app.

Key Features

Activity LookupRetrieve your workout details including distance, duration, speed and elevation data

Date Range FilteringGet activities from specific time periods using natural date ranges

Consistent Data FormatAll activity data is returned in standardized units and fields for reliable analysis

Pros and Cons

Advantages

Get workout insights without manually analyzing Strava data

Ask questions in natural language instead of using complex filters

Standardized data format makes comparisons easier

Works with popular AI assistants like Claude

Limitations

Requires Strava API access setup

Limited to data available through Strava's API

Needs periodic reauthentication with Strava

Setup Guide

Create Strava API App

Go to Strava API Settings and register a new application to get your API credentials

Get Authentication Tokens

Run the included script to generate and save your access tokens

Configure MCP Server

Add the server configuration to your Claude settings file with your credentials

Example Queries

Recent Activity SummaryGet a quick overview of your latest workouts

Weekly MileageCalculate your total running distance for the week

Activity DetailsGet comprehensive information about a specific workout

Frequently Asked Questions

Is my Strava data secure?

Why do I need to create a Strava API app?

What workout metrics are available?

Helpful Resources

Strava API Documentation

Official API reference for available data fields and endpoints

MCP Protocol Guide

Learn about the Model Context Protocol standard

GitHub Repository

Source code and issue tracker for the server

🚀 Strava MCP Server

A Strava API server that provides access to the Model Context Protocol (MCP), allowing language models to query athletes' activity data.

🚀 Quick Start

This is a Strava API server that offers access to the Model Context Protocol (MCP). It enables language models to query athletes' activity data.

✨ Features

Available Tools

The server exposes the following tools:

Activity Queries

get_activities(limit: int = 10): Get the most recent activities of the authenticated athlete.
get_activities_by_date_range(start_date: str, end_date: str, limit: int = 30): Get activities within a specific date range.
get_activity_by_id(activity_id: int): Get detailed information about a specific activity.
get_recent_activities(days: int = 7, limit: int = 10): Get activities from the past X days.

Dates should be provided in ISO format (YYYY-MM-DD).

Activity Data Format

The server returns activity data with consistent field names and units:

Property	Details	Unit
`name`	Activity name	-
`sport_type`	Sport type	-
`start_date`	Start date and time	ISO 8601
`distance_metres`	Distance	Metres
`elapsed_time_seconds`	Total elapsed time	Seconds
`moving_time_seconds`	Moving time	Seconds
`average_speed_mps`	Average speed	Metres per second
`max_speed_mps`	Maximum speed	Metres per second
`total_elevation_gain_metres`	Total elevation gain	Metres
`elev_high_metres`	Highest elevation	Metres
`elev_low_metres`	Lowest elevation	Metres
`calories`	Burned calories	kcal
`start_latlng`	Start coordinates	[Latitude, Longitude]
`end_latlng`	End coordinates	[Latitude, Longitude]

📦 Installation

Authentication

To use this server, you need to authenticate through the Strava API. Follow these steps:

Create a Strava API application:
- Go to Strava API Settings.
- Log in and create a new application.
- Record the generated Client ID and Client Secret.
Obtain a refresh token:
- Use the credentials of your Strava application to obtain a refresh token via OAuth or other means.
- The refresh token is used for subsequent access to athlete data.
Set environment variables:
- Add STRAVA_CLIENT_ID and STRAVA_CLIENT_SECRET to your environment.

💻 Usage Examples

Usage on Claude Desktop

Open a terminal and run the following command:

python3 src/main.py --config config.yaml

Usage on Claude Web

Upload the contents of the project folder to a server.
Configure the web application to access the Strava API.

📚 Documentation

Error Handling

This server provides friendly prompt messages for common errors, such as network issues, authentication failures, or invalid inputs.

📄 License

MIT License

Featured MCP Services

Gitlab MCP Server

Certified

The GitLab MCP server is a project based on the Model Context Protocol that provides a comprehensive toolset for interacting with GitLab accounts, including code review, merge request management, CI/CD configuration, and other functions.

A Python-based MCP Server that provides advanced to-do list management and content organization functions through the Notion API, enabling seamless integration between AI models and Notion.

Markdownify is a multi-functional file conversion service that supports converting multiple formats such as PDFs, images, audio, and web page content into Markdown format.

TypeScript

1.7K

5 points

Duckduckgo MCP Server

Certified

The DuckDuckGo Search MCP Server provides web search and content scraping services for LLMs such as Claude.

Framelink Figma MCP Server is a server that provides access to Figma design data for AI programming tools (such as Cursor). By simplifying the Figma API response, it helps AI more accurately achieve one - click conversion from design to code.

UnityMCP is a Unity editor plugin that implements the Model Context Protocol (MCP), providing seamless integration between Unity and AI assistants, including real - time state monitoring, remote command execution, and log functions.

564

5 points

Gmail MCP Server

A Gmail automatic authentication MCP server designed for Claude Desktop, supporting Gmail management through natural language interaction, including complete functions such as sending emails, label management, and batch operations.

The MiniMax Model Context Protocol (MCP) is an official server that supports interaction with powerful text-to-speech, video/image generation APIs, and is suitable for various client tools such as Claude Desktop and Cursor.

Python

753

4.8 points

Zhiqi Future, Your AI Solution Think Tank

English 简体中文繁體中文にほんご