Boostcamp MCP Server
Access and analyze your Boostcamp fitness account through Claude, including profile, programs, workouts, payments, analytics, and content.
Get profile and settings.
List enrolled programs, search all programs, and fetch program details by ID.
Retrieve training history with date filters, pagination, summary/full detail, and timezone support.
View payment/subscription history.
List custom exercises.
Read recent blog posts.
Get home dashboard data: summary stats, active/recent programs, volume chart, and muscle distribution.
Supports authentication via login or refresh token with automatic ID-token renewal.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Boostcamp MCP Server show me my training history"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Boostcamp MCP Server
A Model Context Protocol (MCP) server for integrating with the Boostcamp fitness platform. This server provides seamless access to your training history, workout programs, custom exercises, and analytics through Claude Desktop and Claude Code.
Built with the boostcamp-api Python library - A library for interacting with Boostcamp's private API.
🚀 Quick Start
1. Installation
Clone this repository:
git clone https://github.com/Alex-Keyes/boostcamp-mcp.git cd boostcamp-mcpInstall dependencies: Using
uv:uv syncConfigure Claude Desktop: Add this to your Claude Desktop configuration file:
macOS:
~/Library/Application Support/Claude/claude_desktop_config.jsonWindows:%APPDATA%\Claude\claude_desktop_config.json{ "mcpServers": { "Boostcamp": { "command": "uv", "args": [ "run", "--directory", "/path/to/your/boostcamp-mcp", "--with", "fastmcp", "--with-editable", "/path/to/your/boostcamp-mcp", "fastmcp", "run", "/path/to/your/boostcamp-mcp/src/boostcamp_mcp/server.py" ] } } }Important: Replace
/path/to/your/boostcamp-mcpwith your actual path!Restart Claude Desktop
2. One-Time Authentication Setup
Important: For security, authentication is performed via a standalone script to generate a session.
Open Terminal and run:
cd /path/to/your/boostcamp-mcp
uv run loginThis command supports Boostcamp accounts with an email and password. Follow the prompts:
Enter your Boostcamp email and password.
The script will securely authenticate and save your session locally.
The ID token and Firebase refresh token are stored in the local
.envfile (automatically ignored by git). Email and password are not saved.The existing token provider renews ID tokens automatically before expiry and retries once after an authentication rejection. Restart your MCP client after login.
If you previously logged in with an ID token only, run
uv sync --upgrade-package boostcampapianduv run loginonce to enable automatic renewal.
Google, passkey, and other OAuth accounts
If your account has no password, copy Firebase's refreshToken from your authenticated
Boostcamp browser session and add it to .env:
BOOSTCAMP_REFRESH_TOKEN=your-refresh-tokenRestart the MCP server after initially changing .env. The server exchanges the refresh
token for Firebase ID tokens and refreshes them automatically before they expire.
Security: A refresh token is a long-lived credential equivalent to a password. Never commit it, share it in an issue, or include it in logs or screenshots.
3. Start Using
Once authenticated, use these tools directly in Claude:
get_my_profile- View your profile and general stats.list_enrolled_programs- See your current active programs.get_training_history- Review your past workouts (filter by date range, page through history, or request full set-by-set detail).get_home_summary- Get your dashboard streak and totals.
Related MCP server: claudex-strava-mcp
✨ Features
📊 Fitness Analytics
Home Summary: Get total workouts, total weight moved, and current week streak.
Volume Charts: Access training volume data over time.
Muscle Distribution: See which muscle groups you've been targeting.
🏋️ Workout Management
Program Details: Fetch full workout plans, including sets, reps, and coach notes.
Enrolled Programs: Track your progress in active training plans.
Custom Exercises: Access exercises you've manually created.
📚 Content & Discovery
Program Catalog: Search and list all available programs on the platform.
Blog Access: Read the latest articles and training guides from the Boostcamp blog.
🛠️ Available Tools
Tool | Description | Parameters |
| Get user profile and settings | None |
| List your active programs | None |
| Workout history, compact by default. Returns JSON with pagination metadata and a |
|
| View your subscription/orders | None |
| List your unique exercises | None |
| Search the program catalog |
|
| Get full plan for a program ID |
|
| List recent blog posts |
|
| Dashboard stats (streak/totals) |
|
| Training volume chart data |
|
| Muscle group distribution |
|
Working with training history
get_training_history is built to keep responses small enough for any MCP
client. By default it returns a summary of your 50 most recent workouts
(date, program, exercises, and total volume) plus pagination metadata:
{
"workouts": [ { "date": "2026-06-10", "program_name": "...",
"exercises": ["Squat (Barbell)", "..."],
"total_volume": 11570, "volume_unit": "lbs" } ],
"pagination": {"page": 1, "page_size": 50, "total": 231,
"returned": 50, "has_more": true},
"filters": {"start_date": null, "end_date": null, "detail": "summary"},
"hint": "231 workouts match. Showing 50 (page 1, summary). Use page=2 ..."
}Filter by date:
start_date/end_dateasYYYY-MM-DD(inclusive), e.g. "my workouts since 2026-04-07".Page through history: bump
pagewhilepagination.has_moreistrue(page_sizecaps at 100 for summary, 25 for full).Get every set and rep:
detail="full"adds per-exercise records with each set's weight, reps, target, and RPE. Use a smallpage_sizehere.
Supersets are flattened: each exercise inside a superset is listed individually
(with its sets counted toward total_volume), and in full detail those
exercises carry a superset id so the grouping is still visible.
đź”§ Troubleshooting
Authentication Issues
If you see "Authentication Error" or token expiration messages:
For Google, passkey, or OAuth authentication, check or replace
BOOSTCAMP_REFRESH_TOKEN.For email/password authentication, run
uv run loginagain if the refresh token is missing or invalid. Routine ID-token expiry does not require another login.Restart your MCP client (Claude Desktop or Claude Code).
Credential Management
BOOSTCAMP_AUTH_TOKENremains supported, but Firebase ID tokens expire after about one hour.uv run loginsavesBOOSTCAMP_REFRESH_TOKENfor unattended automatic ID-token refresh.Login disables library session-file saving; no plaintext email/password or session pickle is written. Token rotations remain in memory in the MCP provider.
Credentials are read from your local
.envand are never written to logs.Security Note: Never commit your
.env. It is included in.gitignoreby default.
đź“„ License
MIT License
Available Tools
12 toolsget_home_chartC
Get training volume chart data.
Inputs: timezone_offset. Returns: result
get_home_muscleC
Get muscle group distribution data.
Inputs: timezone_offset. Returns: result
get_home_programsC
Get a summary of active/recent user programs.
Inputs: timezone_offset. Returns: result
get_home_summaryC
Get dashboard summary statistics (total workouts, weight, streak).
Inputs: timezone_offset. Returns: result
get_my_profileA
Get the current user's profile and settings from Boostcamp.
Inputs: no named parameters. Returns: result
get_payment_historyB
Get the user's payment history.
Inputs: no named parameters. Returns: result
get_program_detailsB
Get detailed information about a specific program by its ID.
Inputs: program_id (required). Returns: result
get_training_historyC
Get the user's training history. Default timezone offset is -300.
Inputs: timezone_offset. Returns: result
list_all_programsB
List all available programs with pagination and optional keyword search.
Inputs: page, page_size, keyword. Returns: result
list_blogsC
List blog posts with pagination.
Inputs: page, page_size. Returns: result
list_custom_exercisesA
List the custom exercises created by the user.
Inputs: no named parameters. Returns: result
list_enrolled_programsA
List all fitness programs the user is currently enrolled in.
Inputs: no named parameters. Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 12 tools
Most tools have clear distinct purposes, but there is slight overlap between 'get_home_programs' (summary of active/recent programs) and 'list_enrolled_programs' (all enrolled programs), and between 'get_home_summary' and 'get_training_history' which both provide training data.
All tool names follow a consistent verb_noun pattern with snake_case: get_* for fetching single items, list_* for collections. No mixing of styles.
12 tools is an appropriate number for a fitness dashboard MCP server, covering home stats, programs, exercises, blogs, profile, and payment without being overwhelming or too sparse.
The tool surface covers read operations well for dashboard, programs, training history, and user data. Minor gaps exist (no write tools like create/update programs or exercises), but the server appears focused on data retrieval, which is reasonable.
Maintenance
Related MCP Connectors
Connect Claude to your Intervals.icu watch data for fitness, workout review, and plan writing.
Connect ChatGPT or Claude to your Gym Plus account to log and review workouts with AI coaching.
Talk to your own gym log. Reps: Gym Workout Log (repsworkout.com) is a workout log for iPhone and Android. Connect it to Claude, ChatGPT or any MCP client to read your workout history, PRs, lift progression, weekly summaries, routines and training plan, and to save routines and plans after you confirm them. It never logs a workout for you and can’t delete your history. Sign in with an e-mail code, Apple or Google; new users can create a free account while connecting, then get the app to log workouts.
Workout journal Claude and ChatGPT write to: log workouts, get a program, see your progress.
Related MCP Servers
- AlicenseBqualityDmaintenanceIntegrates with the Boostcamp fitness platform to provide workout history, programs, exercises, and analytics via natural language.12MIT
- FlicenseAqualityDmaintenanceConnects Claude to your Strava fitness data, enabling natural language queries about your training history such as activities, stats, and routes.8-
- FlicenseNot gradedqualityCmaintenanceEnables Claude to read Hevy training data—workouts, routines, exercise templates, and history—and create or update routines through a self-hosted custom connector.-
- AlicenseBqualityBmaintenanceEnables Claude to access and query your Garmin Connect data—sleep, training, heart rate, and more—through a suite of read-only tools, with an optional write path for creating strength workouts.63MIT