Deputy

io.usefulapiv1.0.0Updated Sep 30, 2026

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

VerifiedStreamable HTTPWeb executableBusiness & CommerceProductivity & Workflow

Overview

AI-generated overview

Lets an assistant read Deputy rosters, timesheets, leave and staff, and create shifts, leave requests and memos.

What it does
Deputy MCP is a hosted connector to the Deputy workforce management service. Read tools cover whoami, locations, areas, employees, shifts, timesheets, leave requests and employee unavailability, plus generic resource query and describe tools. Write tools create and update shifts, publish shifts, create leave requests, add unavailability, post memos, and update or approve timesheets. Two meta tools report usage and manage the subscription.
When to use it
Use it when an assistant should answer questions about Deputy scheduling and staff data, or make scheduling changes such as creating shifts, publishing rosters, filing leave requests or approving timesheets. It suits teams already running Deputy that want conversational access instead of using the Deputy interface directly.
Requirements
A remote MCP endpoint; no local install. You supply your Deputy install host (for example acme.au.deputy.com) and a permanent access token from the Deputy developer portal, entered on first connect and stored per user. Network access to the endpoint is required.
Before you install
The permanent access token is a long-lived credential for your Deputy account; treat it as a secret. Write tools change real workforce data: creating, updating and publishing shifts, leave requests, unavailability, memos, and timesheet updates or approvals, so confirm actions before they run. The free tier allows 100 tool calls per month; Pro is $9 per month or $90 per year per user.

Installation

In SourceWeft

  1. Open Deputy in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Other MCP clients

Add this to your client's mcpServers config.

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

README

Deputy MCP by usefulapi

Use Deputy from Claude, Cursor, or any MCP client — see rosters, timesheets, leave and staff, and create shifts, leave requests and memos. Hosted, no local install: connect with your own Deputy credentials.

Live endpoint: https://deputy.usefulapi.io/mcp · Homepage: https://usefulapi.io/deputy

Add to Claude

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

On first connect you'll provide your Deputy install host (like acme.au.deputy.com) and a permanent access token (Deputy developer portal → OAuth Client → Get an Access Token). They're validated, stored per-user, and scoped to you — no keys in config files.

Tools

ToolTypeWhat it does
deputy_whoamireadWho am I
deputy_list_locationsreadList locations
deputy_list_areasreadList areas
deputy_list_employeesreadList employees
deputy_get_employeereadGet one employee
deputy_list_shiftsreadList shifts
deputy_get_shiftreadGet one shift
deputy_list_timesheetsreadList timesheets
deputy_get_timesheetreadGet one timesheet
deputy_list_leavereadList leave requests
deputy_get_employee_unavailabilityreadGet an employee's unavailability
deputy_query_resourcereadQuery any Deputy resource
deputy_describe_resourcereadDescribe a Deputy resource
deputy_create_shiftwriteCreate a shift
deputy_update_shiftwriteUpdate a shift
deputy_publish_shiftswritePublish shifts
deputy_create_leave_requestwriteCreate a leave request
deputy_add_unavailabilitywriteAdd unavailability for an employee
deputy_create_memowritePost a memo
deputy_update_timesheetwriteUpdate a timesheet
deputy_approve_timesheetwriteApprove a timesheet
deputy_usage_statusmetaUsage status (free-tier meter)
deputy_upgrademetaUpgrade to Pro (unlimited)

read tools are read-only; write tools mutate data (clients should confirm them); meta tools report usage or manage your subscription.

Pricing

PlanPriceLimit
Free$0100 tool calls / month
Pro (per user)$9/mo or $90/yr (2 months free)Unlimited

License

MIT © usefulapi. Not affiliated with or endorsed by Deputy.

Source: servers/deputy/README.md at commit 1ec23c2

Tools

0
Tool metadata has not been indexed yet.

Version history

1
  1. v1.0.0LatestSep 30, 2026