MCP server

Deputy MCP by usefulapi

io.usefulapi/deputy

Checked 26 Oct 2026, 08:29 UTC · Connected to it and listed its tools

See rosters, timesheets, leave and staff in Deputy, and create shifts, leave and memos.

Website Source

At a glance

Type

MCP server

Publisher

usefulapi.io (verified by the MCP Registry)

Status

Working at last check

Tools

21

Token cost

About 6,892 tokens per request

Sets up in

Claude Code, Claude Desktop, Codex, Gemini CLI, Cursor, VS Code, Antigravity, ChatGPT, OpenAI API, Grok

Last checked

26 Oct 2026, 08:29 UTC

Connect it to your agent

Add to CursorAdd to VS CodeVS Code Insiders

Opens the app, which shows the server and asks you to confirm. For other apps, copy the setup below.

Claude Code

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

Claude Desktop

Settings → Connectors → Add custom connector, and paste the URL.

Codex (config.toml)

[mcp_servers.deputy]
url = "https://deputy.usefulapi.io/mcp"

Gemini CLI

{"mcpServers":{"deputy":{"httpUrl":"https://deputy.usefulapi.io/mcp"}}}

Cursor

{"mcpServers":{"deputy":{"url":"https://deputy.usefulapi.io/mcp"}}}

VS Code

{"servers":{"deputy":{"type":"http","url":"https://deputy.usefulapi.io/mcp"}}}

Antigravity

agy mcp add deputy https://deputy.usefulapi.io/mcp

ChatGPT

Settings → Apps & Connectors → Advanced settings: turn on Developer mode, then Create a connector and paste the URL. Which plans can do this varies.

OpenAI API (Responses tools)

{"type":"mcp","server_label":"deputy","server_url":"https://deputy.usefulapi.io/mcp","require_approval":"always"}

Grok (xAI API tools)

{"type":"mcp","server_label":"deputy","server_url":"https://deputy.usefulapi.io/mcp"}

Tools

• deputy_add_unavailability ~414 tokens
  Record a time an employee cannot work (one-off, or recurring with an RFC 5545-style rule such as FREQ WEEKLY, INTERVAL 1, BYDAY MO). Auto-scheduling then skips them. Deputy: POST /api/v1/supervise/unavail.
• deputy_approve_timesheet ~138 tokens
  Approve one timesheet's times as a supervisor. Approved timesheets flow toward payroll export, so check it first with deputy_get_timesheet. Deputy: POST /api/v1/supervise/timesheet/approve.
• deputy_create_leave_request ~570 tokens
  Add a leave request for an employee. By default it waits for manager approval (status 0); pass status 1 only when your system is the source of truth and the leave is already approved. Deputy tracks leave in hours, so give exact start and end times. Find leave type ids with deputy_query_resource on L
• deputy_create_memo ~285 tokens
  Post a memo to a location's news feed, optionally requiring staff to confirm they read it, or targeted to specific locations or users. Visible to staff immediately. Deputy: PUT /api/v1/supervise/memo.
• deputy_create_shift ~522 tokens
  Add a shift to the roster, assigned to an employee or left open. Created as a DRAFT unless publish is true (publishing can notify the employee). Deputy returns an empty 200 on success — use deputy_list_shifts to find the new shift's id. Deputy: POST /api/v1/supervise/roster.
• deputy_describe_resource ~395 tokens
  Return a Resource API object's field list, field types and joinable associations — what deputy_query_resource can filter, sort and join on. Deputy: GET /api/v1/resource/{Object}/INFO.
• deputy_get_employee ~122 tokens
  Fetch one employee's details as a supervisor sees them — contact, locations, role and employment. Deputy: GET /api/v1/supervise/employee/{id}.
• deputy_get_employee_unavailability ~134 tokens
  List the times one employee has marked themselves (or been marked) unavailable to work — check before rostering them. Deputy: GET /api/v1/supervise/unavail/{employeeId}.
• deputy_get_shift ~104 tokens
  Fetch one shift (Roster record) by id. Deputy: GET /api/v1/resource/Roster/{id}.
• deputy_get_timesheet ~119 tokens
  Fetch one timesheet's full details, including breaks and approval state. Deputy: GET /api/v1/supervise/timesheet/{id}/details.
• deputy_list_areas ~261 tokens
  List areas (Deputy OperationalUnits — the rosterable sections of a location, e.g. Kitchen, Front of house). Shifts and timesheets belong to an area. Optionally only one location's areas. Deputy: GET /api/v1/resource/OperationalUnit, or POST .../OperationalUnit/QUERY when filtered.
• deputy_list_employees ~271 tokens
  Search employees by name, location or active status. Returns Id, DisplayName, Company (main location), Active, StartDate, Role and more. Deputy: POST /api/v1/resource/Employee/QUERY.
• deputy_list_leave ~454 tokens
  Search leave requests by employee, location, status and time window. Status: 0 awaiting approval, 1 approved, 2 declined, 3 cancelled, 4 date approved without pay, 5 pay approved without date. Start/End are unix; LeaveRule is the leave type id. Deputy: POST /api/v1/resource/Leave/QUERY.
• deputy_list_locations ~91 tokens
  List the install's locations (workplaces). Deputy calls a location a Company; its Id is what other tools take as location_id. Deputy: GET /api/v1/resource/Company.
• deputy_list_shifts ~476 tokens
  Search the roster (scheduled shifts) by time window, employee, area, and published/open state. Each record has StartTime/EndTime (unix), StartTimeLocalized, Employee (0 or null when open), OperationalUnit (area), Published, Open, Cost and _DPMetaData with names. Deputy: POST /api/v1/resource/Roster/
• deputy_list_timesheets ~527 tokens
  Search timesheets (actual worked time) by time window, employee, area and approval state. Each record has StartTime/EndTime (unix; EndTime null while in progress), TotalTime (hours), Cost, TimeApproved, PayRuleApproved, IsInProgress, IsLeave, Roster (linked shift) and Exported. Deputy: POST /api/v1/
• deputy_publish_shifts Sends messages · ~209 tokens
  Publish draft shifts so employees see them, choosing how they are notified: 1 SMS and email, 2 SMS, 3 email, 4 no notification, 5 confirmation required. Only the listed shift ids are published. Deputy: POST /api/v1/supervise/roster/publish.
• deputy_query_resource ~792 tokens
  Run a Resource API search on any business object (leave types, pay rules, public holidays, memos, events, shift templates, pay lines, availability, sales data, …). `search` is Deputy's clause map, e.g. {"s1":{"field":"Employee","data":12,"type":"eq"}}; operators: eq ne gt lt ge le is 'is not' in 'no
• deputy_update_shift ~543 tokens
  Change an existing shift's times, area, employee, break or comment. Send the full intended shift (same fields as create) — Deputy's update is the add call with the shift id. Deputy: POST /api/v1/supervise/roster with intRosterId.
• deputy_update_timesheet ~372 tokens
  Correct an existing timesheet's start/end time, area, meal break or supervisor comment. Times cannot be in the future. Deputy: POST /api/v1/supervise/timesheet/update.
• deputy_whoami ~93 tokens
  Return the Deputy user the token belongs to — name, employee id, company and permissions. A cheap way to confirm DEPUTY_INSTALL and the token are right. Deputy: GET /api/v1/me.

Browse

• Email
• SMS and text messages
• Booking and scheduling
• News

Related MCP servers

• Shiftbase MCP by usefulapi
  Read Shiftbase rosters, timesheets, absences and availability; schedule shifts and review absences.
• RotaCloud MCP by usefulapi
  Read RotaCloud shifts, attendance, leave, availability and payroll; create shifts and handle leave.
• Moltline Optimize
  Vehicle routing, 3-D packing, cutting stock, rostering and knapsack with OR-Tools. 7 of 11 free.
• Shift Scheduler
  Builds optimal 24/7 staff rosters with a real MILP solver: rest rules, skills, nights, fairness.
• Employment Hero Payroll MCP by usefulapi
  Read Employment Hero Payroll pay runs, payslips, timesheets and leave; approve or decline leave.
• Boulevard MCP by usefulapi
  Look up appointments, clients, services, staff and orders, and update clients in Boulevard.
• Connecteam MCP by usefulapi
  Read Connecteam users, shifts, time clock, jobs, time off, tasks and forms; create shifts and tasks.
• Tamigo MCP by usefulapi
  Read Tamigo departments, employees, shifts, absences and opening hours; register attendance.

Badge for your README

[![AptLynx](https://aptlynx.net/badge/io.usefulapi/deputy.svg)](https://aptlynx.net/servers/io.usefulapi/deputy)

Listing text is written by the maker; AptLynx lists tools and does not vouch for them. Find another tool · Browse by topic · For agents