MCP setup

Connect your assistantin about a minute.

One endpoint, one token, and the same set of tools in every client. Below is the exact configuration for the four we see most often.

Before you start

  1. 1

    Create an API token

    In the dashboard, open Settings → API Integrations and create a token. It is scoped to one workspace — issue a separate token per workspace you want an agent to reach.
  2. 2

    Copy the endpoint

    Every client points at the same URL: https://supapush.com/mcp
  3. 3

    Paste the config

    Drop the snippet for your client below into its MCP configuration, restart it, and the SupaPush tools appear.

Claude

Claude Code adds a remote server in one command. Claude Desktop reaches it through the mcp-remote bridge, which sends the header for it.

Claude Code
claude mcp add --transport http supapush https://supapush.com/mcp \
  --header "Authorization: Bearer YOUR_TOKEN"
claude_desktop_config.json
{
  "mcpServers": {
    "supapush": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://supapush.com/mcp", "--header", "Authorization:${SUPAPUSH_AUTH}"],
      "env": { "SUPAPUSH_AUTH": "Bearer YOUR_TOKEN" }
    }
  }
}

Restart Claude, then ask it to list your connected accounts to confirm the connection. Custom connectors on claude.ai sign in with OAuth and have no field for a token, so they cannot connect to SupaPush yet.

Cursor

Add the server in Cursor's MCP settings, or commit it to the project.

.cursor/mcp.json
{
  "mcpServers": {
    "supapush": {
      "url": "https://supapush.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_TOKEN"
      }
    }
  }
}

Keep the token out of a committed file — read it from the environment if the config is in version control.

ChatGPT & Codex

The Codex CLI takes a TOML entry and reads the token from an environment variable.

~/.codex/config.toml
[mcp_servers.supapush]
url = "https://supapush.com/mcp"
bearer_token_env_var = "SUPAPUSH_API_KEY"

ChatGPT's connectors sign in with OAuth rather than a pasted token, which SupaPush does not offer yet — so ChatGPT on the web cannot connect today. The Codex CLI, and any client that lets you set a header, can.

OpenClaw

OpenClaw registers SupaPush as one tool inside a longer running automation — see OpenClaw + SupaPush for the pattern and an example flow.

If something does not connect

No tools appear

The client caches its server list. Fully quit and reopen it rather than reloading the window.

401 on every call

The token is wrong, revoked, or pasted with the word Bearer doubled. Reissue it from Settings.

Empty account list

The token belongs to a workspace with nothing connected yet. Connect an account in the dashboard first.

Start posting from one calendar

Plans start at $29 a month. Connect real accounts, publish real posts, and stop whenever you like.

Get Started For Free