Connect a client

Interactive clients

In Claude or another client that supports remote OAuth MCP servers:

1. Add a custom connector or MCP server.
2. Enter https://mcp.schedulerzero.com/mcp as the server URL.
3. Complete the Google sign-in flow.
4. Approve access to Scheduler Zero.

The session starts in your active Scheduler Zero workspace. Use the listWorkspaces and switchWorkspace tools when you need to work elsewhere.

Headless clients

Create an API key under Settings → API Keys, then export it without committing it to source control:

export SCHEDULER_ZERO_API_KEY="sz_your_api_key_here"

Configure a Streamable HTTP server with an authorization header:

{
  "mcpServers": {
    "scheduler-zero": {
      "type": "http",
      "url": "https://mcp.schedulerzero.com/mcp",
      "headers": {
        "Authorization": "Bearer ${SCHEDULER_ZERO_API_KEY}"
      }
    }
  }
}

Environment-variable interpolation differs by client. If your client does not expand ${SCHEDULER_ZERO_API_KEY}, use its environment-backed bearer-token setting instead of placing the secret directly in a committed file.

Codex

Codex supports an environment-backed bearer token directly:

[mcp_servers.scheduler-zero]
url = "https://mcp.schedulerzero.com/mcp"
bearer_token_env_var = "SCHEDULER_ZERO_API_KEY"

Verify the connection

Ask the client to run whoami. It returns the credential type, current workspace, and how that workspace was selected.