Guides
How to Connect Workalizer MCP
This guide walks you through connecting the Workalizer MCP server to Cursor, ChatGPT, and Claude.ai. Once connected, your AI assistant can call Workalizer analytics tools after you sign in with Google Workspace.
Before You Start
- A Workalizer account with access to your organization's workspace data
- A Google Workspace account (not a personal Gmail account)
- The MCP endpoint:
https://mcp.workalizer.com/sse
For quick setup buttons, visit the AI Integration page.
Connect in Cursor (One Click)
- On the AI page, click Add to Cursor (1-click).
- Confirm the install prompt in Cursor.
- Open Cursor Settings → MCP and verify Workalizer appears.
- Start a chat and trigger a Workalizer tool — sign in with Google Workspace when prompted.
Cursor uses a deep link that pre-configures the SSE endpoint. No manual JSON editing is required.
Connect in ChatGPT
- Requires ChatGPT Plus, Pro, or Team with Developer Mode enabled (Settings → Apps & Connectors → Advanced).
- On the AI page, click Add to ChatGPT — the MCP URL is copied automatically and ChatGPT settings open.
- In Settings → Connectors, click Create.
- Paste
https://mcp.workalizer.com/sseas the MCP URL. - Set authentication to OAuth, name the connector Workalizer, and create it.
- Complete Google Workspace sign-in in the browser.
- In a new chat, enable the Workalizer connector and ask: “Who am I in Workalizer?”
Connect in Claude.ai
- On the AI page, click Add to Claude.ai — the MCP URL is copied and Claude connectors settings open.
- Go to Customize → Connectors and add a new connector.
- Paste
https://mcp.workalizer.com/sseas the MCP URL. - Name it Workalizer, save, and complete Google Workspace sign-in.
- Start a conversation with the connector enabled and test with a simple analytics question.
Verify the Connection
Ask your assistant one of these test prompts:
- “Who am I in Workalizer?” — should call
get_current_user - “Show communication summary for the last month.” — should call
get_communication_summarywith{ "period": "month" }
Troubleshooting
- Not authenticated: Re-run OAuth sign-in. Ensure you use a Google Workspace account.
- Access denied: Your Workalizer user may be inactive or lack analytics permissions. Contact your admin.
- Connector not found after server restart (ChatGPT): Reconnect the connector — production tokens are in-memory.
- Wrong endpoint: Use exactly
https://mcp.workalizer.com/sse(SSE transport).
