Docs

AI Assistants

Connect Claude, ChatGPT or another AI assistant so it can answer questions about your training.

With Sparta Pro you can connect an AI assistant to your Sparta account. It reads your training and answers questions about it, in plain language:

  • “How has my dumbbell bench press moved since June?”
  • “What was my longest streak, and which month was my most active?”
  • “Summarize my last three workouts.”
  • “Which of my templates are scheduled this week?”

What it can and can’t do

The assistant can read your training: every activity with its sets and the records you broke, your workout templates and custom exercises, your body weights and your stats. That’s all it gets. It can’t log, change or delete anything, and it never sees your groups, the feed or the people in them.

Access comes with Sparta Pro. If your subscription ends, the assistant loses access until you subscribe again, and then it works again on its own without reconnecting.

To connect, you sign in on a Sparta page with the account you use in the app, Google or Apple, and approve. The assistant never sees your password.

Claude

Add to Claude

  1. Tap Add to Claude. Claude opens its Add custom connector window with Sparta filled in. Check the name and address, then add it.
  2. Tap Connect. Sparta’s sign-in page opens. Sign in with the account you use in the app and tap Allow.
  3. Start a chat and ask away. Claude uses Sparta when your question is about your training.

To add it by hand instead, go to Customize > Connectors > Add custom connector in Claude and use this address:

https://api.spartafitness.app/v1/mcp

If Claude asks how to identify itself, keep the recommended option.

Custom connectors work on every Claude plan; the Free plan allows one. On a Team or Enterprise plan, only an Owner can add connectors: ask them to add Sparta for the organization, then connect it with your own account.

ChatGPT

ChatGPT connects to Sparta through its Developer mode, on the web, with a Plus, Pro, Business, Enterprise or Edu plan. On Business and Enterprise, an admin may need to allow it first.

  1. In ChatGPT, go to Settings > Security and login and turn on Developer mode.
  2. Open Plugins and select the + button to create an app. Name it Sparta Fitness and use this address: 
    https://api.spartafitness.app/v1/mcp
    Choose OAuth for authentication.
  3. Sparta’s sign-in page opens. Sign in with the account you use in the app and tap Allow.
  4. In a chat, open the + menu, choose Developer mode and select Sparta Fitness. Naming it in your question helps: “Use Sparta Fitness to show my runs this month.”

Other apps

Any assistant or app that supports MCP servers with sign-in can connect. Give it the address below; it opens the same Sparta page for you to approve.

https://api.spartafitness.app/v1/mcp

Disconnecting

In the app, go to Profile > Connected apps and tap Disconnect next to the app. It loses access right away. Removing Sparta from the assistant’s own settings works too.

Your own scripts

If you write your own tools, create a personal token on the same screen. It reads the same data an assistant does, so keep it as private as a password. You can have one at a time; regenerating it stops the old one.

What the assistant does with what it reads is covered by its own privacy terms. Sparta only ever gives it read access to your own training.