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 examplehttps://app.heroschedule.com/your-organization/mcp. Replaceyour-organizationwith the name that appears afterapp.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.
- In ChatGPT, open Settings and find the section for connectors or apps.
- 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.
- Choose the option to create or add a custom connector.
- 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.
- If ChatGPT asks you to confirm that you trust the connector, confirm it. ChatGPT shows this warning for every custom connector.
- Click Create. ChatGPT opens Hero Schedule to approve the connection.
Approve the connection in Hero Schedule
- If you are not already logged in to Hero Schedule, log in as usual.
- 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.
- 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.
- 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 see | What to do |
|---|---|
| No option to add a custom connector or turn on Developer mode | Your 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 connect | Check 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 Schedule | The 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 again | Connections last 30 days. Connect again; you do not need to add the connector again. |
| ChatGPT cannot see someone's schedule | ChatGPT sees only what your Hero permissions allow. Ask your Hero Schedule administrator if you need wider access. |
| ChatGPT cannot approve or reject requests | Check 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
Feedback sent
We appreciate your effort and will try to fix the article