βοΈ Montis.icu Coach First-Time Setup
Follow these steps to connect your Intervals.icu account and generate your first training report in montis.icu Coach App. The entire setup takes less than one minute.
π Setup β Choose Your Interface
Choose how you want to use Montis
- π€ ChatGPT (Recommended) β guided chat experience
- π§ Claude + MCP β direct tool connection
- βοΈ Gemini App β direct tool connection
- ChatGPT connection issues FAQ β toubleshoot your ChatGPT experience
π€ ChatGPT Setup
Step 1 β Open the Montis.icu Coach
Open the Montis.icu Coach App inside ChatGPT (best in web browser not Mobile app first time), click on this link in a web browser Montis.icu Coach V5 and type or click "run a weekly report" and the following sign in prompt will appear, click sign in. This will redirect you to sign into Intervals.icu or if already signed in it will move to step 2.
Step 2 β Connect your Intervals.icu account
When prompted, click OK - to Connect Intervals.icu and approve access, do not uncheck any items. This allows the coach to read your training data securely and create new calendar events.
Step 3 β Return to ChatGPT
After authorization, you will be redirected back to ChatGPT, it will flash up a green message stating "connected" (this can take up to a minute!, if it fails it will show a red banner briefly).
Step 4 β Run your first report
Click always allow to stop this prompt on every request.It will now continue to show your report.
FAQ β ChatGPT / Montis GPT connection issues
If Montis works from the command line, Montis Gemini App, browser tools, or another ChatGPT session but fails inside one ChatGPT Montis GPT chat, the problem is usually ChatGPT chat/tool binding, session state, app state, connector auth state, browser storage, network filtering, VPN/security DNS, or a temporary OpenAI-side issue.
Montis says there is an upstream connection error. What should I try?
-
Start a completely new Montis GPT chat first.
Open the Montis GPT in a brand-new chat and type exactly:run weekly report
This rules out stale conversation state or a failed ChatGPT tool/action binding for that specific chat. A new chat can sometimes fix the issue without refreshing the browser tab. -
If that new chat still fails, start one more new Montis GPT chat.
ChatGPT can occasionally fail to attach the tool runtime correctly to a single new chat. If the second fresh chat works, the issue was almost certainly ChatGPT chat/tool runtime state, not Montis. -
Refresh the ChatGPT browser tab.
If repeated new chats fail, refresh the browser tab and open Montis GPT again. This resets more of ChatGPT's browser-side app/runtime state than simply starting a new chat. -
Use the browser instead of the ChatGPT app.
Go tochatgpt.comin Chrome, Edge, or Safari and run the same command. This separates a ChatGPT app issue from an account/tool issue. -
Try an incognito/private window.
Log in to ChatGPT, open the Montis GPT, and run:run weekly report
This rules out cookies, cache, extensions, and stored app state. -
Try a different network.
Use mobile data or a hotspot instead of home, work, school, corporate Wi-Fi, or filtered networks. This rules out ISP, VPN, DNS, proxy, firewall, or security filtering. -
Disable VPN, proxy, iCloud Private Relay, secure DNS, or filtering tools.
Temporarily turn off VPNs, proxies, iCloud Private Relay, NextDNS, AdGuard, Web Protect, antivirus web filtering, or similar tools. OpenAI lists these as common causes of ChatGPT network, websocket, and response-generation errors. -
Use the default model/mode in a new chat.
Do not continue from an old Thinking, Deep Research, or long-running conversation. Start fresh and use the normal/default ChatGPT mode. -
Run a small Montis action first.
Try:read calendar next 7 days
If the small action works but the weekly report fails, the issue may be related to a heavier ChatGPT action run, payload handling, or timeout behaviour. -
Disconnect and reconnect Montis in ChatGPT.
In ChatGPT/GPT connector authentication, disconnect Montis, reconnect it, then run a small action first, followed by:run weekly report
This rules out stale OAuth/action binding.
Does this mean Montis itself is down?
Not necessarily. You can check https://status.montis.icu. If the same athlete report works from Montis Gemini App https://geminiapp.montis.icu, from the command line, from browser tools, or from another ChatGPT chat/account/session, then the Montis backend is responding correctly.
In that case, the most likely causes are ChatGPT chat/tool runtime binding, stale conversation state, connector auth binding, app/browser storage, network filtering, or a temporary OpenAI-side execution issue.
What should I send to support if it still fails?
- The exact prompt used, for example:
run weekly report - Whether one new Montis GPT chat failed but another new chat worked
- Whether it fails in the ChatGPT app, browser, or both
- Whether refreshing the ChatGPT tab helps
- Whether incognito/private mode works
- Whether mobile data/hotspot works
- Whether VPN, Private Relay, secure DNS, or filtering tools are enabled
- The approximate date/time of the failed attempt
- The visible ChatGPT error message
Reference: OpenAI Help Center β Troubleshooting ChatGPT Error Messages
π§ Claude Setup (MCP)
If you use Claude, you can connect Montis directly using Model Context Protocol (MCP).
Step 1 β Add Montis MCP Server
{
"url": "https://montis.icu/mcp",
"client_id": "intervals-mcp"
}
Add this configuration in your Claude MCP / connector settings.
Step 2 β Authorize Intervals.icu
You will be prompted to connect your Intervals.icu account. Approve access to continue.
Step 3 β Use Montis Tools
Once connected, Claude can call Montis tools directly.
MCP connects Claude directly to the Montis engine β no chat wrapper.
Step 4 β Open new Claude chat
In the chat just ask for any of the tools, like a weekly report. (Different concept to a ChatGPT GPT app), tools are available in any chat.
run Weekly Report
run Wellness Report
get Activity for yesterday
βοΈ Gemini Setup
Step 1 β in a web browser (recommeded CHROME, EDGE or BRAVE) goto Gemini App, geminiapp.montis.icu and connect
Step 2 β Authorize Intervals.icu for Montis
You will be prompted to connect your Intervals.icu account. Approve access to continue.
Step 3 β Use Montis App!
Note: to use Gemini AI in the App you can use a Free Tier (API Key)
Its not required for the dashboard, but is required for AI aspects.
You can generate a free Gemini API key here:
π
https://aistudio.google.com/app/api-keys
No credit card required. Keys are created instantly and default to the Free Tier and you can track estimated usage in the Montis Gemini App. .
π Free Tier Limits (Gemini 3.1 Flash lite)
- Up to 10,000 requests per minute burst capacity (RPM)
- 350,000 requests per day sustained quota (RPD)
- 10 million tokens per minute throughput (TPM)
β±οΈ How Limits Reset
- Minute limits (RPM / TPM): Sliding window β capacity returns gradually within ~60 seconds.
- Daily limit (RPD): Resets every 24 hours (typically midnight Pacific Time).
π Important: Data Usage
- Free tier: Google may use your prompts and responses to improve models.
- Paid tier: Your data is not used for training.
π Full Pricing & Limits
See official comparison here:
π
https://ai.google.dev/pricing
β οΈ Common Setup Issues
Athlete profile missing or account not connected
This means the OAuth connection was not completed.
- Reopen the Coach link above and start with step 1. Try a different web browser or clear cache/cookies if you are having issues
- Click sign in to connect Intervals.icu
- Approve access "allow always"
- Run the report again
STRAVA activities are not available via the API
This means your activities exist only in Strava, and Intervals cannot access the required training metrics.
To fix this, connect a direct recording source:
- Garmin
- Wahoo
- Zwift
- TrainerRoad
- Upload FIT files directly
Explanation: Why Strava-only accounts donβt work β
π Data Requirements
The coach works best when your account has:
- Activities with time, distance, and training load
- A connected device or training platform
- Optional wellness data for recovery analysis
π§ͺ Run a Data Quality Check
If your report looks incorrect, empty, or missing activities, run a quick data quality audit.
After you have connected. In ChatGPT or Claude, type:
run data quality report
This report checks:
- If your athlete profile is connected correctly
- If activities are available
- If training load, heart rate, and power data exist
- If wellness data is present
- If any sources are missing or incomplete
The report will return a data quality score and highlight actions to fix any issues.
For a demo ask "run a weekly report demo test". This will return a sample demo report.