MoveMentors exposes a Model Context Protocol (MCP) server. If you use Claude, ChatGPT (with Claude API integrations), Cursor, or any other MCP-compatible AI assistant, you can connect them to your account to ask things like:
- "What are my bookings for next week?"
- "Cancel my Saturday class and email everyone who booked it."
- "Add a Tuesday morning yoga class at the same price as my Thursday one."
- "Send a thank-you note to clients who attended in the last 30 days."
The MCP server is generally available for Pro and Premium accounts.
What MCP is
The Model Context Protocol is an open standard for letting AI assistants talk to external tools. Originally built by Anthropic (the Claude folks); now adopted by ChatGPT, Cursor, and others.
For MoveMentors, MCP means your AI assistant can:
- See your bookings, classes, clients (read access).
- Create new bookings, modify classes, send messages (write access).
- All gated by OAuth permissions you grant.
How it works
- You go to your AI assistant's settings (Claude Desktop, ChatGPT, etc) and add MoveMentors as an MCP server.
- The assistant opens an OAuth flow in your browser.
- You log into MoveMentors and grant specific permissions (read bookings, write classes, etc).
- The assistant gets a token that it includes on requests.
- You can now ask the assistant to do things on your account.
No API keys, no credentials in plaintext. OAuth handles the auth.
Connecting Claude Desktop
Open Claude Desktop
The desktop app for Claude.
Go to Settings → Developer
Look for the "MCP servers" section.
Add a new MCP server
Click "Add server" and pick "Connect via OAuth".
Enter the MoveMentors MCP URL
https://movementors.com/api/mcpAuthorise
Claude opens a browser window. You log into MoveMentors and see a consent screen listing the requested permissions.
Pick which permissions to grant
You can deny specific scopes if you want to limit what Claude can do. For example, you can grant "read bookings" but deny "write classes" if you want Claude to query but not modify.
Click 'Approve'
You return to Claude. The server is now connected.
Start using
Talk to Claude as normal. It now has tools to query and modify your MoveMentors account.
Connecting ChatGPT
ChatGPT supports MCP servers via the Anthropic API with Claude as the model. The exact UI is different from Claude Desktop but the OAuth flow is the same.
If your AI assistant supports MCP, it will have an analogous "Add MCP server" option somewhere. The URL is always https://movementors.com/api/mcp.
Available tools (what the AI can do)
The MCP server exposes about 20 tools. Some highlights:
whoami: who is the current user (returns your account info).search_mentors,search_studios,search_classes: query the public directory.get_mentor: get a specific mentor's full profile.list_my_bookings: your bookings (as student or host).book_class: create a booking.cancel_booking: cancel a booking.list_my_classes: your hosted classes.update_class,delete_class: modify hosted classes.add_class_schedule: add a session to an existing class.list_class_bookings: who is booked on a specific session.financials_summary: your earnings summary.list_expenses,create_expense,update_expense,delete_expense: expense tracking.send_mentor_inquiry: send a direct message.list_received_mentor_inquiries: see incoming messages.
The assistant will pick the right tool for your request. You do not have to know the tool names.
Permissions and scopes
Permissions are granular. You can grant or deny each scope individually during the OAuth flow. See OAuth scopes for the full list and what each one allows.
Common scope groupings:
- Read-only: see everything, change nothing. Useful for testing.
- Bookings management: view and modify bookings, but not classes.
- Full control: everything.
You can revoke permissions any time at /settings/connected-apps.
Use cases
"Show me my next week"
The assistant uses list_my_bookings and list_my_classes to pull a week's worth of events, organised by day. You ask follow-ups like "which ones are still pending payment?".
"Cancel Saturday and refund everyone"
The assistant uses list_class_bookings to get the affected bookings, then cancel_booking on each. Refunds for Stripe payments process automatically.
"Add a new class similar to my Tuesday one but on Thursday"
The assistant uses get_class to retrieve the Tuesday class details, then create_class with the same fields but a different schedule.
"What was my best month for revenue?"
The assistant uses financials_summary to pull month-by-month totals and reports back.
"Send a thank-you note to everyone who attended last weekend"
The assistant uses list_my_bookings filtered to last weekend with status COMPLETED, then send_mentor_inquiry or similar to send personalised notes to each.
Security
A few things to know:
OAuth scopes are the limit
The assistant cannot do anything outside the scopes you granted. If you only granted read access, write attempts return permission errors.
Each request is logged
We log every MCP request: which tool, what arguments, the result. Visible in /settings/audit-log. Useful if you want to know what the assistant did.
Tokens can be revoked
/settings/connected-apps shows every OAuth client connected. Revoke any time; the assistant immediately loses access.
Rate limits
We rate-limit per-token. A normal assistant making conversational requests stays well under. An assistant trying to fetch your entire booking history in one go might hit limits; it retries with backoff.
Sandboxing
Most MCP clients (Claude Desktop, etc) run as separate processes. They cannot read your other files or hijack your browser. The connection to us is over HTTPS with token auth.
Limits
Some tools are gated:
book_class: requires Pro tier. The free tier exposes read-only.update_class,delete_class,add_class_schedule: Pro tier.financials_summaryand expense tools: Pro tier.
If you are on free and trying to use an unlock-gated tool, you get a clear error from the assistant.
Common questions
Will the assistant share my data with anyone else? The assistant runs locally (Claude Desktop) or in your provider's environment (Claude.ai web). Data it reads from MoveMentors stays in your conversation; it is not shared with other users.
Anthropic's privacy policy applies to what they do with your conversation data. We do not control that.
Can the assistant see my password? No. OAuth means the assistant never sees your password. It has a token that can be revoked.
Can the assistant do things behind my back? The assistant only acts when you tell it to (in conversation). It does not run in the background unless you set up an automation. Each action is logged.
What if the assistant makes a mistake? You can review the audit log and undo most actions:
- Cancelled bookings can be re-booked (if seats are still available).
- Deleted classes can be re-created (the assistant has the data).
- Sent messages cannot be unsent.
Treat the assistant like a junior employee with access. Trust but verify.
Will MCP support get better over time? Yes. We add new tools as MCP itself evolves. Subscribe to our newsletter or check the changelog for updates.
Next steps
- OAuth scopes: the permissions model.
- Try it out: connect Claude Desktop and ask "show me my next week".