StaffSavvy MCP by usefulapi
Read shifts, time entries, absences, staff accounts, venues and groups in StaffSavvy.
Should I use this
Quality & Safety
Based on automated analysis of tool definitions and protocol compliance.
Context Cost
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": {
"staffsavvy": {
"url": "https://staffsavvy.usefulapi.io/mcp"
}
}
}Remote endpoints
https://staffsavvy.usefulapi.io/mcpstreamable-httpWhat it can do
Tool inventory
Tools (9)
🟢staffsavvy_get_info
Return the StaffSavvy software version and API version for this instance. A good first call to check the connection. API: GET /api/v1/info.
Input Schema
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢staffsavvy_list_shifts(event, filters)
List shifts on the rota: start and end times, the account, group, venue and task. Filter by event or by field, e.g. start=gte:2026-01-01. API: GET /api/v1/shifts.
Input Schema
{
"type": "object",
"properties": {
"event": {
"description": "Optional event id filter.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"filters": {
"description": "Field filters sent as query keys, e.g. {\"group\": \"5\"} or {\"start\": \"gte:2026-01-01\"}. Operators: not:, gt:, lt:, gte:, lte:.",
"type": "object",
"propertyNames": {
"type": "string",
"minLength": 1,
"maxLength": 64
},
"additionalProperties": {
"type": "string",
"maxLength": 200
}
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢staffsavvy_get_shift(shift_id)
Return one shift by its numeric id. API: GET /api/v1/shifts/{shiftid}.
Input Schema
{
"type": "object",
"properties": {
"shift_id": {
"type": "string",
"pattern": "^\\d{1,18}$",
"description": "Numeric id."
}
},
"required": [
"shift_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢staffsavvy_list_time_entries(event, filters)
List recorded time entries (worked hours): start, end, account, group, venue and pay element. Filter by event or by field. API: GET /api/v1/time-entries.
Input Schema
{
"type": "object",
"properties": {
"event": {
"description": "Optional event id filter.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"filters": {
"description": "Field filters sent as query keys, e.g. {\"group\": \"5\"} or {\"start\": \"gte:2026-01-01\"}. Operators: not:, gt:, lt:, gte:, lte:.",
"type": "object",
"propertyNames": {
"type": "string",
"minLength": 1,
"maxLength": 64
},
"additionalProperties": {
"type": "string",
"maxLength": 200
}
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢staffsavvy_list_absences(filters)
List absence periods (holiday, sickness and other absences) with their dates and types. Filter by field. API: GET /api/v1/absences.
Input Schema
{
"type": "object",
"properties": {
"filters": {
"description": "Field filters sent as query keys, e.g. {\"group\": \"5\"} or {\"start\": \"gte:2026-01-01\"}. Operators: not:, gt:, lt:, gte:, lte:.",
"type": "object",
"propertyNames": {
"type": "string",
"minLength": 1,
"maxLength": 64
},
"additionalProperties": {
"type": "string",
"maxLength": 200
}
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢staffsavvy_list_accounts(filters)
List staff accounts with names, contact details and levels. This returns personal data about staff. API: GET /api/v1/accounts.
Input Schema
{
"type": "object",
"properties": {
"filters": {
"description": "Field filters sent as query keys, e.g. {\"group\": \"5\"} or {\"start\": \"gte:2026-01-01\"}. Operators: not:, gt:, lt:, gte:, lte:.",
"type": "object",
"propertyNames": {
"type": "string",
"minLength": 1,
"maxLength": 64
},
"additionalProperties": {
"type": "string",
"maxLength": 200
}
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢staffsavvy_list_venues(filters)
List the venues (sites or locations) set up in StaffSavvy. API: GET /api/v1/venues.
Input Schema
{
"type": "object",
"properties": {
"filters": {
"description": "Field filters sent as query keys, e.g. {\"group\": \"5\"} or {\"start\": \"gte:2026-01-01\"}. Operators: not:, gt:, lt:, gte:, lte:.",
"type": "object",
"propertyNames": {
"type": "string",
"minLength": 1,
"maxLength": 64
},
"additionalProperties": {
"type": "string",
"maxLength": 200
}
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢staffsavvy_list_groups(filters)
List the groups (teams or departments) set up in StaffSavvy. API: GET /api/v1/groups.
Input Schema
{
"type": "object",
"properties": {
"filters": {
"description": "Field filters sent as query keys, e.g. {\"group\": \"5\"} or {\"start\": \"gte:2026-01-01\"}. Operators: not:, gt:, lt:, gte:, lte:.",
"type": "object",
"propertyNames": {
"type": "string",
"minLength": 1,
"maxLength": 64
},
"additionalProperties": {
"type": "string",
"maxLength": 200
}
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢staffsavvy_list_absence_types(filters)
List the absence types set up in StaffSavvy, e.g. holiday or sickness. API: GET /api/v1/absence-types.
Input Schema
{
"type": "object",
"properties": {
"filters": {
"description": "Field filters sent as query keys, e.g. {\"group\": \"5\"} or {\"start\": \"gte:2026-01-01\"}. Operators: not:, gt:, lt:, gte:, lte:.",
"type": "object",
"propertyNames": {
"type": "string",
"minLength": 1,
"maxLength": 64
},
"additionalProperties": {
"type": "string",
"maxLength": 200
}
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}Community
Evidence