When someone in your org asks their AI assistant to add a Holiday, change a Business Schedule's working days or check which Holidays apply, the assistant uses the tools in this article. Each one runs with the user's own Salesforce permissions, so the assistant can only change what the user could change in TaskRay themselves.
Business Schedules
| What the assistant can do | A user might ask | Waits for approval |
|---|---|---|
| Create a Business Schedule | "Set up a Four-Day Week business schedule, Monday to Thursday." | No |
| Read a Business Schedule | "Which days count as working days on the UK Office schedule?" | No |
| Update a Business Schedule | "Make Saturday a working day on the UK Office schedule." | No |
| List Business Schedules | "Which business schedules do we have for our UK teams?" | No |
Holidays
| What the assistant can do | A user might ask | Waits for approval |
|---|---|---|
| Create a Holiday | "Add New Year's Day on 1 January as a holiday." | No |
| Read a Holiday | "What date is the Company Offsite Day holiday on?" | No |
| Update a Holiday | "Move the Company Offsite Day holiday to 14 August." | No |
| List Holidays | "Which holidays fall in December?" | No |
Holidays on Business Schedules
| What the assistant can do | A user might ask | Waits for approval |
|---|---|---|
| Add a Holiday to a Business Schedule | "Add New Year's Day to the UK Office schedule." | No |
| Check when a Holiday was added to a Business Schedule | "When was Boxing Day added to the UK Office schedule?" | No |
| Remove a Holiday from a Business Schedule, keeping both | "Take Boxing Day off the US Office schedule." | Yes |
| List the Holidays on a Business Schedule | "Which holidays are on the UK Office schedule?" | No |
Good to Know
- With TaskRay - Standard Access, a user's assistant can read everything here. Making changes needs TaskRay - Admin Access or TaskRay - Resource Manager Access.
- A new Holiday doesn't count as time off for anyone until it's added to a Business Schedule. Changing a Holiday's Date changes it on every Business Schedule it's on.
- Configuration Hub shows only upcoming Holidays, but the assistant can change or remove past ones, which changes past Resource availability.
- A new Business Schedule has no working days unless the request named them.
- Removing a Holiday from a Business Schedule waits for the user to approve it, as described in TaskRay MCP Tool Reference: Approvals for Delete, Bulk and Elevated Tools. It never moves Task dates.
Frequently Asked Questions
Q. A user asked their assistant to delete an old Holiday, and it couldn't. Why?
Great question! Business Schedules and Holidays can't be deleted with TaskRay MCP. We recommend leaving a past Holiday in place. Configuration Hub shows only upcoming Holidays, to preserve historical Resource data.
Where to Go Next
- TaskRay MCP Tool Reference: Resources, Roles and Time Away: the Resources and Roles that use these Business Schedules.
- TaskRay MCP Tool Reference: Projects and Project Teams: adding people to a Project team.
Have a question this reference doesn't answer? Not to worry, our Support Team is ready to help! Contact TaskRay Support with what the user asked their assistant to do, the exact error text, and whether the org is production or sandbox.