MCP.Market

Deputy MCP server

by augbastos·io.github.augbastos/deputy-mcp·v0.4.2
No reviews yet

Deputy workforce data for AI agents: rosters, timesheets and shifts; read-only by default

B83/100grade B
Write a reviewInstall
What users say
No reviews yet
Be the first
Safety scan
B83/100

full report

Adoption
Growing

0 stars525 downloads/wk

Reviews

Write one

Nobody has reviewed Deputy MCP yet.

If you have run it, two minutes of your experience saves the next person an afternoon.

Deputy MCP tools (16)

write = sends, deletes, buys or posts

Read from the package source without running it. The installed server may list more.

  • deputy_claim_open_shift

    Assign the signed-in user to an open shift, after the user confirms it.

  • deputy_clock_in

    Clock the signed-in user in, starting a live timesheet.

  • deputy_clock_out

    Clock the signed-in user out, ending their live timesheet.

  • deputy_get_areas

    List areas (operational units / work locations) with their ids.

  • deputy_get_employee_info

    Look up one or more employees by name (substring) or numeric id.

  • deputy_get_my_calendar_url

    Return the signed-in user's personal Deputy calendar (iCal) subscription URL.

  • deputy_get_my_colleagues

    List the people you work with (self-service colleague directory).

  • deputy_get_my_roster

    List the signed-in user's own upcoming shifts in a date range.

  • deputy_get_my_timesheets

    List the signed-in user's own timesheets (actual worked time) in a range.

  • deputy_get_team_roster

    List every scheduled shift in a date range, optionally scoped to one area.

  • deputy_login

    Sign the user in to Deputy with OAuth by opening their browser.

  • deputy_next_shift

    Return the single next upcoming shift for an employee (name or id).

  • deputy_search_shifts

    Search shifts by employee (name or id), area, date range, and open status.

  • deputy_set_unavailability

    Record an unavailability window for the signed-in user.

  • deputy_who_is_working

    Show who is working at an instant: physically clocked in vs scheduled on.

  • deputy_whoami

    Verify the Deputy connection and confirm which identity the token uses.

Public scan report

scanner v0.1.10 · 2026-10-25 · same rubric, same numbers if you re-run it

no findings
  • Code scan32 source files scanned25/25
  • –Live reliabilityno gateway calls yet and no remote to proben/a
  • –Tool poisoningtools not inspected (local package is not executed); not countedn/a
  • Auth qualitystatic API keys via environment variables6/15
  • Maintenancelast push 4 days ago15/15
  • Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10
Overall 83/100. Components that don't apply are left out of the denominator. Any critical finding is an F.RubricAppeal a findingJSON

How Deputy MCP compares

Against every graded MCP server, from our own scans and uptime checks. Updated after each scan run.

Safety score
83/100
higher than 65% of 48,255 servers
Tools
16
the typical server has 7
Tools that change things
0%
typical: 0%. Fewer write tools means less an agent can break
Downloads a week
525
more than 89% of 12,191 servers with a package

What its tools let an agent do: 16 read

Install Deputy MCP in Claude Code, Cursor or VS Code

claude mcp add deputy-mcp -- uvx deputy-mcp
Add to Cursor

What the publisher says

From the Deputy MCP repository's README, as published. We do not edit it. Read it on GitHub

Deputy MCP

<!-- mcp-name: io.github.augbastos/deputy-mcp -->

Ask Claude "when do I work next?" and get the answer from your Deputy roster.

Deputy MCP is a local MCP server that lets AI agents read your shifts, timesheets and team schedule, and, only if you turn it on, act on them. It runs on your machine, connects to Deputy, and works with a regular employee account.

What you can ask

  • "When do I work next?"
  • "How many hours did I work last week?"
  • "Who's on shift right now?" (manager access)
  • "Clock me in." (writes enabled)
  • "Take the open shift on Saturday." (writes enabled; asks you to confirm first)

Install

Needs uv and Python 3.11 or newer. Choose your access mode first:

Employee OAuth

Create a personal app at with the redirect URI http://localhost:8823/callback. Create it there, not under your install's Settings → Developer: an app made inside an install fails sign-in with invalid_client. In Bash, replace the placeholders, sign in, then register the server with Claude Code:

export DEPUTY_OAUTH_CLIENT_ID='your-client-id'
export DEPUTY_OAUTH_CLIENT_SECRET='your-client-secret'
uvx deputy-mcp login
claude mcp add deputy \
  -e DEPUTY_OAUTH_CLIENT_ID="$DEPUTY_OAUTH_CLIENT_ID" \
  -e DEPUTY_OAUTH_CLIENT_SECRET="$DEPUTY_OAUTH_CLIENT_SECRET" \
  -- uvx deputy-mcp

Login opens your browser and stores OAuth tokens in your OS keychain by default. Run login and Claude Code as the same OS user. No terminal (for example, the Claude Desktop bundle)? Set the two OAuth values and ask the assistant to sign you in: the deputy_login tool opens the same browser sign-in.

Admin API token

With your Deputy API token and install URL, register directly; no OAuth login is needed:

claude mcp add deputy \
  -e DEPUTY_API_TOKEN=your-deputy-token \
  -e DEPUTY_BASE_URL=https://your-company.eu.deputy.com \
  -- uvx deputy-mcp

Codex CLI

For your own roster, replace ... with your private calendar feed URL:

codex mcp add deputy --env DEPUTY_CALENDAR_URL=... -- uvx deputy-mcp

The first uvx run downloads dependencies; if Codex reports the tools as unavailable, set startuptimeoutsec = 60 under [mcp_servers.deputy] in ~/.codex/config.toml.

Claude Desktop users: download the .mcpb bundle from the Releases page and drag it onto Settings → Extensions (double-clicking may not open it on Windows). Fill in one access mode under Configure, then ask Claude to sign you in. Other MCP clients and Docker: see other ways to install. All settings are listed in .env.example.

Tools

Shortened. The full README is on GitHub.

Nothing above is checked by us. What we check is on the safety report.

Deputy MCP: common questions

Is Deputy MCP server safe?
Mostly: it is graded B (83/100). Read the Deputy MCP safety report
How do I install Deputy MCP?
It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
Does Deputy MCP need an API key?
Yes. The registry entry asks for DEPUTY_API_TOKEN, DEPUTY_OAUTH_CLIENT_SECRET, DEPUTY_CALENDAR_URL.
Is Deputy MCP maintained?
The last commit was 14 days ago (2026-10-21). The latest release is v0.4.2.
How does Deputy MCP compare with other MCP servers?
safety score 83/100 (higher than 65% of 48,255 servers); tools 16 (the typical server has 7); tools that change things 0% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.