# RotaCloud MCP by usefulapi

> RotaCloud MCP by usefulapi is an MCP server. Read RotaCloud shifts, attendance, leave, availability and payroll; create shifts and handle leave. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Website:** https://usefulapi.io/rotacloud/
- **Repository:** https://github.com/m190/usefulapi-mcp/tree/HEAD/servers/rotacloud
- **MCP Registry name:** io.usefulapi/rotacloud
- **Listing updated:** 2026-11-13

## About

Read RotaCloud shifts, attendance, leave, availability and payroll; create shifts and handle leave.

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http rotacloud https://rotacloud.usefulapi.io/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://rotacloud.usefulapi.io/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "rotacloud": {
      "url": "https://rotacloud.usefulapi.io/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "rotacloud": {
      "type": "http",
      "url": "https://rotacloud.usefulapi.io/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "rotacloud": {
      "serverUrl": "https://rotacloud.usefulapi.io/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "rotacloud": {
      "type": "http",
      "url": "https://rotacloud.usefulapi.io/mcp"
    }
  }
}
```

## Tools

- `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.

## 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

---
Source: https://ai-powered.com/mcp/rotacloud-mcp-by-usefulapi
