Connect Claude, ChatGPT or Codex to Session and ask it about your venue in plain English: "How did September compare to August?", "When are we quietest?", "Which sessions have space this weekend?". It reads the same figures as Reports, for your venue only.
Connect
Copy the address under AI apps in the Connect card in Settings → Data: https://bookasession.org/api/mcp. Then:
- Claude - in Settings → Connectors, choose Add custom connector, paste the address, name it Session and select Connect.
- ChatGPT - in Settings → Apps, add a custom app with the address and name it Session.
- Codex - in a terminal, run
codex mcp add session --url https://bookasession.org/api/mcp, thencodex mcp login session. Both need the same name;codex mcp listshows it. Codex and ChatGPT connect separately.
If codex mcp list still says Not logged in, put mcp_oauth_credentials_store = "file" on the first line of ~/.codex/config.toml, then log out, log in again and restart Codex.
Sign in with your Session login and allow access when asked. Then ask "What venue am I connected to?" to check it works. A new connection only reads. With Connect, allow changes to let it edit bookings.
Use bookasession.org, not www.bookasession.org. The www address redirects, and the connection fails.
What it can see
The assistant can read:
- Business summary - revenue, refunds, bookings, sessions run and occupancy, compared with the previous period
- Revenue breakdown - over time, by payment type, or extras sales
- Occupancy - by session, your busiest and quietest times, and when customers book
- Memberships and vouchers - members per tier, joins and cancellations in a period, allowance use, bundle and gift voucher take-up, and unspent voucher value
- Sessions - dates and times, spaces booked and left, for up to a month at a time, and who is booked on one
- Vouchers and gift cards - from its code: balance, expiry, who it's for and who has used it. It also lists your codes and how often each was used
- A customer's memberships - status, renewal date and free sessions left
- Customers - search by name or email, or list regulars, top spenders, lapsed customers and members, with visits and spend. One customer at a time includes their email, phone, marketing status and bookings with you: reference, tickets and how each was paid
Lists never include contact details, and it never sees booking notes, waiver answers or card details. It never shows a voucher code, except a new one it has just created. Amounts are in your venue's currency and times in your venue's timezone.
Making changes needs the Connect add-on (below).
Make changes with your AI app
With the Connect add-on, your AI app can also do the day-to-day jobs for you:
- Add a booking for someone who phoned, walked in or emailed, tagged with how it came in, and record money already taken on your card machine, in cash or by bank transfer. It never overbooks a session
- Cancel a booking, refunding it under your cancellation policy (a card refund or account credit), or with no refund for a no-show. It can't refund any other amount
- Move a booking to another session
- Close a date or reopen it. Closing stops a day's recurring sessions being booked; bookings already made stay
- Change one session's capacity, or put it back to usual. It can't go below what's already booked
- Cancel a session and every booking on it. Each booking is refunded under its own policy and everyone booked is emailed, with your reason
- Vouchers - add credit, extend an expiry, void one, or create a new code, shared or for one customer
- Memberships - pause, resume or cancel, at the end of the paid period or straight away
For a booking you can say whether to email the customer.
It always shows you what it's about to do first: who, which session, the refund and who gets emailed. Nothing changes until you say yes. Every change is listed under Changes made by AI apps and the API in Settings → Data, with who made it, and in the booking's history.
- 1
In Settings → Data, under AI apps in the Connect card, select Allow changes next to your connection.
- 2
Ask it, for example "Cancel BK-7Q2X4M and refund them, don't email them" or "Cancel tomorrow's 7am, the beach is closed for the storm".
- 3
Check the preview and say yes.
If it still says it can only read after you allow changes, remove the Session connector in your AI app and connect it again.
Your own systems (Make.com, Zapier) can make the booking changes through the bookings API, with a write key from Settings → Data → API keys.
Revoke access
Every admin who connects appears under AI apps. Select Revoke to stop that person's app working with your venue straight away, and Allow again to undo it.
Common questions
-
Can staff connect? Not yet. Connecting needs an admin login, because the reports it reads are admin-only.
-
Does it work with my main login if I run more than one venue? It connects to the venue your login belongs to. To ask about another venue, connect with that venue's admin login.
-
Is my venue's data used to train AI models? That depends on your AI app's own settings and terms, not Session. Check its privacy settings.
-
Can it tell me how many members joined or cancelled? Yes, for any period from 18 September 2026. Session didn't record them before that date.
-
The figures differ from my Reports page. The assistant uses whole days in your venue's timezone, so ask for the same range you picked on the Reports page.
-
Can it refund a customer without cancelling? No. Refunds only happen as part of a cancellation, under your cancellation policy. Partial refunds stay in your admin.
-
Who can let an AI app make changes? Any admin, for any connection at your venue, in Settings → Data. Make read only turns it off again.
-
It says access was revoked. An admin selected Revoke for your app. Ask them to select Allow again in Settings → Data.