Rotawise Shift Scheduler
Weekly staff shift schedules
Should I use this
Quality & Safety
A
Based on automated analysis of tool definitions and protocol compliance.
Context Cost
~4,712Tokens (tool definitions)
~24.1 KBTypical response size
Significant attention impact (3.68% of 128k context)
This is the approximate number of tokens consumed each time the server's tools are loaded into a model's context. Higher counts reduce the attention available for other tasks.
Install
One-Click Install
Add this to your `claude_desktop_config.json` file:
{
"mcpServers": {
"shift-scheduler": {
"url": "https://shift-scheduler.zovo.one/mcp"
}
}
}Remote endpoints
https://shift-scheduler.zovo.one/mcpstreamable-httpWhat it can do
Tool inventory
Tools (2)
🟢 Read-only🟡 Write🔴 Delete⚪ Unknown
🟢generate_shift_schedule(staff, staff_file, shifts, min_rest_hours, max_consecutive_days, ...)
Use this when the user wants an employee schedule maker or work schedule maker: build a weekly staff or shift schedule for a restaurant, cafe, retail store, clinic front desk or similar from staff names, roles or skills, availability (days or times people cannot work), min/max hours, and the shifts to cover with headcount, e.g. "make a weekly schedule for 6 employees", "need 2 people on each shift, nobody over 40 hours", "make a rotating schedule so weekends are fair", "who should close on friday", "Sam cannot work Mondays". Accepts typed lists or an attached availability CSV/XLSX. A deterministic solver checks each hard rule (roles, availability, max hours, overtime cap, minimum rest between shifts, shifts per day, consecutive days), balances weekend and closing shifts, and when coverage is impossible returns each open shift with the binding reason. Returns hours per person, overtime flags, fairness ranges, and a printable PDF, Excel file and per-employee calendar (.ics) files. Overnight shifts and daylight-saving weeks are counted in real elapsed hours. Does not post schedules, message staff, track clock-ins or run payroll. Do not use for job searches or for checking a schedule the user already made (use check_schedule).
Input Schema
{
"type": "object",
"properties": {
"staff": {
"description": "The team, one item per person (up to 80), e.g. [{\"name\":\"Ana\",\"roles\":[\"cook\"],\"max_hours\":40,\"unavailable\":[\"Sun\"]}]. Can be combined with staff_file.",
"maxItems": 80,
"type": "array",
"items": {
"type": "object",
"properties": {
"name": {
"type": "string",
"maxLength": 60,
"description": "Employee name, unique, e.g. \"Ana\" or \"Sam K.\"."
},
"roles": {
"description": "Roles or skills this person can cover, e.g. [\"cook\", \"cashier\"]. Leave out if they can work any shift.",
"maxItems": 10,
"type": "array",
"items": {
"type": "string",
"maxLength": 40
}
},
"min_hours": {
"description": "Hours this person would like at least this week (a goal, not guaranteed), e.g. 20.",
"type": "number",
"minimum": 0,
"maximum": 168
},
"max_hours": {
"description": "Most hours this person may work this week (a hard limit), e.g. 24 for a part-timer.",
"type": "number",
"minimum": 0,
"maximum": 168
},
"max_shifts_per_day": {
"description": "Shifts this person may work in one day, e.g. 2 to allow a split shift. Default: the max_shifts_per_day rule (1).",
"type": "integer",
"minimum": 1,
"maximum": 4
},
"max_days": {
"description": "Most days this person may work this week, e.g. 4.",
"type": "integer",
"minimum": 0,
"maximum": 7
},
"unavailable": {
"description": "Times this person cannot work, e.g. [\"Mon\"], [\"Sat before 14:00\", \"Fri 18:00-23:00\", \"2026-10-07\"], [\"weekends\"]. Any overlap blocks the shift.",
"maxItems": 30,
"type": "array",
"items": {
"type": "string",
"maxLength": 60
}
},
"available": {
"description": "Only for people who can work ONLY at certain times: the windows they can work, e.g. [\"Mon-Fri after 16:00\", \"Sat\", \"Sun\"]. A shift must fit fully inside a window.",
"maxItems": 30,
"type": "array",
"items": {
"type": "string",
"maxLength": 60
}
},
"preferred": {
"description": "Soft wishes, e.g. [\"mornings\"], [\"Sat\", \"Sun\"] or [\"Tue 16:00-22:00\"]. A shift counts as preferred when it starts inside a window.",
"maxItems": 30,
"type": "array",
"items": {
"type": "string",
"maxLength": 60
}
}
},
"required": [
"name"
]
}
},
"staff_file": {
"type": "object",
"properties": {
"download_url": {
"type": "string",
"description": "Temporary download link for the file, supplied by ChatGPT."
},
"file_id": {
"type": "string",
"description": "ChatGPT file id, e.g. file_abc123."
},
"mime_type": {
"description": "Media type if known, e.g. application/pdf.",
"type": "string"
},
"file_name": {
"description": "Original file name if known, e.g. statement.pdf.",
"type": "string"
}
},
"required": [
"download_url",
"file_id"
],
"description": "Optional staff availability spreadsheet the user attached (CSV or Excel .xlsx), e.g. availability.xlsx: a Name column plus Role, Max hours, Min hours, Unavailable, Preferred, and/or day columns (Mon..Sun) holding \"off\", \"9-15\" or blank for any time. An .xlsx may also hold a Shifts sheet (Day, Start, End, Role, Headcount)."
},
"shifts": {
"description": "Shifts to cover, e.g. [{\"day\":\"Mon-Fri\",\"start\":\"07:00\",\"end\":\"15:00\",\"role\":\"cook\",\"headcount\":2}]. Required unless the attached .xlsx has a Shifts sheet.",
"maxItems": 150,
"type": "array",
"items": {
"type": "object",
"properties": {
"day": {
"type": "string",
"maxLength": 40,
"description": "Day or days this shift runs: \"Mon\", \"Mon-Fri\", \"weekdays\", \"weekends\", \"daily\", \"Fri, Sat\", or a date \"2026-10-09\"."
},
"start": {
"type": "string",
"maxLength": 24,
"description": "Start time, e.g. \"07:00\", \"7am\" or \"15:30\". A whole range like \"7am-3pm\" also works if end is left out."
},
"end": {
"description": "End time, e.g. \"15:00\" or \"3pm\". An end at or before the start means the shift ends the next day (22:00-06:00).",
"type": "string",
"maxLength": 20
},
"role": {
"description": "Role this shift needs, e.g. \"cook\". Leave out if anyone can work it.",
"type": "string",
"maxLength": 40
},
"headcount": {
"description": "People needed on this shift at the same time, default 1, e.g. 2.",
"type": "integer",
"minimum": 0,
"maximum": 30
},
"label": {
"description": "Optional shift name, e.g. \"Open\", \"Close\", \"Lunch rush\".",
"type": "string",
"maxLength": 40
}
},
"required": [
"day",
"start"
]
}
},
"min_rest_hours": {
"description": "Minimum hours off between two shifts of the same person (the \"clopening\" rule), default 10, e.g. 8 or 11. 0 only blocks overlaps.",
"type": "number",
"minimum": 0,
"maximum": 24
},
"max_consecutive_days": {
"description": "Most days in a row anyone may work in this week, default 6, e.g. 5.",
"type": "integer",
"minimum": 1,
"maximum": 7
},
"overtime_after_hours": {
"description": "Weekly hours after which time counts as overtime, default 40 (US federal FLSA workweek), e.g. 40. 0 turns overtime tracking off.",
"type": "number",
"minimum": 0,
"maximum": 168
},
"allow_overtime": {
"description": "false (default): nobody is scheduled past overtime_after_hours. true: overtime is allowed when needed for coverage, kept as low as possible, and flagged.",
"type": "boolean"
},
"max_shifts_per_day": {
"description": "Default shifts per person per day, default 1. Use 2 to allow split shifts (same-day shifts need no rest gap, only no overlap).",
"type": "integer",
"minimum": 1,
"maximum": 4
},
"week_start": {
"description": "First day of the week to schedule, e.g. \"2026-10-05\". Default: next Monday. Dates pin calendar files and daylight-saving weeks to real hours.",
"type": "string",
"maxLength": 20
},
"time_zone": {
"description": "The business's time zone, IANA or US name, e.g. \"America/Chicago\", \"Pacific\". Default America/New_York. Used for daylight-saving weeks and calendar files.",
"type": "string",
"maxLength": 40
},
"business_name": {
"description": "Optional name printed on the PDF, e.g. \"Blue Door Cafe\".",
"type": "string",
"maxLength": 60
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}Output Schema
{
"type": "object",
"properties": {
"week": {
"type": "object",
"properties": {
"start": {
"type": "string"
},
"end": {
"type": "string"
},
"label": {
"type": "string"
},
"time_zone": {
"type": "string"
}
},
"required": [
"start",
"end",
"label",
"time_zone"
],
"additionalProperties": false
},
"coverage": {
"type": "object",
"properties": {
"filled": {
"type": "number"
},
"total": {
"type": "number"
},
"open_slots": {
"type": "number"
},
"complete": {
"type": "boolean"
},
"proven_best": {
"type": "boolean"
}
},
"required": [
"filled",
"total",
"open_slots",
"complete",
"proven_best"
],
"additionalProperties": false
},
"open_shifts": {
"type": "array",
"items": {
"type": "object",
"properties": {
"day": {
"type": "string"
},
"time": {
"type": "string"
},
"role": {
"type": [
"string",
"null"
]
},
"missing": {
"type": "number"
},
"reason": {
"type": "string"
},
"fixes": {
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"day",
"time",
"role",
"missing",
"reason",
"fixes"
],
"additionalProperties": false
}
},
"open_shifts_not_shown": {
"type": "number"
},
"staff": {
"type": "array",
"items": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"hours": {
"type": "number"
},
"shifts": {
"type": "number"
},
"overtime_hours": {
"type": "number"
},
"weekend_shifts": {
"type": "number"
},
"closing_shifts": {
"type": "number"
},
"flags": {
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"name",
"hours",
"shifts",
"overtime_hours",
"weekend_shifts",
"closing_shifts",
"flags"
],
"additionalProperties": false
}
},
"schedule": {
"type": "array",
"items": {
"type": "object",
"properties": {
"day": {
"type": "string"
},
"shifts": {
"type": "array",
"items": {
"type": "object",
"properties": {
"time": {
"type": "string"
},
"role": {
"type": [
"string",
"null"
]
},
"staff": {
"type": "array",
"items": {
"type": "string"
}
},
"open": {
"type": "number"
}
},
"required": [
"time",
"role",
"staff",
"open"
],
"additionalProperties": false
}
}
},
"required": [
"day",
"shifts"
],
"additionalProperties": false
}
},
"fairness": {
"type": "object",
"properties": {
"weekend_shifts_min": {
"type": "number"
},
"weekend_shifts_max": {
"type": "number"
},
"closing_shifts_min": {
"type": "number"
},
"closing_shifts_max": {
"type": "number"
},
"hours_min": {
"type": "number"
},
"hours_max": {
"type": "number"
}
},
"required": [
"weekend_shifts_min",
"weekend_shifts_max",
"closing_shifts_min",
"closing_shifts_max",
"hours_min",
"hours_max"
],
"additionalProperties": false
},
"rules": {
"type": "object",
"properties": {
"min_rest_hours": {
"type": "number"
},
"max_consecutive_days": {
"type": "number"
},
"overtime_after_hours": {
"type": "number"
},
"allow_overtime": {
"type": "boolean"
},
"max_shifts_per_day": {
"type": "number"
}
},
"required": [
"min_rest_hours",
"max_consecutive_days",
"overtime_after_hours",
"allow_overtime",
"max_shifts_per_day"
],
"additionalProperties": false
},
"assumptions": {
"type": "array",
"items": {
"type": "string"
}
},
"notes": {
"type": "array",
"items": {
"type": "string"
}
},
"downloads": {
"type": "object",
"properties": {
"pdf": {
"type": "string"
},
"xlsx": {
"type": "string"
},
"calendars_zip": {
"type": "string"
}
},
"required": [
"pdf",
"xlsx",
"calendars_zip"
],
"additionalProperties": false
}
},
"required": [
"week",
"coverage",
"open_shifts",
"staff",
"schedule",
"fairness",
"rules",
"assumptions",
"notes",
"downloads"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🟢check_schedule(assignments, schedule_file, staff, min_rest_hours, max_consecutive_days, ...)
Use this when the user already has a work schedule and wants it checked against scheduling rules: "check this schedule", "does anyone have a clopening", "is anyone over 40 hours", "fix this schedule, Sam cannot work Mondays". Takes the shifts with the people on them (typed, or an attached schedule CSV/XLSX grid or list) plus optional staff rules (roles, max hours, unavailable days) and reports each problem it finds: overlapping or double-booked shifts, less rest than the rule between shifts, too many shifts per day or days in a row, over max hours or overtime, wrong role, unavailable times, and shifts below headcount. Returns hours per person and a PDF, Excel and per-employee calendar files of the checked schedule. Does not change the schedule itself (generate_shift_schedule builds a corrected one) and does not give legal advice on scheduling laws.
Input Schema
{
"type": "object",
"properties": {
"assignments": {
"description": "The schedule to check, one item per shift with its people, e.g. [{\"day\":\"Fri\",\"start\":\"16:00\",\"end\":\"23:00\",\"staff\":[\"Sam\"]},{\"day\":\"Sat\",\"start\":\"07:00\",\"end\":\"15:00\",\"staff\":[\"Sam\"]}].",
"maxItems": 200,
"type": "array",
"items": {
"type": "object",
"properties": {
"day": {
"type": "string",
"maxLength": 40,
"description": "Day of the shift, e.g. \"Mon\" or \"2026-10-05\" (a range like \"Mon-Fri\" repeats it each day)."
},
"start": {
"type": "string",
"maxLength": 24,
"description": "Start time, e.g. \"07:00\" or \"7am\" (or a range \"7am-3pm\" with end left out)."
},
"end": {
"description": "End time, e.g. \"15:00\". At or before the start = ends the next day.",
"type": "string",
"maxLength": 20
},
"role": {
"description": "Role of the shift, e.g. \"cook\".",
"type": "string",
"maxLength": 40
},
"staff": {
"maxItems": 30,
"type": "array",
"items": {
"type": "string",
"maxLength": 60
},
"description": "Names of the people on this shift, e.g. [\"Ana\", \"Ben\"]. Empty list = nobody yet."
},
"headcount": {
"description": "People the shift should have, e.g. 2. Leave out if the listed staff is the target.",
"type": "integer",
"minimum": 0,
"maximum": 30
}
},
"required": [
"day",
"start",
"staff"
]
}
},
"schedule_file": {
"type": "object",
"properties": {
"download_url": {
"type": "string",
"description": "Temporary download link for the file, supplied by ChatGPT."
},
"file_id": {
"type": "string",
"description": "ChatGPT file id, e.g. file_abc123."
},
"mime_type": {
"description": "Media type if known, e.g. application/pdf.",
"type": "string"
},
"file_name": {
"description": "Original file name if known, e.g. statement.pdf.",
"type": "string"
}
},
"required": [
"download_url",
"file_id"
],
"description": "Optional existing schedule the user attached (CSV or .xlsx): a grid with a Name column and day columns (Mon..Sun) holding \"07:00-15:00 cook\" or \"off\", or a list with Employee, Day, Start, End, Role columns, e.g. week41.xlsx."
},
"staff": {
"description": "Optional staff rules to check against (roles, max hours, unavailable days), same format as generate_shift_schedule, e.g. [{\"name\":\"Sam\",\"unavailable\":[\"Mon\"]}].",
"maxItems": 80,
"type": "array",
"items": {
"type": "object",
"properties": {
"name": {
"type": "string",
"maxLength": 60,
"description": "Employee name, unique, e.g. \"Ana\" or \"Sam K.\"."
},
"roles": {
"description": "Roles or skills this person can cover, e.g. [\"cook\", \"cashier\"]. Leave out if they can work any shift.",
"maxItems": 10,
"type": "array",
"items": {
"type": "string",
"maxLength": 40
}
},
"min_hours": {
"description": "Hours this person would like at least this week (a goal, not guaranteed), e.g. 20.",
"type": "number",
"minimum": 0,
"maximum": 168
},
"max_hours": {
"description": "Most hours this person may work this week (a hard limit), e.g. 24 for a part-timer.",
"type": "number",
"minimum": 0,
"maximum": 168
},
"max_shifts_per_day": {
"description": "Shifts this person may work in one day, e.g. 2 to allow a split shift. Default: the max_shifts_per_day rule (1).",
"type": "integer",
"minimum": 1,
"maximum": 4
},
"max_days": {
"description": "Most days this person may work this week, e.g. 4.",
"type": "integer",
"minimum": 0,
"maximum": 7
},
"unavailable": {
"description": "Times this person cannot work, e.g. [\"Mon\"], [\"Sat before 14:00\", \"Fri 18:00-23:00\", \"2026-10-07\"], [\"weekends\"]. Any overlap blocks the shift.",
"maxItems": 30,
"type": "array",
"items": {
"type": "string",
"maxLength": 60
}
},
"available": {
"description": "Only for people who can work ONLY at certain times: the windows they can work, e.g. [\"Mon-Fri after 16:00\", \"Sat\", \"Sun\"]. A shift must fit fully inside a window.",
"maxItems": 30,
"type": "array",
"items": {
"type": "string",
"maxLength": 60
}
},
"preferred": {
"description": "Soft wishes, e.g. [\"mornings\"], [\"Sat\", \"Sun\"] or [\"Tue 16:00-22:00\"]. A shift counts as preferred when it starts inside a window.",
"maxItems": 30,
"type": "array",
"items": {
"type": "string",
"maxLength": 60
}
}
},
"required": [
"name"
]
}
},
"min_rest_hours": {
"description": "Minimum hours off between two shifts of the same person (the \"clopening\" rule), default 10, e.g. 8 or 11. 0 only blocks overlaps.",
"type": "number",
"minimum": 0,
"maximum": 24
},
"max_consecutive_days": {
"description": "Most days in a row anyone may work in this week, default 6, e.g. 5.",
"type": "integer",
"minimum": 1,
"maximum": 7
},
"overtime_after_hours": {
"description": "Weekly hours after which time counts as overtime, default 40 (US federal FLSA workweek), e.g. 40. 0 turns overtime tracking off.",
"type": "number",
"minimum": 0,
"maximum": 168
},
"allow_overtime": {
"description": "false (default): nobody is scheduled past overtime_after_hours. true: overtime is allowed when needed for coverage, kept as low as possible, and flagged.",
"type": "boolean"
},
"max_shifts_per_day": {
"description": "Default shifts per person per day, default 1. Use 2 to allow split shifts (same-day shifts need no rest gap, only no overlap).",
"type": "integer",
"minimum": 1,
"maximum": 4
},
"week_start": {
"description": "First day of the week to schedule, e.g. \"2026-10-05\". Default: next Monday. Dates pin calendar files and daylight-saving weeks to real hours.",
"type": "string",
"maxLength": 20
},
"time_zone": {
"description": "The business's time zone, IANA or US name, e.g. \"America/Chicago\", \"Pacific\". Default America/New_York. Used for daylight-saving weeks and calendar files.",
"type": "string",
"maxLength": 40
},
"business_name": {
"description": "Optional name printed on the PDF, e.g. \"Blue Door Cafe\".",
"type": "string",
"maxLength": 60
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}Output Schema
{
"type": "object",
"properties": {
"week": {
"type": "object",
"properties": {
"start": {
"type": "string"
},
"end": {
"type": "string"
},
"label": {
"type": "string"
},
"time_zone": {
"type": "string"
}
},
"required": [
"start",
"end",
"label",
"time_zone"
],
"additionalProperties": false
},
"valid": {
"type": "boolean"
},
"problem_count": {
"type": "number"
},
"problems_by_rule": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"type": "number"
}
},
"problems": {
"type": "array",
"items": {
"type": "object",
"properties": {
"rule": {
"type": "string"
},
"staff": {
"type": "string"
},
"shift": {
"type": "string"
},
"detail": {
"type": "string"
}
},
"required": [
"rule",
"staff",
"shift",
"detail"
],
"additionalProperties": false
}
},
"open_shifts": {
"type": "array",
"items": {
"type": "object",
"properties": {
"day": {
"type": "string"
},
"time": {
"type": "string"
},
"role": {
"type": [
"string",
"null"
]
},
"missing": {
"type": "number"
}
},
"required": [
"day",
"time",
"role",
"missing"
],
"additionalProperties": false
}
},
"open_shifts_not_shown": {
"type": "number"
},
"staff": {
"type": "array",
"items": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"hours": {
"type": "number"
},
"shifts": {
"type": "number"
},
"overtime_hours": {
"type": "number"
},
"weekend_shifts": {
"type": "number"
},
"closing_shifts": {
"type": "number"
},
"flags": {
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"name",
"hours",
"shifts",
"overtime_hours",
"weekend_shifts",
"closing_shifts",
"flags"
],
"additionalProperties": false
}
},
"rules": {
"type": "object",
"properties": {
"min_rest_hours": {
"type": "number"
},
"max_consecutive_days": {
"type": "number"
},
"overtime_after_hours": {
"type": "number"
},
"allow_overtime": {
"type": "boolean"
},
"max_shifts_per_day": {
"type": "number"
}
},
"required": [
"min_rest_hours",
"max_consecutive_days",
"overtime_after_hours",
"allow_overtime",
"max_shifts_per_day"
],
"additionalProperties": false
},
"assumptions": {
"type": "array",
"items": {
"type": "string"
}
},
"notes": {
"type": "array",
"items": {
"type": "string"
}
},
"downloads": {
"type": "object",
"properties": {
"pdf": {
"type": "string"
},
"xlsx": {
"type": "string"
},
"calendars_zip": {
"type": "string"
}
},
"required": [
"pdf",
"xlsx",
"calendars_zip"
],
"additionalProperties": false
}
},
"required": [
"week",
"valid",
"problem_count",
"problems_by_rule",
"problems",
"open_shifts",
"staff",
"rules",
"assumptions",
"notes",
"downloads"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}Community
Evidence
Recent observations
verifiedversion not recorded2 tools