Connecting Claude to Hero Schedule MCP

Modified on Thu, Nov 19 at 5:50 PM

This guide walks you through adding Hero Schedule to Claude so you can ask questions about your schedule. It takes about five minutes. For what the assistant can see and do, see Connecting your AI assistant to Hero Schedule.

Before you start

  • A Claude account that can add custom connectors. On a Team or Enterprise plan, an owner or admin adds the connector for the organization first, and then each member connects their own account. Some plans limit how many custom connectors you can add.
  • Your Hero Schedule login. Use your own employee login.
  • Your connection address. It is your Hero Schedule address followed by /mcp, for example https://app.heroschedule.com/your-organization/mcp. Replace your-organization with the name that appears after app.heroschedule.com/ when you are logged in to Hero Schedule.
  • A computer. Do the setup at claude.ai or in the Claude desktop app. Once connected, it also works in the Claude mobile app.

Add Hero Schedule to Claude

Claude changes the names and locations of these settings from time to time, so your screens may look a little different.

  1. In Claude, open the Connectors settings.
  2. Choose Add custom connector (it may be behind a + button).
  3. Fill in the form:
    • Name: Hero Schedule, or include your organization if you use more than one (for example "Hero Schedule Small Fire")
    • URL: your connection address
  4. Leave any advanced or OAuth settings as they are; Claude finds them automatically.
  5. Click Add, then click Connect next to Hero Schedule if Claude does not open Hero Schedule on its own.

Approve the connection in Hero Schedule

  1. If you are not already logged in to Hero Schedule, log in as usual.
  2. The Connect Hero Schedule screen shows your name, your organization, and what Claude is asking for. If the organization is wrong, click Use a different organization.
  3. View Schedule is required. Untick anything else you do not want Claude to do: View Time Off, View Overtime, Approve Time Off, Approve Overtime, or Fill Open Shifts. The approval boxes only matter if you approve requests in Hero Schedule.
  4. Click Connect. You return to Claude, and Hero Schedule shows as connected.

Try it

Start a new chat, make sure the Hero Schedule connector is turned on, and ask a question:

  • "When do I work next?"
  • "Who is working this Saturday?"
  • "Show my time off for next month."
  • "What is waiting for my approval?" (approvers)

If more than one employee matches a name you mention, Claude should ask which one you mean.

Approving and rejecting safely

Claude asks for your permission before it uses Hero Schedule. Before approving or rejecting anything, Claude should also confirm the employee and dates with you.

  • Do not choose Always allow for the approve and reject actions. That way Claude has to ask you each time.
  • Turn the Hero Schedule connector off before using Research. In Research, Claude can use connectors without asking first.

Troubleshooting

What you seeWhat to do
There is no Add custom connector optionYour Claude plan or workspace does not allow it, or you have reached your plan's connector limit. On a work account, ask your Claude workspace owner.
Claude cannot connect or sign inCheck the connection address. It must start with https://app.heroschedule.com/, contain your organization name exactly as it appears in Hero Schedule, and end in /mcp.
"Could not load this connection request" in Hero ScheduleThe request expired (it lasts 15 minutes) or you are logged in to a different organization. Click Use a different organization, or start again from Claude.
Claude asks you to connect againConnections last 30 days. Connect again from the Connectors settings; you do not need to add the connector again.
Claude cannot see someone's scheduleClaude sees only what your Hero permissions allow. Ask your Hero Schedule administrator if you need wider access.
Claude cannot approve or reject requestsCheck that you approve requests in Hero Schedule and that you ticked the approval boxes when you connected. To change the boxes, click Disconnect in Connected apps and connect again from Claude's Connectors settings.

Disconnecting

In Hero Schedule, open User Settings, find Connected apps, and click Disconnect next to Claude. Access stops immediately. You can also remove the connector in Claude's Connectors settings.

Was this article helpful?

That’s Great!

Thank you for your feedback

Sorry! We couldn't be helpful

Thank you for your feedback

Let us know how can we improve this article!

Select at least one of the reasons
CAPTCHA verification is required.

Feedback sent

We appreciate your effort and will try to fix the article