# Rotageek MCP by usefulapi

> Rotageek MCP by usefulapi is an MCP server. Read staff, locations, shifts, gaps and leave; create leave requests in Rotageek. It runs as a hosted remote server, so there is nothing to install locally.

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

## About

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

## Install

### Claude Code (Terminal)

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

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

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

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

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

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

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

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

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

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

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

## Tools

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

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

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