Features
Member app Employee backend Customers Compare Free tools
Pricing Docs Updates
Language
nl en de es fr it pt
Dark mode
Sign in Free trial

Documentation

Connect AI agent

Connect Claude, ChatGPT, Grok, Gemini, Cursor, or another MCP-compatible AI assistant to manage your gym outside the Sessy app — step-by-step for non-technical staff.

Introduction

Connect an external AI assistant to your gym so you can ask it to check your schedule, plan sessions, message members, and more — using the same business rules as the Sessy app.

Important: When you connect an external AI tool, gym and member data is sent to that AI provider. Read 4. Data privacy and security before you start, and choose Limited — no member data on the token when the assistant does not need member workflows.

Once connected, see AI agent skills for example requests — scheduling, messaging, booking, programming, and more.

The built-in Sessy AI assistant (in the Sessy app) is separate. It does not use a token. This page is for connecting outside tools such as Claude or ChatGPT.

On this page

  1. Select a suitable AI tool
  2. Create an access token in Sessy
  3. Connect your AI tool
  4. Data privacy and security

1. Select a suitable AI tool

Sessy connects through MCP (Model Context Protocol) — a standard way for AI apps to plug in to other services. You do not need to understand MCP; you only need an app that offers an MCP, connector, or integration setting where you can paste a server address and token.

Suitable AI tools

Pick the type that fits your team, then choose a tool you already use:

Type Best for Examples
Chat assistants Most gym staff — ask questions and get things done in a simple browser or desktop chat Claude, ChatGPT, Grok, Gemini
AI-powered editors Owners or coaches who work in a desktop AI app on their computer Cursor, VS Code + MCP extension, Windsurf, Zed, Raycast
Automation agents Advanced setups — scheduled tasks, multi-step workflows, or computer use (the agent controls apps on your desktop) OpenClaw, Hermes Agent, Grok bot — technical setup; see each product’s MCP docs

If a tool is not listed above, it only works when its documentation mentions MCP or Model Context Protocol and lets you add a custom server URL (https://mcp.sessy.app).

What does not work

  • Plain chat without a connection — asking ChatGPT or Claude “log into my gym” without setting up Sessy first. They cannot see your Sessy data until connected.
  • WhatsApp, SMS, email, or social media bots — Sessy does not connect that way.
  • The in-app Sessy AI chat — use the app directly; no token needed.

2. Create an access token in Sessy

  1. Sign in as Admin
  2. Open Configuration → Sessy AI → External access (MCP)
  3. Name the token, choose the employee it is for, pick token access (Admin or Employee), and choose data access
  4. Copy the token immediately — it is only shown once
  5. Give the token to that employee for their AI tool
  6. Revoke the token from the same screen if it is lost or no longer needed

Each token is for your gym and one employee you select.

You will need this token in step 3. Server address for every tool: https://mcp.sessy.app

Data access presets

When you create a token, choose data access in addition to token access (Admin or Employee):

Preset Use when
Full access The assistant needs to search members, book sessions, send targeted push, view attendance or revenue, or edit member notes and tags
Limited — no member data Schedule, programming, shop catalog, gym-wide banner, newsletters, and gym setup — without sending member personal data to the external AI

Limited is a privacy control. External AI tools receive whatever data Sessy returns for each action. With limited turned on, Sessy blocks tools that expose member names, emails, booking lists, attendance history, staff notes, tags, targeted push audiences, or revenue — and strips member identifiers from schedule reads.

Employee access cannot change gym-wide configuration. Admin access is only available when the selected employee is an Admin in Sessy. Token access cannot exceed that person’s role.

What limited still allows

Area Examples
Calendar View the schedule (booking counts only, not who is booked), create/update/delete sessions, fill a week from recurring templates, assign a coach
Programming Search global benchmarks (Fran, Murph, …) and custom gym workouts, link workoutId on sessions so members can log results, create custom workouts
Gym banner setGeneralMessage — in-app banner for everyone (no member list in the response)
Newsletters Create, update, publish, or delete draft newsletters (opt-in subscribers; publishing still needs care)
Shop catalog Read products and categories
Gym summary Member count only via getBoxStats (no names)
Configuration Admin tokens only: locations, session types, subscriptions, shop items/categories, tag definitions

What limited does not allow

The assistant cannot use these capabilities while limited is on:

Not available Why
Search members by name or email Exposes member personal data
Book or unbook a member Requires member identity
Member attendance history or “who trained together” reports Personal attendance data
Revenue reports Financial / member-linked reporting
Targeted push (notifyMembers to today/tomorrow/members/employees/all) Uses member lists or broad personal outreach
Staff notes and member tags on individuals Personal member data

Use full access when staff need those workflows. Use limited for assistants that only manage the schedule, programming, banners, newsletters, or gym setup — especially when connecting to an external AI provider.

Four combinations (token access × data access)

Full data Limited — no member data
Employee token Calendar, programming, comms, member search/book/notes, reports Calendar, programming, banner, newsletters, shop read — no member search, booking, notes, targeted push, or revenue
Admin token Everything an Employee token can do, plus gym configuration Same as Employee limited, plus gym configuration (locations, session types, subscriptions, shop setup)

When the AI connects, Sessy provides a built-in access-profile guide (sessy://skills/access-profile) that lists the exact tools allowed for that token.

Built-in guides for the assistant

Sessy provides workflow guides that teach the assistant how your gym works. Compatible clients load these automatically when they connect.

Guide Who Purpose
Access profile Everyone Start here — exact tools for this token (role + data access)
Overview Everyone Golden rules and reading order
Data model Employee+ Members, sessions, subscriptions, shop
Tools reference Employee+ Everything the assistant can do
Limits and safety Employee+ Rate limits, validation, sensitive actions
Schedule week Employee+ Plan a week — recurring timetable or one-off classes
Manage sessions Employee+ Edit, delete, recurring templates, fill week from template
Book member Employee+ · full data only Book or unbook a member
Program WOD Employee+ Link workouts by workoutId — benchmarks via search, custom via upsert
Notify members Employee+ · full data only Targeted push notifications
Newsletters Employee+ Draft and publish
Member notes & tags Employee+ · full data only Staff notes and tags
Query and reports Employee+ · full data only Attendance, revenue, shop
Configuration Admin only Gym setup

Employee tokens see all guides except Configuration. Admin tokens see the full set. Limited tokens do not receive guides for member search, booking, targeted push, notes, or personal reports — the access profile lists what applies.

3. Connect your AI tool

Easiest: paste this prompt

After you created your token in step 2, copy the prompt below into Claude, ChatGPT, Grok, Gemini, Cursor, or another MCP-capable assistant. Replace YOUR_TOKEN_HERE with your Sessy token. The AI can walk you through adding the connection on your computer.

Only paste your token in a tool you trust.

 1
 2
 3
 4
 5
 6
 7
 8
 9
10

Connect me to Sessy (my gym admin platform).

- Server URL: https://mcp.sessy.app
- Transport: Streamable HTTP (JSON-RPC POST)
- Auth: Bearer token in the Authorization header
- My token: YOUR_TOKEN_HERE

Add this connection in my environment (Claude MCP settings, ChatGPT custom connector, Cursor mcp.json, Grok or Gemini MCP settings, OpenClaw/Hermes MCP config, or equivalent). Use the token only for this connection.

When you are done, confirm it works by listing the available Sessy tools.

Then ask something simple, for example:

  • “What Sessy tools do you have?”
  • “Show me this week’s sessions.” (if your token allows calendar access)

If it cannot see Sessy, double-check the token, that the connection is enabled, and that you started a new chat after saving settings.

Manual setup

Prefer to configure the connection yourself, or did the prompt not work? Use the steps for your tool below. Everywhere the idea is the same: add Sessy as a custom connection, paste server address https://mcp.sessy.app and your token, then save.

In the browser (claude.ai):

  1. Open claude.ai and sign in.
  2. Open Settings (your profile menu).
  3. Look for Connectors, Integrations, or MCP — wording varies by account type.
  4. Add a custom connector or MCP server.
  5. Paste server URL https://mcp.sessy.app and your Sessy token where it asks for authentication (Bearer token or API key).
  6. Save and start a new chat. Ask: “What can you do with my Sessy gym?”

Claude desktop app: same idea — Settings → Connectors / MCP → add custom server with the URL and token above.

ChatGPT

  1. Open chat.openai.com and sign in (paid plans often required for connectors).
  2. Open Settings → Connectors or Apps (name may vary).
  3. Add a custom connector or MCP connection.
  4. Server URL: https://mcp.sessy.app — authentication: your Sessy token.
  5. Save, open a new chat, and test.

Grok

  1. Open grok.com (or your xAI app) and sign in.
  2. Open Settings and look for MCP, connectors, or integrations.
  3. Add a custom MCP server with URL https://mcp.sessy.app and your Sessy token as Bearer authentication.
  4. Save and start a new chat to test.

Gemini

  1. Open gemini.google.com and sign in.
  2. Open Settings → Extensions, Apps, or MCP (wording varies by plan and region).
  3. Add a custom connection with server URL https://mcp.sessy.app and your Sessy token.
  4. Save and test in a new chat.

Cursor

  1. Install Cursor and sign in.
  2. Open Cursor Settings → MCP (or edit the MCP config file when prompted).
  3. Add a server named sessy with URL https://mcp.sessy.app and your token in the Authorization header.
  4. In the chat panel, confirm Sessy tools appear when you ask about your gym.

OpenClaw, Hermes Agent, or Grok bot

These are for advanced setups — automations, scheduled tasks, or controlling apps on your computer. Add Sessy as an MCP server in that product’s config:

  • URL: https://mcp.sessy.app
  • Auth: Bearer token = your Sessy token

See OpenClaw MCP docs, Hermes Agent MCP guide, or your Grok bot provider’s documentation. Expect a more technical setup than Claude or ChatGPT.

Other MCP apps

For Windsurf, Zed, VS Code, Raycast, or similar: open that app’s MCP or Integrations settings and add the URL and token above. Check that app’s help pages for “MCP” or “custom server” if the menu names differ.

4. Data privacy and security

Personal data leaves Sessy

When your AI assistant uses Sessy on your behalf, gym and member data is sent to the AI service you choose — for example Anthropic, OpenAI, xAI, Google, or Cursor. That data can include:

  • Member names and email addresses
  • Attendance and booking history
  • Staff notes and member tags
  • Message titles and bodies you send
  • Revenue summaries and other reports

Sessy does not control how that external provider stores, processes, or uses this data. You are responsible for:

  • Choosing an AI service you trust
  • Checking that its terms, data handling, and (where applicable) enterprise / DPA options meet your obligations under GDPR and other laws that apply to your gym
  • Only giving tokens to staff who need them, and revoking tokens when no longer needed
  • Using Limited — no member data when the assistant does not need member workflows (less personal data sent to the external AI)

The in-app Sessy AI assistant keeps processing inside Sessy’s own infrastructure. Connecting an external AI agent is a deliberate choice to share data with a third party.

If you are unsure whether a provider is appropriate for your members’ data, do not connect until you have checked with your legal or privacy advisor.

Tokens and usage limits

  • Treat tokens like passwords — anyone with the token can act as that employee in your gym
  • The same validation rules apply as in the app (session types, locations, scheduling window, and more)
  • In-app assistant limits (per gym): 60 chat requests per minute; 30 confirmed writes per minute, 500 per day (UTC), and 200 per calendar month
  • MCP write limits (per token): 30 mutations per minute and 500 per day (UTC). Scheduling a full week from recurring templates counts as one write; copying an old week session-by-session can hit the limit immediately
  • Tokens cannot delete the gym, assign Admin roles, or change platform billing
  • Mass messages to all members or publishing newsletters require extra care