MCP.so
Sign In

Intervals.icu MCP Server

@mvilanova

Repository

About Intervals.icu MCP Server

Model Context Protocol (MCP) server for connecting Claude and ChatGPT with the Intervals.icu API.

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "intervals-mcp-server": {
      "command": "uv",
      "args": [
        "venv",
        "--python",
        "3.12"
      ]
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is Intervals.icu MCP Server?

The Intervals.icu MCP Server is a Model Context Protocol (MCP) server that connects Claude and ChatGPT with the Intervals.icu API. It provides tools for authentication and data retrieval for activities, events, wellness data, power curves, and custom items.

How to use Intervals.icu MCP Server?

Install Python 3.12+, clone the repository, create a virtual environment with uv venv --python 3.12, sync dependencies with uv sync, then set API_KEY and ATHLETE_ID in a .env file. Configure Claude Desktop by adding the server to claude_desktop_config.json using the uv command, or start the server in SSE mode for ChatGPT using environment variables MCP_TRANSPORT=sse and FASTMCP_HOST/FASTMCP_PORT.

Key features of Intervals.icu MCP Server

  • Retrieve and manage activities, events, and wellness data
  • Access interval details, streams, and power curves
  • Create, update, delete custom items (charts, fields, zones)
  • Supports both stdio (Claude) and SSE (ChatGPT) transports

Use cases of Intervals.icu MCP Server

  • Ask Claude about your past training sessions and performance
  • Manage upcoming workouts, races, or notes via ChatGPT
  • Automate wellness data logging and analysis
  • Integrate custom items and power curve data into AI workflows

FAQ from Intervals.icu MCP Server

What are the runtime requirements?

Python 3.12 or higher, the MCP Python SDK, httpx, and python-dotenv. Use uv for package management.

How do I get my Intervals.icu API key and athlete ID?

Log in to Intervals.icu, go to Settings > API to generate a key. Your athlete ID is visible in the URL (e.g., https://intervals.icu/athlete/i12345/...).

Which transports are supported?

Stdio for Claude Desktop and SSE for ChatGPT’s beta MCP connectors. For SSE, set MCP_TRANSPORT=sse and expose the server (e.g., via ngrok).

Why does Claude Desktop give a spawn uv ENOENT error?

Claude cannot find the uv executable. Use the full path to uv (get it with which uv or where.exe uv) in the command field of claude_desktop_config.json.

Where does Claude Desktop store its config on Windows?

If installed from the Microsoft Store, the config is at AppData\Local\Packages\Claude_pzs8sxrjxfjjc\LocalCache\Roaming\Claude\claude_desktop_config.json. Otherwise, it is in AppData\Roaming\Claude\.

Frequently asked questions

What are the runtime requirements?

Python 3.12 or higher, the MCP Python SDK, httpx, and python-dotenv. Use `uv` for package management.

How do I get my Intervals.icu API key and athlete ID?

Log in to Intervals.icu, go to Settings > API to generate a key. Your athlete ID is visible in the URL (e.g., `https://intervals.icu/athlete/i12345/...`).

Which transports are supported?

Stdio for Claude Desktop and SSE for ChatGPT’s beta MCP connectors. For SSE, set `MCP_TRANSPORT=sse` and expose the server (e.g., via ngrok).

Why does Claude Desktop give a `spawn uv ENOENT` error?

Claude cannot find the `uv` executable. Use the full path to `uv` (get it with `which uv` or `where.exe uv`) in the `command` field of `claude_desktop_config.json`.

Where does Claude Desktop store its config on Windows?

If installed from the Microsoft Store, the config is at `AppData\Local\Packages\Claude_pzs8sxrjxfjjc\LocalCache\Roaming\Claude\claude_desktop_config.json`. Otherwise, it is in `AppData\Roaming\Claude\`.

Comments

Basic information

Category

AI & Agents

License

GPL-3.0

Transports

stdio

Author

mvilanova

More AI & Agents MCP servers

Solon Ai

opensolon

Java AI application development framework (supports LLM-tool,skill; RAG; MCP; Agent-ReAct,Team-Agent). Compatible with java8 ~ java25. It can also be embedded in SpringBoot, jFinal, Vert.x, Quarkus, and other frameworks.

416

Shell and Coding agent for Claude and other mcp clients

rusiaaman

Shell and coding agent on mcp clients

666

Transform MCP

Unstructured

The Unstructured Transform MCP Server connects your ADK agent to Unstructured, a document processing platform that turns raw files into structured, AI-ready data. This integration gives your agent the ability to parse PD

Unreal Engine Generative AI Support Plugin

prajwalshettydev

Unreal Engine plugin for LLM/GenAI models & MCP UE5 server. OpenAI GPT-5, Deepseek R1, Claude Opus/Sonnet, Gemini 3, Grok 4, Alibaba Qwen, Kimi, ElevenLabs TTS, Inworld, OpenRouter, Groq, GLM, Ollama, Local, Meshy, Tripo, Hunyuan3D, Rodin, fal, Dashscope, Seedream. NPC AI, agenti

622

Model Context Protocol Server for Home Assistant

tevonsb

A MCP server for Home Assistant

574