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)

  1. On the AI page, click Add to Cursor (1-click).
  2. Confirm the install prompt in Cursor.
  3. Open Cursor Settings → MCP and verify Workalizer appears.
  4. 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

  1. Requires ChatGPT Plus, Pro, or Team with Developer Mode enabled (Settings → Apps & Connectors → Advanced).
  2. On the AI page, click Add to ChatGPT — the MCP URL is copied automatically and ChatGPT settings open.
  3. In Settings → Connectors, click Create.
  4. Paste https://mcp.workalizer.com/sse as the MCP URL.
  5. Set authentication to OAuth, name the connector Workalizer, and create it.
  6. Complete Google Workspace sign-in in the browser.
  7. In a new chat, enable the Workalizer connector and ask: “Who am I in Workalizer?”

Connect in Claude.ai

  1. On the AI page, click Add to Claude.ai — the MCP URL is copied and Claude connectors settings open.
  2. Go to Customize → Connectors and add a new connector.
  3. Paste https://mcp.workalizer.com/sse as the MCP URL.
  4. Name it Workalizer, save, and complete Google Workspace sign-in.
  5. 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_summary with { "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).

See Also

GmailGoogle Chat

|

 Sign Up for Free TrialRequires Google Workspace Admin Permission
Live Demo
Communication performance dashboard