mcp-server-strava

Strava API integration with Model Context Protocol (MCP) SDK

Codecs Python License: MIT Ruff

Integration for training analysis and recommendations based on Strava data using the Model Context Protocol SDK.

🚀 Features

Analysis of workouts from Strava
Training Recommendations
Automatic token update
Rate limiting for API requests

📋 Requirements

Python 3.10+
Claude Desktop
Strava account
uv (recommended)

⚙️ Installation

# Клонируем репозиторий
git clone https://github.com/rbctmz/mcp-server-strava.git
cd mcp-server-strava

# Установка через uv (рекомендуется)
curl -LsSf https://astral.sh/uv/install.sh | sh
uv pip install .

# Установка в режиме разработки
uv pip install -e ".[dev]"

Installing MCP SDK

uv add "mcp[cli]"

🔧 Setting

Setting up Strava API

Go to the API settings page
Create an application:
- Application Name: MCP Strava Integration
- Category: Training Analysis
- Website: http://localhost
- Authorization Callback Domain: localhost

Setting up the environment

Create a file with environment variables:
cp .env-template .env
Get access tokens:
python scripts/auth.py
Check the setting:
mcp dev src/server.py curl -X GET "http://localhost:8000/activities"

📚 API and examples

Resources and Tools

Type	Name	Description
Resource	`strava://activities`	List of activities
Resource	`strava://activities/{id}`	Activity details
Resource	`strava://athlete/zones`	Training zones
Resource	`strava://athlete/clubs`	Athlete's clubs
Resource	`strava://gear/{gear_id}`	Equipment Information
Tool	`analyze_activity(activity_id)`	Training Analysis
Tool	`analyze_training_load(activities)`	Load analysis
Tool	`get_activity_recommendations()`	Recommendations

Examples of use

from mcp import ClientSession

# Получение активностей
async with ClientSession() as session:
    activities = await session.read_resource("strava://activities")
    activity = await session.read_resource("strava://activities/12345678")

# Анализ тренировки
result = analyze_activity(activity_id="12345678")
"""
{
    "type": "Run",
    "distance": 5000,
    "moving_time": 1800,
    "analysis": {
        "pace": 5.5,  # мин/км
        "effort": "Средняя"
    }
}
"""

# Анализ нагрузки
summary = analyze_training_load(activities)
"""
{
    "activities_count": 10,
    "total_distance": 50.5,  # км
    "total_time": 5.2,      # часы
    "heart_rate_zones": {
        "easy": 4,    # ЧСС < 120
        "medium": 4,  # ЧСС 120-150
        "hard": 2     # ЧСС > 150
    }
}
"""

# Получение тренировочных зон
async with ClientSession() as session:
    zones = await session.read_resource("strava://athlete/zones")
    """
    {
        "heart_rate": {
            "custom_zones": true,
            "zones": [
                {"min": 0, "max": 120, "name": "Z1 - Recovery"},
                {"min": 120, "max": 150, "name": "Z2 - Endurance"},
                {"min": 150, "max": 170, "name": "Z3 - Tempo"},
                {"min": 170, "max": 185, "name": "Z4 - Threshold"},
                {"min": 185, "max": -1, "name": "Z5 - Anaerobic"}
            ]
        },
        "power": {
            "zones": [
                {"min": 0, "max": 180},
                {"min": 181, "max": 250},
                {"min": 251, "max": 300},
                {"min": 301, "max": 350},
                {"min": 351, "max": -1}
            ]
        }
    }
    """

🛠 Development

CI/CD and Security

Checks in GitHub Actions

Type	Tool	Description
Linting	ruff	Code formatting and analysis
Tests	pytest	Unit and integration tests
Coating	pytest-cov	Code Coverage Report

Security and Secrets

Token protection:
- .env to .gitignore
- GitHub Secrets for CI/CD
- Rate limiting: 100 requests/15 min
Setting up secrets:
# В GitHub: Settings → Secrets → Actions STRAVA_CLIENT_ID=<client_id> STRAVA_CLIENT_SECRET=<client_secret> STRAVA_REFRESH_TOKEN=<refresh_token>

Contributing

Fork the repository
Install dependencies: uv pip install -e ".[dev]"
Create a branch: git checkout -b feature/name
Check the changes:
ruff format . ruff check . pytest --cov=src
Create a Pull Request

📫 Support

GitHub Issues: create issue
Telegram: @greg_kisel

📄 License

MIT

This server cannot be installed

security - not tested

license - permissive license

quality - not tested

How are these scores calculated?

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

Integration of Strava API with Model Context Protocol SDK

Related Resources

Reddit Discussion about this server

Related MCP Servers

MCP Server for OpenMetadata
yangkyeongmo
A
security
A
license
A
quality
Enables integration with OpenMetadata by wrapping its REST API for standardized interaction through the Model Context Protocol.
Last updated -
6
15
Python
MIT License
Strava MCP Server
tomekkorbak
A
security
A
license
A
quality
A Model Context Protocol server that provides language models with access to Strava API data, allowing them to query and analyze athlete activities from Strava.
Last updated -
4
13
Python
MIT License
Strava MCP Server
ctvidic
-
security
A
license
-
quality
A Model Context Protocol server that enables language models to interact with Strava data, including activities, athlete statistics, routes, achievements, and social features.
Last updated -
2
Python
MIT License
Strava MCP Server
yorrickjansen
A
security
A
license
A
quality
A Model Context Protocol server that enables users to access Strava fitness data, including user activities, activity details, segments, and leaderboards through a structured API interface.
Last updated -
3
3
Python
MIT License

View all related MCP servers

Appeared in Searches

A server or service for accessing sports data

mcp-server-strava

Strava API integration with Model Context Protocol (MCP) SDK

🚀 Features

📋 Requirements

⚙️ Installation

Installing MCP SDK

🔧 Setting

Setting up Strava API

Setting up the environment

📚 API and examples

Resources and Tools

Examples of use

🛠 Development

CI/CD and Security

Checks in GitHub Actions

Security and Secrets

Contributing

📫 Support

📄 License

Related Resources

Related MCP Servers

MCP Server for OpenMetadata

Strava MCP Server

Strava MCP Server

Strava MCP Server

Appeared in Searches

New MCP Servers

MCP directory API