Name: Shiftbase MCP by usefulapi
Author: usefulapi

Shiftbase MCP by usefulapi

Read Shiftbase rosters, timesheets, absences and availability; schedule shifts and review absences.

not scanned Remote · Streamable HTTP No auth needed 22 tools v1.2.1

No reviews yet by usefulapiGitHub The publisher’s own endpoint — this marketplace is not in the path

tools declared

—

trust score

remote

at its publisher

—

calls last 7d

What it does

Read Shiftbase rosters, timesheets, absences and availability; schedule shifts and review absences.

Quickstart

# 1 — add it to Claude Code
claude mcp add --scope user --transport http shiftbase-mcp-by-usefulapi https://shiftbase.usefulapi.io/mcp

# 2 — ask your agent for something these tools do
#   shiftbase_get_account, shiftbase_list_users, shiftbase_get_user and 19 more

Shiftbase MCP by usefulapi costs nothing on mcprush: there is no plan to choose here, no cap to set and nothing mcprush can bill you for.

Publishernot claimed

usefulapi334 servers

24 categories

All 334 servers

Collected from a public index. Nobody has claimed this account, so nothing here was written by its author — claim it if it is yours.

Tool surface

What the model actually sees. Descriptions are diffed on every release — see version history.

Only tools that write or reach the network

The Shiftbase account this API key belongs to: company, country, time zone, working-day start/end, plan facts. GET /accounts.

No parameter schema on file.

List employees (users) with their teams and departments, contact details, employee number, start/end dates and plus-min hours balance. Use it to map user ids in schedules, timesheets and absences to names. Identity, bank and birth data are never returned. GET /users.

Parameter	Type	Required	Notes
active	boolean	no	true = only active employees, false = only inactive. Default: both.
department_id	integer	no	Only employees of this department.
include_hidden	boolean	no	Also include hidden users.
limit	integer	no	Results per page, 1-200 (default 50). The reply's total and next_offset show what is left.
offset	integer	no	Index of the first result; pass the previous reply's next_offset.

One employee by user id or email address, with teams and departments. GET /users/{identifier}.

Parameter	Type	Required	Notes
user_id	integer	no	Shiftbase user id.
email	string	no	Or the employee's email address.

List departments (sites/branches that own teams, shifts and schedules) with address and timesheet/clocking settings. GET /departments.

Parameter	Type	Required	Notes
limit	integer	no	Results per page, 1-200 (default 50). The reply's total and next_offset show what is left.
offset	integer	no	Index of the first result; pass the previous reply's next_offset.

List teams (the rows of the schedule within a department), optionally for one department. GET /teams.

Parameter	Type	Required	Notes
department_id	integer	no	Only teams of this department.
limit	integer	no	Results per page, 1-200 (default 50). The reply's total and next_offset show what is left.
offset	integer	no	Index of the first result; pass the previous reply's next_offset.

List active locations (addresses that group departments). GET /locations.

Parameter	Type	Required	Notes
limit	integer	no	Results per page, 1-200 (default 50). The reply's total and next_offset show what is left.
offset	integer	no	Index of the first result; pass the previous reply's next_offset.

List shift types (the templates a scheduled shift uses: name, short name, default start/end time and break), optionally for one department. Their ids are the shift_id for shiftbase_create_roster. GET /shifts.

Parameter	Type	Required	Notes
department_id	integer	no	Only shift types of this department.
include_deleted	boolean	no	Also include deleted shift types.
limit	integer	no	Results per page, 1-200 (default 50). The reply's total and next_offset show what is left.
offset	integer	no	Index of the first result; pass the previous reply's next_offset.

List the schedule (rosters = shifts assigned to employees) for a date range of at most 62 days: date, start/end time, break, employee, team, shift type, department, published state, hours and cost. Each item's occurrence_id identifies it for shiftbase_get_roster and shiftbase_update_roster. GET /rosters.

Parameter	Type	Required	Notes
min_date	string	yes	First date (yyyy-mm-dd).
max_date	string	yes	Last date (yyyy-mm-dd), at most 62 days after min_date.
user_id	integer	no	Only shifts of this employee.
department_id	integer	no	Only shifts in this department.
limit	integer	no	Results per page, 1-200 (default 50). The reply's total and next_offset show what is left.
offset	integer	no	Index of the first result; pass the previous reply's next_offset.

One scheduled shift by its occurrence_id, with the employee, shift type, team and who created/changed it. GET /rosters/{occurrenceId}.

Parameter	Type	Required	Notes
occurrence_id	string	yes	The occurrence_id from shiftbase_list_rosters: "<roster id>" or, for a recurring shift, "<roster id>:<yyyy-mm-dd>".

List open (unassigned) shifts that employees can pick up, for a date range of at most 62 days (default: today). Needs the Basic plan or higher. GET /open_shifts.

Parameter	Type	Required	Notes
min_date	string	no	First date (yyyy-mm-dd). Give both dates or neither (= today).
max_date	string	no	Last date (yyyy-mm-dd).
department_id	integer	no	Only open shifts in this department.
user_id	integer	no	Only open shifts this employee can take.
limit	integer	no	Results per page, 1-200 (default 50). The reply's total and next_offset show what is left.
offset	integer	no	Index of the first result; pass the previous reply's next_offset.

Employee availability (available / unavailable, all day or from a time) for a date range of at most 62 days, from Shiftbase's availability report. Needs the Basic plan and the "View reports" permission. POST /reports/availability (export json; reads only).

Parameter	Type	Required	Notes
from	string	yes	First date (yyyy-mm-dd).
to	string	yes	Last date (yyyy-mm-dd), at most 62 days after from.
user_id	integer	no	Only this employee.
department_ids	array	no	Only these departments.
statuses	array	no	Only these availability types.
limit	integer	no	Results per page, 1-200 (default 50). The reply's total and next_offset show what is left.
offset	integer	no	Index of the first result; pass the previous reply's next_offset.

List timesheets (worked hours: clock in/out, breaks, total, status Approved/Declined/Pending, wage and surcharges) for a date range of at most 62 days. GET /timesheets.

Parameter	Type	Required	Notes
min_date	string	yes	First date (yyyy-mm-dd).
max_date	string	yes	Last date (yyyy-mm-dd), at most 62 days after min_date.
user_id	integer	no	Only this employee.
department_id	integer	no	Only this department.
status	string	no	Only timesheets with this status.
limit	integer	no	Results per page, 1-200 (default 50). The reply's total and next_offset show what is left.
offset	integer	no	Index of the first result; pass the previous reply's next_offset.

One timesheet by id, with its clocked breaks. GET /timesheets/{timesheetId}.

Parameter	Type	Required	Notes
timesheet_id	integer	yes	Shiftbase timesheet id.

Who is clocked in right now: employee, since when, their scheduled shift, team, department and location. GET /timesheets/clock.

Parameter	Type	Required	Notes
limit	integer	no	Results per page, 1-200 (default 50). The reply's total and next_offset show what is left.
offset	integer	no	Index of the first result; pass the previous reply's next_offset.

List absences (leave, sick leave, other time off) overlapping a date range of at most 366 days: employee, absence type, start/end date, hours or days, status Approved/Declined/Pending and who reviewed it. Needs the Basic plan. GET /absentees.

Parameter	Type	Required	Notes
min_date	string	yes	First date (yyyy-mm-dd).
max_date	string	yes	Last date (yyyy-mm-dd), at most 366 days after min_date.
user_id	integer	no	Only this employee.
status	string	no	Only absences with this status (Pending = requests waiting for review).
absence_type_ids	array	no	Only these absence types (ids from shiftbase_list_absence_types).
only_open_ended	boolean	no	Only open-ended absences (no end date yet, e.g. long-term sick leave).
include	string	no	Add related data: the per-day breakdown, the employee or the absence type.
limit	integer	no	Results per page, 1-200 (default 50). The reply's total and next_offset show what is left.
offset	integer	no	Index of the first result; pass the previous reply's next_offset.

One absence by id, with the per-day hours and who reviewed it. GET /absentees/{absenteeId}.

Parameter	Type	Required	Notes
absence_id	integer	yes	Shiftbase absence (absentee) id.

List absence types (e.g. Holiday, Sick, Unpaid leave): name, unit (hours or days), whether it costs leave hours, colour. Their ids are the absence_type_id for absences. GET /absentee_options.

Parameter	Type	Required	Notes
limit	integer	no	Results per page, 1-200 (default 50). The reply's total and next_offset show what is left.
offset	integer	no	Index of the first result; pass the previous reply's next_offset.

How many hours an absence would cost for an employee, per day and in total (from the schedule or the contract, per the absence policy), for a period of at most 366 days. Changes nothing. POST /absentees/expected.

Parameter	Type	Required	Notes
user_id	integer	yes	The employee.
absence_type_id	integer	yes	Absence type id (shiftbase_list_absence_types).
start_date	string	yes	First day (yyyy-mm-dd).
end_date	string	yes	Last day (yyyy-mm-dd).

WRITE: put one employee on the schedule for one date (a single, non-recurring shift) in a team, with a shift type, start/end time and break. The employee is notified only when notify is true. POST /rosters.

Parameter	Type	Required	Notes
date	string	yes	Date of the shift (yyyy-mm-dd).
user_id	integer	yes	The employee to schedule.
department_id	integer	yes	Department of the team.
team_id	integer	yes	Team (shiftbase_list_teams).
shift_id	integer	yes	Shift type (shiftbase_list_shift_types).
start_time	string	yes	Start, 24-hour hh:mm (e.g. 09:00).
end_time	string	yes	End, 24-hour hh:mm (e.g. 17:30); earlier than start = ends the next day.
break_minutes	integer	no	Unpaid break in minutes (default 0).
paid_break_minutes	integer	no	Paid break in minutes (default 0).
description	string	no	Note shown on the shift.
notify	boolean	no	Notify the employee (default false).

WRITE: change a scheduled shift: move it to another date, time, employee, team or shift type, or change its break or note. Reads the shift first and sends it back with your changes. For a recurring shift, scope says what changes: "occurrence" (this date only), "sequence" (this date and all later ones) or "original" (the whole series; also the right scope for a non-recurring shift). PUT /rosters/{o

Parameter	Type	Required	Notes
occurrence_id	string	yes	occurrence_id from shiftbase_list_rosters.
scope	string	yes	"original" for a non-recurring shift; see the description for recurring ones.
date	string	no	New date (yyyy-mm-dd).
user_id	integer	no	New employee.
department_id	integer	no	New department (when moving to a team of another department).
team_id	integer	no	New team.
shift_id	integer	no	New shift type.
start_time	string	no	New start, hh:mm.
end_time	string	no	New end, hh:mm.
break_minutes	integer	no	New unpaid break in minutes.
paid_break_minutes	integer	no	New paid break in minutes.
description	string	no	New note.
notify	boolean	no	Notify the employee (default false).

WRITE: add an absence (leave/time-off request) for an employee. By default it is a Pending request for a manager to review; status Approved books it directly (needs the approve-absence permission). The hours per day come from Shiftbase's own expected-hours calculation (the same as shiftbase_get_expected_absence_hours). Needs the Basic plan. POST /absentees.

Parameter	Type	Required	Notes
user_id	integer	yes	The employee.
absence_type_id	integer	yes	Absence type id (shiftbase_list_absence_types).
start_date	string	yes	First day (yyyy-mm-dd).
end_date	string	yes	Last day (yyyy-mm-dd), at most 366 days after start_date.
note	string	no	Note from the requester.
status	string	no	Pending (default) = a request to review; Approved = book it directly.
notify_employee	boolean	no	Notify the employee (default false).

WRITE: approve or decline an absence request. Reads the absence first and sends it back unchanged except for the status (needs the approve-absence permission). PUT /absentees/{absenteeId}.

Parameter	Type	Required	Notes
absence_id	integer	yes	Absence (absentee) id, e.g. from shiftbase_list_absences with status Pending.
decision	string	yes	Approved or Declined.
notify_employee	boolean	no	Notify the employee (default false).

Free

$0 forever

Every tool — any call limit is its publisher’s, not ours
No card, and mcprush charges nothing for it
Runs at its publisher’s own address — this marketplace is not in the path
Nothing to cap, because mcprush bills nothing

Nothing here is billable: mcprush charges nothing to install Shiftbase MCP by usefulapi or to call it, at any volume.

Where are you running it?

Tool surface

Release history

Shiftbase MCP by usefulapi

What it does

Quickstart

Where are you running it?

Tool surface

What counts against your monthly calls

Release history

See also