Beta onboarding
Getting started with Boulie + Claude
Talk to your coach in Claude, record your training as usual, and use Boulie as the clear, dependable home for your cycling, running, or multi-sport plan.
Before you start
Have Boulie and Claude ready. Strava is optional. Use the same email for Boulie throughout setup.
- Boulie appYour TestFlight or Android invite
- Claude accountThe free tier supports one custom MCP connector
- Paid Strava subscriptionOptional; required only to connect Strava's MCP
Install Boulie and fill in your Brief
Your Brief gives Claude the practical context it needs before it plans a single session.
-
Create your Boulie account
Install Boulie from your invite. Remember the email you use; Claude will need the same one in step 2.
-
Open Coach and complete your Brief
Select cycling, running, or both, then give your coach enough information to make the first week useful:
- Your numbers: cycling FTP, running threshold pace, and maximum heart rate, if you know them.
- Experience: how long you have been cycling or running, structured or otherwise.
- Your training: preferred sports, terrain, and equipment such as a trainer, power meter, or running watch.
- Your week: available days, time, recurring rides or runs, and weekly hours.
-
Skip the goal for now
You will set it in conversation with your coach. It is a better conversation than a form.
Connect Claude to Boulie
Add the connector from Claude in a web browser or the desktop app. You cannot add it from the Claude mobile app.
-
Open the connector settings
In Claude, go to Settings, then Connectors, then Add custom connector.
-
Add the Boulie connector
Paste this address exactly:
https://mcp.boulie.ai/mcp -
Sign in and approve access
Use the same email as your Boulie account, enter the one-time code, then approve the requested permissions.
Connect Strava to Claude Optional
With a paid Strava subscription, Claude can read your cycling and running history directly from Strava. Boulie remains the home of the plan.
-
Find Strava in Claude's connector directory
Stay in Settings and Connectors, find Strava, and choose Connect. Skip this step if you do not have a paid Strava subscription.
-
Approve Strava access
Sign in to Strava and follow its permission screen. Your usual Strava activity workflow does not change.
Meet your coach
Start a new Claude chat, switch on Boulie and, if connected, Strava in the tools menu. Choose the prompt that matches your training.
You're my cycling coach, and this is our first conversation. My training plan lives in Boulie. My ride history is in Strava if that connector is switched on. Start by reading my Boulie coaching context and, if available, my recent Strava riding so you know who you're coaching. Then interview me - briefly, a few questions at a time - about what I'm working toward and anything my Brief doesn't capture. Once we've agreed a goal, sketch out the longer-term plan to get there - how the weeks ahead build toward it - before we get into day-to-day detail. Then plan the current week in full. If I'd rather skip the long-term goal and just get a solid week of training, that's fine too. Save what we agree to Boulie and give me the week.
You're my running coach, and this is our first conversation. My training plan lives in Boulie. My run history is in Strava if that connector is switched on. Start by reading my Boulie coaching context and, if available, my recent Strava running so you know who you're coaching. Then interview me - briefly, a few questions at a time - about what I'm working toward and anything my Brief doesn't capture. Once we've agreed a goal, sketch out the longer-term plan to get there - how the weeks ahead build toward it - before we get into day-to-day detail. Then plan the current week in full, including useful pace, heart-rate, or effort targets. If I'd rather skip the long-term goal and just get a solid week of training, that's fine too. Save what we agree to Boulie and give me the week.
You're my endurance coach, and this is our first conversation. My cycling and running plan lives in Boulie. My activity history is in Strava if that connector is switched on. Start by reading my Boulie coaching context and, if available, my recent Strava activities so you know who you're coaching. Then interview me - briefly, a few questions at a time - about what I'm working toward, how I want to balance my sports, and anything my Brief doesn't capture. Once we've agreed my goals and priorities, sketch out the longer-term plan - how the weeks ahead balance and build each sport - before we get into day-to-day detail. Then plan the current week in full. If I'd rather skip the long-term goal and just get a balanced week of training, that's fine too. Save what we agree to Boulie and give me the week.
Your first week will be on the calendar. Tap any day to see the workout structure and targets Claude saved.
Optional: make it a Claude Project
For more consistent coaching conversations, add these instructions to a dedicated Claude Project.
Show project instructions
Use my Boulie connector as the canonical source for my goal and training plan. At the start of a planning conversation, call getCoachingContext. Use getPlan only when you need complete detail for another date, week, or bounded range. If planned days have passed, call getChangesSince and close the judgment gap with recordReconciliation before writing future plan. If my Boulie account has no goal or plan yet, read my recent training in Strava when available, agree a goal and plan shape with me in chat, commit them, and seed the coaching record with a provisional initial assessment. My Boulie anchors such as FTP, threshold pace, and max HR are authoritative. Quote real watts and paces from Boulie's resolved conversion ladder. If Strava shows different values, tell me to update Strava; never anchor prescriptions to it. Discuss a concise plan outline with me before changing anything. Call writePlan only after I explicitly confirm the change. When asking me to confirm, restate the full proposal in the confirmation message itself. Use the plan version from your read. If Boulie reports a version conflict, re-read the affected week and discuss any materially different result with me before retrying. Preserve dated availability and recurring commitments unless I explicitly ask to override that occurrence. After a successful write, tell me the committed version and what Boulie actually saved. Do not invent future plan detail. Future weeks and days are exactly what Boulie returns as stored.
The weekly rhythm
A couple of useful conversations each week is usually enough.
- TalkClaude
Share how training felt or what changed in your week.
- TrainBoulie
Use today's workout and the calendar as the plan of record.
- RecordStrava
If connected, record rides and runs as normal so your coach can review the evidence.
If something doesn't look right
Most setup problems come down to where the connector was added or which email was used.
Boulie tools do not appear in Claude
Add the connector from Claude on desktop or the web, then make sure Boulie is switched on in the current chat's tools menu.
Connector sign-in fails
Remove the connector and add it again using the same email as your Boulie account.
A saved change is not showing in Boulie
Pull down to refresh. If it still does not appear, close and reopen the app, then ask Claude what version Boulie saved.
Still stuck? Email [email protected]