Coach WattsDocumentation
Sign In

Connect AI Assistants (MCP)

Use Coach Watts with Cursor and other AI tools through the Model Context Protocol (MCP) server.

Coach Watts includes a remote MCP server that lets supported AI assistants access your training data securely. Instead of copying workout details into a chat window, your assistant can read your plan, log nutrition, and help manage your schedule directly.

This works much like the in-app AI coach, but from tools you already use—Cursor is the most common setup today.

What you can do

Once connected, your AI assistant can help with everyday athlete tasks:

  • Review workouts — "Show my last three rides" or "How did yesterday's interval session compare to last week?"
  • Plan ahead — "Schedule an easy 60-minute run for Thursday morning."
  • Track wellness — "Log 7 hours of sleep and a recovery score of 72."
  • Nutrition — "What should I eat before Saturday's long ride?"
  • Training analysis — "How is my training load trending this month?"

The assistant only sees data you authorize during the connection step, and you can revoke access at any time.

Connect with Cursor

  1. Open Cursor Settings → MCP (or edit your mcp.json directly).
  2. Add the Coach Watts server:
{
  "mcpServers": {
    "coach-watts": {
      "url": "https://coachwatts.com/mcp"
    }
  }
}
  1. Save the file and restart Cursor if prompted.
  2. When Cursor connects, your browser opens the Coach Watts sign-in and consent screen.
  3. Review the requested permissions and click Allow.

Success: After authorization, Cursor can call Coach Watts tools on your behalf. Try asking it about your upcoming workouts or recovery status.

No API keys or manual app registration are required—Cursor handles setup automatically.

Managing access

You control which apps can reach your data:

  1. Go to Settings → Apps in Coach Watts.
  2. Find the connected MCP client (for example, Cursor MCP).
  3. Click Revoke to disconnect it immediately.

Revoking access stops the assistant from making further requests. You can reconnect later by authorizing again in Cursor.

Tips for better results

  • Be specific — "Plan a 45-minute zone 2 ride for tomorrow at 7 AM" works better than "make me a workout."
  • Mention how you feel — "I'm sore from yesterday—should I swap today's intervals for endurance?" helps the assistant use your recovery context.
  • Use the in-app coach too — MCP and the Coach Watts chat share the same underlying data. Use whichever interface fits the moment.

Troubleshooting

Cursor shows "Unauthorized" or won't connect

  • Sign out and back in to Coach Watts, then try connecting again.
  • Make sure you approved the consent screen—closing it without allowing leaves Cursor disconnected.
  • Check Settings → Apps to confirm the MCP client is still authorized.

The assistant can't find a workout or plan

  • Verify the data exists in your Coach Watts dashboard first.
  • Some features (like nutrition logging) require the corresponding feature to be enabled on your account.

I want to disconnect completely

Revoke the app from Settings → Apps. Cursor will need to re-authorize before it can access your data again.

For developers

If you are building your own integration, see the technical MCP reference in the Developer documentation.

Back to Index