Koach runs a Model Context Protocol (MCP) server, so an AI assistant can act as your coach: it reads your day, your plans, and your progress, and it can build and edit nutrition and workout plans on your behalf. You ask "am I hitting protein this week?" or "swap Wednesday's chest day for something shorter" and it works with your real data.
Nothing is copied anywhere. The assistant talks to Koach directly with your own account, and every request is limited by the same permissions the app uses.
What it can and cannot do
This distinction is deliberate - the assistant manages and coaches; the app tracks.
It can:
- Read everything - today's log, your plans, progress, check-ins, workout history, settings.
- Create, edit, activate, archive, and delete nutrition plans - meals, items, quantities, alternatives.
- Create and edit workout plans - days, exercises, target sets and reps, supersets, templates.
- Add and edit your custom foods and custom exercises.
- Update your settings and targets.
It cannot:
- Log a meal, mark a meal or a set complete, start or finish a workout, or record a check-in.
That is not a missing feature. Logging is a deliberate act you do in the moment, in the app, where you can see what you're confirming. An assistant that logs on your behalf turns a record of what you actually did into a record of what it inferred - and the whole value of the data is that it's true.
1. Copy the server address
The Koach MCP server lives at:
https://koach-mcp.equival.io/mcp
That single address works for all three assistants. Keep the /mcp at the end - without it the connection fails.
2. Add it to your assistant
Claude
Available on every plan, including Free (Free allows one connector).
- Open Settings → Connectors.
- Choose Add custom connector.
- Paste the address and select Connect.
- A browser window opens with the Koach consent screen. Sign in if you aren't already, then approve.
In Claude Code, the same thing from a terminal:
claude mcp add --transport http koach https://koach-mcp.equival.io/mcp
Then run /mcp to sign in and check the connection.
ChatGPT
Requires developer mode, which is available on Plus, Pro, and Business plans, on the web.
- Settings → Apps & Connectors → Advanced → Developer mode, and turn it on.
- Add a connector by URL and paste the address.
- Approve on the Koach consent screen that opens.
Gemini
Custom MCP servers are supported through Gemini Spark: Settings & help → Connected Apps → Custom apps for Spark, then paste the address.
3. Approve the connection
Whichever assistant you use, the last step is the same: a Koach consent screen in your browser, listing which app is asking for access and where it will send you back to.
Read that screen rather than clicking through it. It shows the requesting app's address on purpose, because anyone can build a client that calls itself Claude. If the name and the address don't match what you're expecting, deny it.
4. Try it
Good first questions, once connected:
- "What did I eat yesterday, and how far off my protein target was I?"
- "Look at my last month of training and tell me which lifts have stalled."
- "Build me a 4-day upper/lower plan around the equipment I already use."
- "My current meal plan is too heavy at dinner - rebalance it across the day, same daily totals."
Ask it to explain a change before it makes one. Plan edits are real edits, and the assistant will make them when you ask.
Security and privacy
- Access is granted with OAuth, the same standard "sign in with" flow you already use elsewhere. The assistant never sees your password.
- The assistant acts strictly as you. It cannot reach another user's data, because the database enforces that per-row, not the assistant.
- Revoke any time - remove the connector in your assistant, and its access ends.
- Anything you ask about goes through your assistant provider's servers, exactly as any other chat message does. Their privacy policy governs the conversation; ours governs the data in Koach.
When it goes wrong
- "Not authorized" after signing in successfully. You approved against a different environment than the connector points at. Check the address is the one above, with no trailing characters.
- The connector shows no tools. The connection was added but not authorized - reopen it and complete the consent step.
- Gemini shows no "Custom apps" option. You're outside the US eligibility window described above.
- The assistant offers to log a meal and then can't. It's guessing from the tool names. Logging isn't exposed; do it in the app.
- It gets "today" wrong. Tell it the date. The server never assumes what day it is for you - it runs in UTC, and guessing your local day would quietly write to the wrong one.