Remote Connector (OAuth)
Add Astrocal as a hosted custom connector with OAuth — no install, no API key.
The remote connector is the easiest way to connect — and the only way for clients that can't run a local process, like Claude on web and mobile and ChatGPT. You paste one URL, sign in, and approve the permissions.
Connector URL
https://api.astrocal.dev/mcpHow it works
- In your AI tool, add a custom connector and paste the URL above.
- The tool registers itself automatically and sends you to an Astrocal consent screen.
- Sign in (if you aren't already), pick which organization to connect, and review the requested permissions.
- Approve — the tool is connected. No API key is ever copied or stored in a config file.
Authorization uses OAuth 2.1 with PKCE. Astrocal acts as the authorization server; your tokens are scoped to the permissions you approve and bound to this connector.
Permissions (scopes)
Connectors request a subset of these scopes; you see exactly which on the consent screen:
| Scope | Allows |
|---|---|
event_types:read | View your event types |
availability:read | Check your availability |
bookings:read | View your bookings |
bookings:write | Create, cancel, and reschedule bookings |
waitlist:read | View waitlist entries |
waitlist:write | Add people to waitlists |
Managing connections
See every connected app — with its scopes and last-used time — under the AI Tools page in your dashboard. Revoking a connector takes effect immediately: its next request fails and the tool must be reconnected.
Setting it up in a client
- Claude (web/desktop/mobile): Settings → Connectors → Add custom connector → paste the URL → sign in.
- ChatGPT: Settings → Connectors → add the URL and complete OAuth.
- Cursor: add a remote MCP server with the URL; Cursor handles the OAuth flow.
Prefer a local setup instead? See the per-client API-key guides.