Connecting Your AI Assistant

Modified on Thu, Nov 19 at 5:49 PM

You can connect an AI assistant such as ChatGPT or Claude to your Hero Schedule account and ask it questions about the schedule in plain language. If you approve requests in Hero Schedule, you can also let the assistant approve or reject them for you. The assistant works through a secure connection that you approve, and it can only see and do what you are already allowed to see and do in Hero Schedule.

What you can ask

Once connected, you can ask things like:

  • "When do I work next?"
  • "Who is on shift this Saturday?"
  • "Does anyone on B shift have time off next week?"
  • "How much overtime did I pick up last month?"
  • "What is waiting for my approval?" (approvers)
  • "Approve Jane's time off request for Friday." (approvers, if you allowed approvals)

What the assistant can and cannot do

The assistant canThe assistant cannot
Read the schedule, including shift changes, and the time off and overtime that show on itCreate or edit shifts, or change or delete employees
Read the time off and overtime requests you can decide, with their reasons and approval history (approvers, if you allow it)Create time off or overtime requests for you or anyone else
Read open shifts and who has claimed them (supervisors)See schedule notes, accrual balances, time cards, or payroll
Approve or reject time off and overtime requests (approvers), and assign or turn down open shift claims (supervisors), if you allow itSee or act on anyone your Hero permissions do not cover

Unless you allow approvals, the connection is read-only. If you do allow approvals, a decision can also change the schedule:

  • Assigning an open shift adds that shift to the employee's schedule as overtime and lets the other people who claimed it know.
  • When approving time off, the assistant can post an open shift to cover the hours, but only if you ask it to.
  • Rejecting can take back a request that was already approved, if you are allowed to do that in Hero Schedule.

Overtime shown to the assistant is scheduled overtime and its request status, not confirmed worked or paid hours.

How the connection works

  1. You add Hero Schedule to your AI assistant using your organization's connection address.
  2. The assistant sends you to Hero Schedule, where you log in as usual. Your Hero password is never shared with the assistant.
  3. Hero Schedule shows a Connect Hero Schedule screen with your name, your organization, and what the assistant is asking for. View Schedule is required. You can untick any of the others: View Time Off, View Overtime, Approve Time Off, Approve Overtime, and Fill Open Shifts. The approval boxes only let the assistant act on requests you are already allowed to decide. If the organization shown is wrong, click Use a different organization.
  4. You click Connect and return to the assistant.

View Schedule includes time off and overtime as they appear on the schedule. View Time Off and View Overtime add the request lists, with reasons and approval history, for requests you can decide.

Only connect from your own assistant. Click Connect only on a Connect Hero Schedule screen that opened because you added Hero Schedule in your own assistant. If someone sends you a link to this screen, do not connect.

Your connection address

Your connection address is your Hero Schedule address followed by /mcp:

https://app.heroschedule.com/your-organization/mcp

Replace your-organization with the name that appears after app.heroschedule.com/ in your browser's address bar when you are logged in. For example, if you use Hero Schedule at https://app.heroschedule.com/smallfire/, your connection address is https://app.heroschedule.com/smallfire/mcp.

More than one organization

Each connection is for one organization. If you work in more than one, add Hero Schedule to your assistant once per organization, each with its own connection address and a name that tells them apart (for example "Hero Schedule Small Fire"). When you approve each one, check that the Connect Hero Schedule screen shows the right organization. If you are already logged in to Hero Schedule in that browser, it uses the organization you are logged in to, so click Use a different organization if it is wrong.

Step-by-step guides

ChatGPT and Claude are the assistants supported today. Choose the guide for yours:

Managing and disconnecting

  • See your connections: open User Settings in Hero Schedule and find Connected apps. Each connected assistant is listed with when the connection expires.
  • Disconnect: click Disconnect next to the assistant. It loses access immediately.
  • Change what you allowed: click Disconnect, then connect again from your assistant and tick the boxes you want.
  • Connections last 30 days. After that, the assistant asks you to connect again.
  • Access follows your account. If your Hero permissions change, the assistant's access changes with them. If your login is removed or you become inactive, the connection stops working.

Privacy

Schedule information the assistant reads becomes part of your conversation with that assistant and is handled under that provider's terms, not Hero Schedule's. Check your organization's policy on AI tools before connecting.

With View Time Off or View Overtime ticked, the assistant also reads the reasons and approval comments on requests, which can include personal details. If your organization's policy does not allow that, untick those boxes when you connect.

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