concept2-mcp

A Model Context Protocol server that lets Claude (and other MCP-aware AI assistants) read your Concept2 logbook — workouts, stroke data, history.

Status: pre-release. Working toward 0.1.0.

Not affiliated with Concept2. Concept2® is a trademark of Concept2 Inc. This is an unofficial community package.

Why

If you row, you have data. The Concept2 logbook holds it. This MCP server makes it queryable in natural language from Claude Code, Claude Desktop, and other MCP clients — so you can ask things like:

• "How many meters did I row last month?"
• "What was my pace on workout 12345?"
• "Compare my 2k splits over the last six weeks."

Without writing scripts.

Tools (v0.1.0)

| Tool | What it does | |---|---| | get_user_profile | Confirms your token works; returns username/country. | | get_recent_workouts | Lists your N most recent workouts. | | get_workouts_by_date_range | Lists workouts in a date range, optionally filtered by ergometer type. | | get_workout_details | Full details for a single workout (pace, watts, calories, heart rate). | | get_stroke_data | Per-stroke time-series data for a workout. |

Pete Plan support is planned for v0.2.0 (read-only schedule lookups).

Setup

1. Generate a personal API token in your Concept2 account: https://log.concept2.com/developers
2. Provide the token to the server. Either:
   • Set CONCEPT2_API_TOKEN in your environment, or
   • Save the token to ~/.config/concept2-mcp/token

Usage

Claude Desktop / Claude Code

Add to your MCP config:

{
  "mcpServers": {
    "concept2": {
      "command": "npx",
      "args": ["-y", "concept2-mcp"],
      "env": {
        "CONCEPT2_API_TOKEN": "your-token-here"
      }
    }
  }
}

Local development

npm install
npm run build
CONCEPT2_API_TOKEN=... node dist/main.js

Development

npm install
npm run dev        # tsup watch
npm run build      # tsup compile
npm run typecheck  # tsc --noEmit
npm test           # unit tests (mocked fetch, no network)

Verifying against your account

After building, you can run an end-to-end smoke test that exercises each tool against the live Concept2 API:

npm run build
CONCEPT2_API_TOKEN=... npm run smoke

The smoke test calls get_user_profile, get_recent_workouts, and get_workout_details and prints a brief summary of each response.

Continuous Integration

GitHub Actions runs typecheck + build on every push and pull request (workflow). The smoke test isn't run in CI because it requires a real Concept2 token.

License

MIT