Skip to content
MCP server

Rotageek MCP by usefulapi

Read staff, locations, shifts, gaps and leave; create leave requests in Rotageek.

Install
Runs
Remotely
Version
1.7.0
Listing updated
4 days ago

About Rotageek MCP by usefulapi

Rotageek MCP by usefulapi is an MCP server. It runs as a hosted remote server, so there is nothing to install locally.

Install

Run in a terminal

claude mcp add --transport http rotageek https://rotageek.usefulapi.io/mcp

Add to Settings → Connectors → Add custom connector

https://rotageek.usefulapi.io/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "rotageek": {
      "url": "https://rotageek.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": {
    "rotageek": {
      "type": "http",
      "url": "https://rotageek.usefulapi.io/mcp"
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "rotageek": {
      "serverUrl": "https://rotageek.usefulapi.io/mcp"
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "rotageek": {
      "type": "http",
      "url": "https://rotageek.usefulapi.io/mcp"
    }
  }
}

Tools this server provides (15)

Read directly from the server.

rotageek_list_users
List the users (staff) in the organisation, optionally filtered by user ids or a location. Use it first to find the user ids the other tools need. Rotageek API: GET /api/v1/users.
rotageek_get_user
Get one user by id: name, contact details, primary location and status. Rotageek API: GET /api/v1/users/{userId}.
rotageek_list_locations
List the locations (sites) of the organisation. Rotageek API: GET /api/v1/locations.
rotageek_get_location
Get one location by id, with its settings. Rotageek API: GET /api/v1/locations/{locationId}.
rotageek_list_location_users
List the users assigned to one location. Rotageek API: GET /api/v1/locations/{locationId}/users.
rotageek_list_user_shifts
List the scheduled shifts and leave records of one user between two date-times, with start, end, location and break minutes. Rotageek API: GET /api/v1/schedule/users/{userId}.
rotageek_list_location_schedule
List the scheduled shifts and leave records of one location between two date-times, for every user there. Rotageek API: GET /api/v1/schedule/locations/{locationId}.
rotageek_list_gaps
List the open gaps (unfilled shifts) for one or more locations between two date-times. Rotageek API: GET /api/v1/gaps/locations.
rotageek_list_leave_requests
List the leave requests of the organisation, optionally in a leave year or date range. Rotageek API: GET /api/v1/leave/requests.
rotageek_list_leave_types
List the leave types (for example holiday or sickness) and their ids. Rotageek API: GET /api/v1/leave/types.
rotageek_create_leave_request
Create a leave request for one user with a leave type id and a start and end date-time. It is saved in Rotageek and can change the rota and holiday balance. Rotageek API: POST /api/v1/leave/requests/users/{userId}.
rotageek_get_timesheet
Get the timesheet records of one location for the week that starts on weekStartDate: hours scheduled and worked per user. Rotageek API: GET /api/v1/timesheets/locations/{locationId}/{weekStartDate}.
rotageek_list_positions
List the job positions (roles) of the organisation with their ids. Rotageek API: GET /api/v1/positions.
rotageek_list_skills
List the skills of the organisation with their ids. Rotageek API: GET /api/v1/skills.
rotageek_list_payroll_codes
List the payroll codes that shifts and leave map to. Rotageek API: GET /api/v1/payrollcodes.

Rotageek MCP by usefulapi FAQ

How do I add Rotageek MCP by usefulapi to Claude Code?

Run this command in your terminal: claude mcp add --transport http rotageek https://rotageek.usefulapi.io/mcp