flowroll.Sign in

Connect to AI tools

FlowRoll, inside your AI tool.

Connect once and Claude, ChatGPT, Cursor, or any other MCP-compatible assistant can read your log, pull your stats, log sessions from a sentence, fix an entry, or update your belt. You sign in with your FlowRoll account and click Allow. No keys, nothing to copy except the address below.

https://www.flowroll.xyz/api/mcp

Claude — claude.ai and the Claude desktop app

  1. 1.Open Settings → Connectors (in the desktop app: Settings → Connectors as well).
  2. 2.Click Add custom connector, name it FlowRoll, paste the URL above, and click Add.
  3. 3.Click Connect. A FlowRoll page opens — sign in if you aren't already, then click Allow.
  4. 4.In any chat, make sure FlowRoll is enabled under the tools menu (the + or sliders icon), then ask away.

Custom connectors are available on Claude's paid plans. On the free plan, use Claude Code below.

Claude Code — in the terminal

  1. 1.Run the command below once.
  2. 2.Type /mcp, pick flowroll, and choose Authenticate. Your browser opens the FlowRoll sign-in; click Allow.
claude mcp add --transport http flowroll https://www.flowroll.xyz/api/mcp

ChatGPT — chatgpt.com and the desktop apps

  1. 1.Open Settings → Connectors, then Advanced settings and turn on Developer mode.
  2. 2.Back in Connectors, click Create. Name it FlowRoll, paste the URL, set authentication to OAuth, and save.
  3. 3.Click Connect and sign in to FlowRoll when the page opens, then Allow.
  4. 4.In a chat, open the + menu → More and switch on FlowRoll.

Custom connectors require a paid ChatGPT plan. Menu names move around; look for "Connectors" or "Apps" in Settings.

Cursor — the AI code editor

  1. 1.Open Cursor Settings → MCP and click Add new MCP server, or add the snippet below to ~/.cursor/mcp.json.
  2. 2.Click Login / Authenticate next to flowroll when it appears. Sign in to FlowRoll and click Allow.
{
  "mcpServers": {
    "flowroll": { "url": "https://www.flowroll.xyz/api/mcp" }
  }
}

VS Code — with GitHub Copilot

  1. 1.Open the Command Palette and run MCP: Add Server.
  2. 2.Choose HTTP, paste the URL, name it flowroll, and save to your user settings.
  3. 3.When VS Code asks to authenticate, allow it; sign in to FlowRoll and click Allow.

Gemini CLI — Google's terminal agent

  1. 1.Add FlowRoll to ~/.gemini/settings.json with the snippet below, or run the command.
  2. 2.Type /mcp auth flowroll. Sign in to FlowRoll and click Allow.
gemini mcp add --transport http flowroll https://www.flowroll.xyz/api/mcp

Windsurf — and other MCP-compatible tools

Any tool that supports remote MCP servers works the same way: add a server with the URL above (Windsurf calls the field serverUrl in ~/.codeium/windsurf/mcp_config.json), then approve the sign-in window that opens on first use.

Once it's connected

Things to try

  • “Log today: 75 minutes at Clockwork, 6 rounds, hit two triangles, got caught in a heel hook, felt like a 4.”
  • “What keeps catching me?”
  • “How many hours have I trained since my promotion?”
  • “Fix yesterday's session — it was an open mat, 5 rounds, with Dani and Marcus.”
  • “I got my second stripe today. Update my profile.”
  • “Compare this month to last month.”

What it can do

  • Read your sessions, stats, belt, and home gym
  • Log, edit, and delete sessions
  • Update your name, belt, stripes, home gym, and privacy

What it can't

  • See other athletes' data, your email, or your date of birth
  • Delete your account
  • Keep access after you disconnect it

Disconnect any tool in Settings → Connected apps. Building your own? See the API docs.