Intervals MCP Server

🚀 Intervals.icu MCP Server

The Model Context Protocol (MCP) server is used to connect Claude with the Intervals.icu API. It provides tools for authentication and retrieval of activity, event, and health data.

🚀 Quick Start

✨ Features

The MCP server can connect Claude to the Intervals.icu API, offering authentication tools and the ability to retrieve activity, event, and health data.

📦 Installation

• Python 3.10 or higher
• Model Context Protocol (MCP) Python SDK
• httpx
• python-dotenv

Step 1: Install uv (Recommended)

curl -LsSf https://astral.sh/uv/install.sh | sh

Step 2: Clone this repository

git clone https://github.com/mvilanova/intervals-mcp-server.git
cd intervals-mcp-server

Step 3: Create and activate a virtual environment

# Create a virtual environment
uv venv

# Activate the virtual environment
# On macOS/Linux:
source .venv/bin/activate
# On Windows:
.venv\Scripts\activate

Step 4: Install dependencies

uv pip install -e .

Step 5: Set environment variables

Copy and rename .env.example to .env and run the following command:

cp .env.example .env

Then edit the .env file and set your Intervals.icu athlete ID and API key:

API_KEY=your_intervals_api_key_here
ATHLETE_ID=your_athlete_id_here

Get your Intervals.icu API key

1. Log in to your Intervals.icu account.
2. Go to Settings > API.
3. Generate a new API key.

Find your athlete ID

Your athlete ID is usually shown in the URL when you log in to Intervals.icu, in the following format:

• https://intervals.icu/athlete/i12345/..., where i12345 is your athlete ID.

💻 Usage Examples

Basic Usage

Step 1: Configure Claude Desktop

To use this server with Claude Desktop, you need to add it to Claude's configuration file.

1. Run the following command from the intervals_mcp_server directory to configure Claude Desktop:

mcp install src/intervals_mcp_server/server.py --name "Intervals.icu MCP Server"

2. If you open your Claude Desktop configuration file claude_desktop_config.json, it should look like this:

{
  "servers": {
    "intervals-mcp-server": {
      "type": "stdio",
      "command": "python3",
      "args": ["-m", "mcp.cli.run_server", "--server-id=intervals-mcp-server"],
      "cwd": "${fileDirname}"
    }
  },
  "default-runtime": "node"
}

Step 2: Use in Claude

After configuration, you can use it in Claude with the following command:

claude config set --server=intervals-mcp-server

Then you can start using the provided tools.

📄 License

This project is licensed under the Apache 2.0 License.

Special Feature

Glama.ai