cyclst-mcp-server

MCP server for cyclst — exposes your training data and sync tools to Claude.

Tools

| Tool | Description | | ------------------ | ------------------------------------ | | list_activities | List your activities with pagination | | sync_activities | Trigger a sync from Intervals.icu | | list_connections | Show connected activity providers |

Requirements

• A running cyclst instance (self-hosted or cycl.st)
• An API key created in the cyclst admin panel

Setup

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "cyclst": {
      "command": "npx",
      "args": ["-y", "cyclst-mcp-server"],
      "env": {
        "CYCLST_API_URL": "https://cycl.st",
        "CYCLST_API_KEY": "cyclst_your_api_key_here"
      }
    }
  }
}

Claude Code

claude mcp add cyclst -e CYCLST_API_URL=https://cycl.st -e CYCLST_API_KEY=cyclst_... -- npx -y cyclst-mcp-server

Environment variables

| Variable | Required | Description | | ---------------- | -------- | ------------------------------------------ | | CYCLST_API_URL | Yes | Base URL of your cyclst instance | | CYCLST_API_KEY | Yes | Bearer API key from the cyclst admin panel |

Releasing a new version

This package uses Changesets for versioning. All commands are run from the repo root.

1. Record what changed

After making changes to the MCP server, create a changeset describing them:

pnpm changeset

This opens an interactive prompt:

• Select cyclst-mcp-server with the spacebar
• Choose the bump type: patch (bug fix), minor (new tool or feature), major (breaking change)
• Write a short description of the change

A new file is created in .changeset/. Commit it alongside your code.

2. Bump the version

When ready to release, apply all pending changesets:

pnpm version-packages

This updates packages/mcp-server/package.json with the new version and generates/updates CHANGELOG.md. Commit the result:

git add packages/mcp-server/package.json packages/mcp-server/CHANGELOG.md
git commit -m "chore: release cyclst-mcp-server vX.Y.Z"
git push

3. Publish to npm

pnpm release

This builds the package and publishes it to npm. Requires being logged in (npm login) and having publish rights to cyclst-mcp-server.