How do I install the intervals mcp server?

This profile does not contain a verified copy-paste launch configuration. Follow the current project documentation to confirm the runtime, entry point, transport and authentication before registering it in your client.

What credentials does it need?

The recorded environment keys are `INTERVALS_API_BASE_URL`, `ATHLETE_ID`, `API_KEY`, `LOG_LEVEL`, `FASTMCP_HOST`. Keep credentials outside committed files and confirm the configuration required by your installed version.

SSyncDev

Start a project

Intervals MCP Server

Model Context Protocol (MCP) server for connecting Claude and ChatGPT with the Intervals.icu API. It provides tools for authentication and data

Local serverstdioPython

What is the Intervals MCP Server?

Model Context Protocol (MCP) server for connecting Claude and ChatGPT with the Intervals.icu API. It provides tools for authentication and data retrieval for

The tools it exposes

The server publishes 4 tools. What each one is for:

Name — Intervals.icu
Authentication — leave as No authentication unless you have protected your tunnel
Troubleshooting — If Claude Desktop fails due to configuration changes, follow these steps:
Windows — The mcp install command may fail on Windows due to environment or permission issues. Instead, configure Claude Desktop manually:

What it needs from you

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

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

How to install the Intervals MCP Server

{
  "mcpServers": {
    "Intervals.icu": {
      "command": "/Users/<USERNAME>/.local/bin/uv",
      "args": [
        "run",
        "--with",
        "mcp[cli]",
        "--with-editable",
        "/path/to/intervals-mcp-server",
        "mcp",
        "run",
        "/path/to/intervals-mcp-server/src/intervals_mcp_server/server.py"
      ],
      "env": {
        "INTERVALS_API_BASE_URL": "https://intervals.icu/api/v1",
        "ATHLETE_ID": "<YOUR_ATHLETE_ID>",
        "API_KEY": "YOUR_API_KEY",
        "LOG_LEVEL": "INFO"
      }
    }
  }
}

From the project documentation. Replace placeholders and example paths before connecting.

Configuration

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

Variable	Description	Required
INTERVALS_API_BASE_URL	Declared in the maintainer’s client configuration.	Check documentation
ATHLETE_ID	Declared in the maintainer’s client configuration.	Check documentation
API_KEY	Declared in the maintainer’s client configuration.	Check documentation
LOG_LEVEL	Declared in the maintainer’s client configuration.	Check documentation

Example prompts to try

“Use Intervals to Name.”
“Use Intervals to Authentication.”
“Use Intervals to Troubleshooting.”

Frequently asked questions

Model Context Protocol (MCP) server for connecting Claude and ChatGPT with the Intervals.icu API. It provides tools for authentication and data retrieval for Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.