Connecting ChatGPT to Hero Schedule MCP

Modified on Thu, Nov 19 at 5:50 PM

This guide walks you through adding Hero Schedule to ChatGPT 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 ChatGPT plan that allows custom connectors. Adding your own connector (OpenAI calls these custom MCP connectors, and some plans require turning on Developer mode) is not available on every ChatGPT plan. On a work account, your ChatGPT workspace admin may need to allow it. Some individual plans only let custom connectors read information, so ChatGPT may not be able to approve or reject requests on those plans.
  • 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 chatgpt.com in a web browser.

Add Hero Schedule to ChatGPT

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

  1. In ChatGPT, open Settings and find the section for connectors or apps.
  2. If you see a Developer mode option and it is off, turn it on. It is needed to add a connector that is not in ChatGPT's own directory.
  3. Choose the option to create or add a custom connector.
  4. Fill in the form:
    • Name: Hero Schedule
    • Description: optional, for example "Read my work schedule"
    • Server URL: your connection address
    • Authentication: OAuth. Leave any advanced OAuth settings blank; ChatGPT finds them automatically.
  5. If ChatGPT asks you to confirm that you trust the connector, confirm it. ChatGPT shows this warning for every custom connector.
  6. Click Create. ChatGPT opens Hero Schedule to approve the connection.

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 ChatGPT 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 ChatGPT 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 ChatGPT.

Try it

Start a new chat, turn on the Hero Schedule connector for that chat, 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, ChatGPT should ask which one you mean.

Before ChatGPT approves or rejects anything, it shows you the details and asks you to confirm. Check the employee and dates before you confirm.

Troubleshooting

What you seeWhat to do
No option to add a custom connector or turn on Developer modeYour ChatGPT plan or workspace does not allow custom connectors. On a work account, ask your ChatGPT workspace admin.
ChatGPT cannot find the OAuth settings or cannot connectCheck 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 ChatGPT.
ChatGPT asks you to connect againConnections last 30 days. Connect again; you do not need to add the connector again.
ChatGPT cannot see someone's scheduleChatGPT sees only what your Hero permissions allow. Ask your Hero Schedule administrator if you need wider access.
ChatGPT 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 ChatGPT. Some individual ChatGPT plans only let custom connectors read information.

Disconnecting

In Hero Schedule, open User Settings, find Connected apps, and click Disconnect next to ChatGPT. Access stops immediately. You can also remove the connector in ChatGPT's 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