Setup Guide
Step-by-step instructions for Claude.ai and ChatGPT. No API keys. No manual configuration. Just a URL and a sign-in.
Make sure you have the following before connecting your AI assistant.
💡 New to Calendrz? Create a free account at app.calendrz.com, connect your Google or Microsoft calendars, and come back here to set up your AI assistant.
This is the single URL you'll enter in any AI assistant to connect it to your Calendrz account.
https://app.calendrz.com/mcp
The AI assistant will automatically discover OAuth metadata from this endpoint. No other configuration is needed.
Claude.ai supports custom MCP connectors natively via its Connectors settings panel.
Go to claude.ai → click your profile icon → Settings → Connectors (also labelled Integrations in some versions)
Click Add Custom Connector. You will be prompted to enter a server URL.
Paste: https://app.calendrz.com/mcp
Claude will automatically discover the available tools and OAuth configuration.
Click Authorize. You'll be redirected to Calendrz to sign in with your Google or Microsoft account. This is the same login you use for app.calendrz.com.
Once authorized, Calendrz will appear as an active connector. Open a new conversation and try: "Show me my calendar events for next week."
ChatGPT supports MCP connections via its Connected Apps panel.
Go to chatgpt.com → click your profile → Settings → Connected Apps
Click Add Connection and select the option to enter a custom server URL.
Paste: https://app.calendrz.com/mcp
ChatGPT will discover tools and OAuth configuration automatically.
Sign in with the Google or Microsoft account linked to your Calendrz profile. Authorization is handled securely via OAuth 2.1.
Calendrz tools are now available. Try: "What calendars do I have connected in Calendrz?"
Any MCP-compatible client can connect to the Calendrz server. The server uses standard Streamable HTTP transport and OAuth 2.1 Dynamic Client Registration, so no manual credential setup is required.
https://app.calendrz.com/.well-known/oauth-authorization-server
curl -X POST https://app.calendrz.com/oauth2/register \
-H 'Content-Type: application/json' \
-d '{
"redirect_uris": ["https://your-app.com/callback"],
"client_name": "Your App"
}'
Calendrz uses OAuth 2.1 with the authorization code grant flow. Here's what happens behind the scenes when you connect your AI assistant.
The AI assistant fetches OAuth metadata from /.well-known/oauth-authorization-server to discover endpoints automatically.
The AI platform registers itself automatically via POST /oauth2/register (RFC 7591). No manual credential setup required.
You're redirected to /oauth2/authorize where you sign in with your existing Google or Microsoft account.
Calendrz issues a short-lived JWT access token (60 min) and a refresh token (30 days). Your Google/Microsoft credentials are never shared with the AI assistant.
All subsequent requests include Authorization: Bearer <token>. Tokens are refreshed automatically in the background.
Common issues and how to resolve them.
https://: https://app.calendrz.com/mcp. Some clients require the trailing path — do not shorten it to just app.calendrz.com.get_events tool reads from your connected calendar accounts. If you've recently added a new account, try asking your AI assistant to trigger a sync first: "Sync my calendars now."