EnglishENPolskiPL
Start free
Documentation

Connect Claude to SquadBear

Add SquadBear as a custom MCP connector so Claude can act on your behalf

This is how you let Claude (or another MCP-capable agent) read and act on your SquadBear workspace in plain language, using your own permissions.

How

  1. Your MCP endpoint is https://app.squadbear.com/mcp — also shown on the in-app Agents page, which knows the URL for your own deployment.
  2. In claude.ai or the Claude desktop app, go to Settings → Connectors → Add custom connector (custom connectors need a paid Claude plan). Name it "SquadBear" and paste the endpoint.
  3. Claude opens the SquadBear sign-in. Log in, then choose which scopes this connection may use — things like leave:read, time:write or health:write. They're frozen into the connection once you approve them; to pick up a scope added later, disconnect and reconnect.
  4. In any chat, enable SquadBear under the search & tools menu.

Rather not do it by hand? Point any AI agent at squadbear.com/agent-setup/prompt.md — one fetchable guide with the endpoint and per-client connect steps, so the agent can set itself up.

The agent acts as you — with your role's permissions, nothing more. A manager's connected agent can approve requests for their reports; an employee's can't approve anyone's. Every action it takes lands in the same audit trail as the web app and the REST API, so nothing it does is invisible to an admin looking at Admin → Audit.

Ask it whoami first. It should answer with your role, manager, teams and holiday calendar — proof the connection actually resolved to you before you hand it anything real.

Things to try

  • "How many vacation days do I have left?"
  • "Request next Friday off."
  • "Log 2 hours on Platform today."
  • "Who's out on my team next week?"
  • "Start a Pulse 5 health check for the Platform team, anonymous, and open it."

Scripts and automations

Not everything is a chat. For code that calls SquadBear directly, create an organization API key at Admin → API keys (prefix sbk_, scoped, shown once) and use the REST API — the interactive reference lives at app.squadbear.com/api/v1/docs. API keys use their own, separate scope list from MCP connections.

Worked example

Marta at Northlake connects Claude using the steps above, picking read-only leave and team scopes to start. Her first message is "How many vacation days do I have left?" — Claude calls whoami to confirm it's her, then her real balance, and answers with the actual number from her SquadBear account, not a guess.