MCP server
RotaCloud MCP by usefulapi
Read RotaCloud shifts, attendance, leave, availability and payroll; create shifts and…
- Runs
- Remotely
- Version
- 1.32.0
- Listing updated
- 4 days ago
About RotaCloud MCP by usefulapi
RotaCloud MCP by usefulapi is an MCP server. It runs as a hosted remote server, so there is nothing to install locally.
Read RotaCloud shifts, attendance, leave, availability and payroll; create shifts and handle leave.
Install
Run in a terminal
claude mcp add --transport http rotacloud https://rotacloud.usefulapi.io/mcpAdd to Settings → Connectors → Add custom connector
https://rotacloud.usefulapi.io/mcpInstall in CursorOpens Cursor, which asks you to confirm. Or add it by hand:
Add to ~/.cursor/mcp.json
{
"mcpServers": {
"rotacloud": {
"url": "https://rotacloud.usefulapi.io/mcp"
}
}
}Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:
Add to .vscode/mcp.json
{
"servers": {
"rotacloud": {
"type": "http",
"url": "https://rotacloud.usefulapi.io/mcp"
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"rotacloud": {
"serverUrl": "https://rotacloud.usefulapi.io/mcp"
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"rotacloud": {
"type": "http",
"url": "https://rotacloud.usefulapi.io/mcp"
}
}
}Tools this server provides (28)
Read directly from the server.
- rotacloud_list_accounts
- The RotaCloud account(s) this API key belongs to: name, plan, time zone, employee count. GET /accounts.
- rotacloud_list_users
- List employees (users) with their level, roles, locations, contact details and pay settings. Use it to map user ids in shifts, leave and attendance to names. GET /users.
- rotacloud_get_user
- One employee by id. GET /users/{id}.
- rotacloud_list_locations
- List locations (sites/branches) with address, time zone and managers. GET /locations.
- rotacloud_list_roles
- List job roles (positions) with colour, default break and pay rate. GET /roles.
- rotacloud_list_shifts
- List rota shifts in a time range: start/end times (Unix seconds), break, assigned user (null = open shift), location, role, notes, published and acknowledged state. Filter by users, locations, roles, open or published. GET /shifts.
- rotacloud_get_shift
- One shift by id. GET /shifts/{id}.
- rotacloud_list_swap_requests
- List shift swap requests with their status, the shifts and the users involved. GET /swap_requests.
- rotacloud_list_day_notes
- List day notes (notices pinned to rota dates, e.g. events or deliveries), optionally for one location. GET /day_notes.
- rotacloud_list_attendance
- List time & attendance records (clock-in/out times, breaks, minutes late, hours, approval state) in a time range. GET /attendance.
- rotacloud_list_clocked_in
- Who is clocked in right now: user, location, role, clock-in time, minutes late and break state. GET /users_clocked_in.
- rotacloud_list_leave
- List booked leave (holiday, sickness, etc.) with type, user, dates, hours and status. Filter by date range or leave year, users and leave types; pending/denied/expired requests are excluded unless asked for. GET /leave.
- rotacloud_list_leave_requests
- List leave requests awaiting a decision (and past ones): user, leave type, dates, half days, the employee's message. GET /leave_requests.
- rotacloud_get_leave_request
- One leave request by id, with the per-day breakdown. GET /leave_requests/{id}.
- rotacloud_list_leave_types
- List leave types (Holiday, Sickness, Unpaid, ...) with id, short name and whether employees can request them. GET /leave_types.
- rotacloud_list_holiday_allowances
- Every employee's holiday allowance for a leave year (default and custom allowance, unit, carried over). GET /holiday_allowances/{year}.
- rotacloud_get_availability
- Employees' availability per date in a range (available / unavailable times). GET /availability.
- rotacloud_list_days_off
- Employees' scheduled days off per date in a range. GET /days_off.
- rotacloud_list_pay_periods
- List pay periods overlapping a date range (id, name, start/end date, locked). GET /pay_periods.
- rotacloud_get_payroll
- Payroll for one pay period, per employee: pay settings, attendance worked, paid/unpaid leave, overtime and pay totals. Contains pay data. GET /pay_periods/{id}/payroll.
- rotacloud_create_shift
- WRITE: create a shift on the rota. Leave user_id out for an open shift. Unpublished by default (employees see it once published). POST /shifts.
- rotacloud_update_shift
- WRITE: change a shift's times, assignee, location, role, break, notes or published state. Only the fields you pass change. POST /shifts/{id}.
- rotacloud_publish_shifts
- WRITE: publish shifts so the assigned employees see them (and get notified). POST /shifts_published.
- rotacloud_find_shifts
- Find shifts in a time range by open/assigned state, published state, location, role and ELAPSED duration (end − start; the break is not subtracted). It reads page after page, so it is the way to select shifts for a bulk change such as rotacloud_delete_shifts: e.g. open shifts shorter than 3 hours = open: true, shorter_than_minutes: 180 (a shift of exactly 180 minutes does not match). Deleted shift
- rotacloud_delete_shifts
- WRITE — deletes shifts from the rota (assigned employees lose the shift). Delete 1-100 shifts by id; select them first with rotacloud_find_shifts. Without confirm it only previews: it reads each shift and deletes nothing. Show the preview to the user, then call again with confirm: true. Guards re-check each shift right before its delete and skip it if it no longer qualifies: require_open (skip ass
- rotacloud_create_leave_request
- WRITE: submit a leave request on behalf of an employee (sent as that user, for a manager to approve). POST /leave_requests with the User header.
- rotacloud_approve_leave_request
- WRITE: approve a pending leave request (it becomes booked leave and the employee is notified). POST /leave_requests/{id}/approve.
- rotacloud_deny_leave_request
- WRITE: deny a pending leave request (the employee is notified). POST /leave_requests/{id}/deny.
RotaCloud MCP by usefulapi FAQ
How do I add RotaCloud MCP by usefulapi to Claude Code?
Run this command in your terminal: claude mcp add --transport http rotacloud https://rotacloud.usefulapi.io/mcp