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 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.

Choose your client

Most people should connect with OAuth. You enter the Server URL, log in to SuperSaaS in your browser, and approve access.

Clients with OAuth: ChatGPT and Claude
Other clients: Claude Code, Codex, Visual Studio Code, and other MCP clients

For clients with OAuth, use this Server URL: https://www.supersaas.com/mcp

ChatGPT

ChatGPT connects by entering the Server URL and approving the connection in SuperSaaS. ChatGPT requires a paid plan (Plus, Pro, or Business) for custom connectors.

Go to https://chatgpt.com to connect. Use the web version, there is no MCP option in mobile or desktop ChatGPT app yet, but after connecting you can use it from the app.
Open Settings > Apps, scroll to Advanced settings, and enable Developer mode
Back in Apps, choose Create app, name it “SuperSaaS”, and under connection enter “https://www.supersaas.com/mcp”
Under Authentication, ensure OAuth is selected, check the confirmation box and finish creating the connector. When you connect, a SuperSaaS page opens in your browser; log in and click Approve to return to ChatGPT with the tools available.

Claude (desktop and web app)

Claude connects to SuperSaaS as a custom connector. You only need the Server URL, you log in to SuperSaaS in your browser and approve the connection.

In Claude, open Settings > Connectors and click Add custom connector.
Enter a name such as “SuperSaaS” and paste your 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, which now lists the SuperSaaS tools under the tools icon in the chat box.

Manual setup for clients without OAuth

Some clients do not support the browser login flow yet. These clients need 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)

Run this single command, replacing the placeholder with your Authorization value:

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

Codex

The easiest way is through the Codex app:

Open Settings in Codex.
Go to MCP servers and click Add.
Choose a remote/HTTP server and enter your Server URL.
Add an HTTP header named Authorization with your Authorization value (including the word Bearer).
Save the server and start a new Codex chat. The SuperSaaS tools should be available in that chat.

If you prefer the terminal or want to configure Codex manually, 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"
      }
    }
  }
}