Claude Coworker + Cloxbi

Ask Claude to build next week's schedule, check who's off, or find coverage — using live Cloxbi data over MCP.

Claude custom MCP connector for Cloxbi with URL and OAuth authentication

Claude Desktop & Coworker

Connectors for OAuth. Config file for mcp-remote.

Claude Coworker and Claude Desktop Connectors accept remote URLs with OAuth. The claude_desktop_config.json file does not — it only supports local stdio servers, so pasting "url" there triggers the invalid-config warning on launch.

Claude Connectors (recommended)

  1. Open Claude → Settings → Connectors → Add custom connector.
  2. Name it Cloxbi. URL: https://app.cloxbi.com/mcp. Authentication: OAuth (not Bearer token).
  3. Save the connector. If you previously had a broken cloxbi entry in Edit Config, fully quit and reopen Claude (Cmd+Q on Mac — not just close the window).
  4. Start a new chat, enable the Cloxbi connector, and sign in with your Cloxbi staff account (manager, scheduler, or location admin) when prompted.

Claude Desktop Edit Config

Use this only if you configure MCP via Settings → Developer → Edit Config. On Mac the file is ~/Library/Application Support/Claude/claude_desktop_config.json. Requires Node.js 18+ (npx).

  1. Delete any cloxbi entry that uses "type": "http", "url", or similar — that format is invalid for this file and triggers Some MCP servers could not be loaded on launch.
  2. Open Settings → Developer → Edit Config and add the mcp-remote block from MCP support.
  3. Save the file, then fully quit Claude (Cmd+Q on Mac — do not just close the window).
  4. Reopen Claude Desktop. On first connect, mcp-remote opens your browser to sign in at app.cloxbi.com. Use your Cloxbi staff email or phone and password, then return to Claude.

Troubleshooting

  • Invalid config on launch: Remove "type": "http" / "url" entries from claude_desktop_config.json and use the mcp-remote JSON block instead.
  • Timed out or disconnected: Fully quit Claude (Cmd+Q), reopen, and reconnect — especially after Cloxbi server updates.
  • OAuth failed: Sign in with a manager, scheduler, or location admin Cloxbi account. Employee-only logins cannot authorize MCP.
  • Tools missing in chat: Start a new conversation and confirm the Cloxbi connector or MCP server is enabled for that chat.

Things to try

  • "Who's scheduled Tuesday morning at location 123?"
  • "List pending PTO requests this week."
  • "Show open shifts next weekend that still need coverage."