Connect an AI assistant to SuperSaaS

SuperSaaS provides an MCP (Model Context Protocol) server, which lets AI assistants such as Claude or ChatGPT manage your schedule in natural language: check availability, create and move bookings, look up users, and more. The assistant has the same access as your account, so treat the connection details like a password.

What you will be able to do

After setup, you can ask your AI assistant questions and requests such as:

“What appointments do I have tomorrow?”
“Find a free slot for a 30-minute consultation next week and book it for jane@example.com”
“Which bookings changed since yesterday?”
“Create a new user with the name jim@example.com and password ‘secret’ and give him $20 credit”

Most assistants will ask for confirmation before important changes, but remember that the connection acts with your administrator permissions.

Switching from another booking system? Existing appointments cannot be imported through the regular CSV import, which only handles users, but an AI assistant can do it for you. Export the appointments from your old system, give the file to your assistant and ask it to create the bookings in the matching SuperSaaS schedule. Try a small batch first and check the result before letting it import the rest.

Choose your client

Most people should connect with OAuth. You enter the server URL https://www.supersaas.com/mcp, log in to SuperSaaS in your browser, and approve access.

Web setup: ChatGPT and Claude
Desktop and terminal setup: Claude Code, ChatGPT desktop app and Codex, Visual Studio Code, and other MCP clients

ChatGPT (web)

ChatGPT connects by entering the server URL (https://www.supersaas.com/mcp) and approving the connection in SuperSaaS. You add the connection as a personal plugin. Developer mode availability depends on your account and workspace policy.

Go to https://chatgpt.com to connect.
Open Settings > Security and login and enable Developer mode.
Open Plugins and select Create app. In the New Plugin form, name it “SuperSaaS” and enter “https://www.supersaas.com/mcp” in MCP Server URL. The description is optional.
Leave Authentication set to OAuth, review the notice, select I understand and want to continue, and click Create. When you connect, a SuperSaaS page opens in your browser; log in and click Approve to return to ChatGPT.
Find SuperSaaS in your personal plugins, open it, and select the plus button to install it.
Return to the ChatGPT home page, switch from Chat to Work, and start a new chat. Type @ in the message box and select SuperSaaS to use its tools.

Claude (desktop and web app)

Claude connects to SuperSaaS as a custom connector. You enter the server URL “https://www.supersaas.com/mcp”, you log in to SuperSaaS in your browser and approve the connection.

In Claude, open Customize > Connectors (the toolbox icon at the bottom of the sidebar), click the + button and choose Add custom connector.
Enter a name such as “SuperSaaS” and paste the server URL (https://www.supersaas.com/mcp), then click Add.
Click Connect. A SuperSaaS page opens in your browser; log in with your account name and password (if you are not already logged in) and click Approve.
You are returned to Claude. Switch the connector on for a conversation by clicking the + button in the chat box (or by typing /), hovering over Connectors and toggling SuperSaaS on. The SuperSaaS tools are then available in that chat.

On a Team or Enterprise plan the connector is added by the workspace owner under Organization settings > Connectors; the other members only have to click Connect and log in to SuperSaaS. A free Claude account can hold one custom connector, the paid plans allow several. Once the connector has been added on the web or desktop app it also works in the Claude apps for iOS and Android.

Manual setup with an Authorization value

If your client does not support OAuth, or you prefer manual setup, use the Server URL and an Authorization value starting with Bearer …. You can find that value by clicking Connect an AI assistant which will open your Account Info page with an additional section. Click Reveal to see the Authorization code.

If you later click Roll key, the Authorization value changes and any connected assistant using it stops working until you update it with the new value.

Claude Code (terminal, desktop app and IDE)

Claude Code supports OAuth too, so no Authorization value is needed. Add the server with this command:

claude mcp add --transport http supersaas https://www.supersaas.com/mcp

Then type /mcp inside Claude Code, select SuperSaaS and follow the steps in your browser to log in and approve access. Claude Code stores the token and refreshes it automatically. The same command works in the terminal, in the Claude Code desktop app and in the Visual Studio Code and JetBrains extensions.

To use the Authorization value from the manual setup section above instead, pass it as a header:

claude mcp add --transport http supersaas https://www.supersaas.com/mcp \
  --header "Authorization: Bearer PASTE_YOUR_VALUE_HERE"

ChatGPT desktop app and Codex

The ChatGPT desktop app supports MCP setup directly, including OAuth login. Codex is the name used for the coding experience and terminal client. To connect through the desktop app:

Switch to Codex in the ChatGPT desktop app, then open Settings.
Go to Plugins, open the Add menu, and choose Add MCP server. In versions with a separate MCP servers settings section, open that section and click Add server instead.
Name the server SuperSaaS, choose Streamable HTTP, and enter https://www.supersaas.com/mcp.
Save the server and select Restart.
Open the MCPs tab under Settings > Plugins and select Authenticate for SuperSaaS. Log in to SuperSaaS in your browser and click Approve.
Start a new local Codex chat and use /mcp to check that the SuperSaaS server is connected.

The desktop app, Codex terminal client, and IDE extension share the MCP configuration on the same computer. As an alternative to OAuth, you can use the Authorization value from the manual setup section above. Edit ~/.codex/config.toml (create it if it doesn’t exist) and add:

[mcp_servers.supersaas]
url = "https://www.supersaas.com/mcp"
http_headers = { "Authorization" = "Bearer PASTE_YOUR_VALUE_HERE" }

Restart Codex afterwards; the SuperSaaS tools appear automatically. In the terminal you can check the connection with codex mcp list, and inside Codex you can use /mcp to inspect connected servers.

Visual Studio Code (GitHub Copilot)

In VS Code, MCP servers are used by GitHub Copilot’s chat in agent mode, so a Copilot subscription (the free tier works) is required.

Open the Command Palette (Ctrl/Cmd + Shift + P) and run MCP: Add Server.
Choose HTTP and enter your Server URL.
When the mcp.json file opens, add the headers entry so the server definition looks like this:

{
  "servers": {
    "supersaas": {
      "type": "http",
      "url": "https://www.supersaas.com/mcp",
      "headers": {
        "Authorization": "Bearer PASTE_YOUR_VALUE_HERE"
      }
    }
  }
}

Open the Copilot chat panel, switch the mode dropdown to Agent, and click the tools icon to confirm the SuperSaaS tools are listed.

Other MCP clients (Cursor, Le Chat, and more)

Any client that supports remote MCP servers with custom headers will work. Wherever the client asks for server details, use:

Type / transport: Streamable HTTP
URL: your Server URL, e.g. https://www.supersaas.com/mcp
Header: Authorization set to your Authorization value (including the word Bearer)

For clients configured with a JSON file (such as Cursor’s mcp.json), the equivalent is:

{
  "mcpServers": {
    "supersaas": {
      "url": "https://www.supersaas.com/mcp",
      "headers": {
        "Authorization": "Bearer PASTE_YOUR_VALUE_HERE"
      }
    }
  }
}