intervals-mcp-server

intervals-mcp-server

23
communicationdeveloper_tools

The Intervals.icu MCP Server facilitates integration with the Intervals.icu API using Model Context Protocol (MCP) for data retrieval, including activities, events, and wellness metrics. It supports seamless configuration with Claude Desktop and offers tools for querying various data points.

Intervals.icu MCP Server

Model Context Protocol (MCP) server for integrating with the Intervals.icu API, enabling authentication and data retrieval for activities, events, and wellness data.

Requirements

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

Setup

  1. Install uv for virtual environment management.
  2. Clone the repository and navigate to the directory.
  3. Create and activate a virtual environment using Python 3.12.
  4. Sync project dependencies with uv sync.
  5. Set environment variables for your Intervals.icu API key and athlete ID.

Usage

  • Configure Claude Desktop to add the MCP server.
  • Use the MCP server with Claude to query data such as activities, events, and wellness metrics using various tools.

Development and testing

  • Install development dependencies and test the server using pytest.
  • Run the server locally for development and testing purposes.

License

  • Licensed under the GNU General Public License v3.0.