Deputy MCP

Name: Deputy MCP
Author: augbastos

by augbastosversion 0.4.2i★ –iRuns on your computer

Registry nameio.github.augbastos/deputy-mcp

Install

Overview

Description from the maker (original English)

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

PopNx MCP’s three pillars

These three are never merged into one score: opinions, measurements and popularity are different things.

User voiceiNo reviews yetReviews open together with accounts in a later step
Our basic checksi1 of 1 passedChecked from public information; code not scanned yet
UsageiVery new↓ 54/wk · ★ –

What you can do with it

We have not written a plain-language summary for this one yet. Below are the facts we read from the registry.

Connection: Runs on your computer
Transport: stdio
Category: Other
You need to fill in: DEPUTY_API_TOKEN, DEPUTY_OAUTH_CLIENT_SECRET, DEPUTY_CALENDAR_URL

Install

Pick the AI app you use, then copy the settings.

Before you install

Basic checks: 1 of 1 passed
Runs on your computer with your user’s permissions (files, network, apps).
You fill in yourself: DEPUTY_API_TOKEN, DEPUTY_BASE_URL, DEPUTY_OAUTH_CLIENT_ID, DEPUTY_OAUTH_CLIENT_SECRET, DEPUTY_CALENDAR_URL, DEPUTY_ALLOW_WRITES, DEPUTY_TOKEN_STORE

Values marked secret are keys to your account. Never share them or paste them into a chat.

You need

PyPIPython’s uv installed (for the uvx command)

Which app do you use?

ClaudeClaude CodeCursorVS CodeChatGPT

Pick your app above. We remember it, so next time the button says “Install in …”.

Open Claude Desktop → Settings → Developer → Edit Config, and paste this into claude_desktop_config.json

{
  "mcpServers": {
    "deputy": {
      "command": "uvx",
      "args": [
        "deputy-mcp"
      ],
      "env": {
        "DEPUTY_API_TOKEN": "your-value",
        "DEPUTY_BASE_URL": "your-value",
        "DEPUTY_OAUTH_CLIENT_ID": "your-value",
        "DEPUTY_OAUTH_CLIENT_SECRET": "your-value",
        "DEPUTY_CALENDAR_URL": "your-value",
        "DEPUTY_ALLOW_WRITES": "your-value",
        "DEPUTY_TOKEN_STORE": "your-value"
      }
    }
  }
}

Run this in your terminal

claude mcp add deputy --env DEPUTY_API_TOKEN=your-value --env DEPUTY_BASE_URL=your-value --env DEPUTY_OAUTH_CLIENT_ID=your-value --env DEPUTY_OAUTH_CLIENT_SECRET=your-value --env DEPUTY_CALENDAR_URL=your-value --env DEPUTY_ALLOW_WRITES=your-value --env DEPUTY_TOKEN_STORE=your-value -- uvx deputy-mcp

Fill in the empty values before running it.

Open in Cursor

Or copy the settings yourself

Paste into .cursor/mcp.json in your project, or ~/.cursor/mcp.json

{
  "mcpServers": {
    "deputy": {
      "command": "uvx",
      "args": [
        "deputy-mcp"
      ],
      "env": {
        "DEPUTY_API_TOKEN": "your-value",
        "DEPUTY_BASE_URL": "your-value",
        "DEPUTY_OAUTH_CLIENT_ID": "your-value",
        "DEPUTY_OAUTH_CLIENT_SECRET": "your-value",
        "DEPUTY_CALENDAR_URL": "your-value",
        "DEPUTY_ALLOW_WRITES": "your-value",
        "DEPUTY_TOKEN_STORE": "your-value"
      }
    }
  }
}

Your browser asks to open the app, then the app shows the settings and asks you to confirm. Key values are left empty for you to fill in.

Open in VS Code

Or copy the settings yourself

Paste into .vscode/mcp.json in your project

{
  "servers": {
    "deputy": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "deputy-mcp"
      ],
      "env": {
        "DEPUTY_API_TOKEN": "your-value",
        "DEPUTY_BASE_URL": "your-value",
        "DEPUTY_OAUTH_CLIENT_ID": "your-value",
        "DEPUTY_OAUTH_CLIENT_SECRET": "your-value",
        "DEPUTY_CALENDAR_URL": "your-value",
        "DEPUTY_ALLOW_WRITES": "your-value",
        "DEPUTY_TOKEN_STORE": "your-value"
      }
    }
  }
}

Your browser asks to open the app, then the app shows the settings and asks you to confirm. Key values are left empty for you to fill in.

This one runs on your computer, and ChatGPT can only connect to servers on the internet. Pick another app.

Your choice stays on this device in a cookie; no account needed.

Values you fill in

DEPUTY_API_TOKEN secret env
API token mode (all tools): a Deputy API token, created with an admin access level. Pair with DEPUTY_BASE_URL. Configure exactly one of the three authentication modes: API token, OAuth, or iCal feed.
DEPUTY_BASE_URL env
API token mode: your Deputy install origin, e.g. https://your-company.eu.deputy.com.
DEPUTY_OAUTH_CLIENT_ID env
OAuth mode (all tools, no admin needed): client id of a personal app registered at https://once.deputy.com/my/oauth_clients with redirect URI http://localhost:8823/callback. Run 'deputy-mcp login' on…
DEPUTY_OAUTH_CLIENT_SECRET secret env
OAuth mode: client secret of the same app.
DEPUTY_CALENDAR_URL secret env
iCal feed mode (your own roster only, read-only): your personal Deputy calendar link. It contains a private token.
DEPUTY_ALLOW_WRITES env
Set to true to register the write tools (API token and OAuth modes). Read-only by default.
DEPUTY_TOKEN_STORE env
OAuth mode: file path for a plaintext token store, only where no OS keychain is available. Default: the OS keychain.

These settings are generated from the maker’s registry entry. If the README says otherwise, follow the README.

What it can do

Runs on your computer; the tool list appears in your AI app after you install it.

Basic checksi

We check information anyone can see; we have not read the code. Checks that do not apply are left out of the count. · Checked Nov 9, 2026

✓ Pass
Maker matches the repo
The registry name was verified with the GitHub account augbastos, which owns the repo
… Not checked yet
Still maintained
We have not read this repo from GitHub yet
… Not checked yet
Has a licence
We have not read this repo from GitHub yet
– Not applicable
Endpoint responds
This one runs on your computer; there is no internet endpoint
– Not applicable
Sign-in with OAuth
Runs on your computer and uses local settings instead
… Not checked yet
No hidden instructions in tool descriptions
Runs on your computer; we can only read tool lists from internet endpoints

Compared with others in Otheri

More stars than 0% of the other 18721 servers in this category
Published to the registry more recently than 70% of the other 18721 servers in this category
Basic checks equal to or better than 100% of the other 18721 servers in this category

Compared with every active server in this category in the registry. Stars count only when the publisher owns the repo.

Common questions

Is Deputy MCP safe?

It passed 1 of 1 applicable basic checks. We have not read the code. Before adding a key or token, see what access the server asks for and use a key with only the permissions you need.

What keys or codes does it need?

You need to fill in: DEPUTY_API_TOKEN, DEPUTY_OAUTH_CLIENT_SECRET, DEPUTY_CALENDAR_URL

Does it run on my computer or in the cloud?

It runs on your computer. Your AI app starts it when needed, and data does not pass through the maker’s servers (unless it calls an online service itself).

Is it still maintained?

The GitHub repo last changed –, and the latest version (0.4.2) reached the registry 18 days ago.

Which apps can use it?

Apps that support MCP, such as Claude Desktop, Claude Code, Cursor and VS Code. You also need Python (uv) on your computer.

What can I use instead?

In the same category: Spec Driven Development, Remote Desktop Commander, Soleil Clusters

Alternatives

Servers in the same category from other makers, sorted by stars.

Reading a card:↓ Downloads per weeki★ GitHub starsiThree pillars: reviews · checks · usageiUpdated = latest version published to the registryi

Spec Driven Development

MCP Server that facilitates spec-driven development workflows, not just Vibe Coding.

by formulahendryEarly↓ 66/wk★ 440Updated 14 months ago

Runs on your computer

Install

Remote Desktop Commander

Remote Desktop Commander: use files, terminal and processes on your own computers from any AI app.

by desktop-commanderGrowing★ 211Updated 4 days ago

Runs in the cloud✓ desktopcommander.app

Install

Soleil Clusters

Read and build visual moodboards, shot lists and lookbooks from an AI assistant.

by arconkliEarly↓ 119/wkUpdated today

Computer or cloud✓ soleilpictures.com

Install

README from the maker

Open the README

Copied from the maker’s repo as written. PopNx MCP has not reviewed or endorsed it. HTML, images and scripts are removed. Links lead off this site.

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:

Mode	Who it's for	Start here
OAuth	Any employee	Employee sign-in
API token	Deputy admins	Admin setup
Calendar feed	No API access	Set `DEPUTY_CALENDAR_URL` using the client setup; your own roster only, read-only

Employee OAuth

Create a personal app at https://once.deputy.com/my/oauth_clients 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 startup_timeout_sec = 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

Your data (any account): deputy_whoami, deputy_get_my_roster, deputy_next_shift, deputy_get_my_timesheets, deputy_get_my_colleagues, deputy_get_my_calendar_url, deputy_get_areas
Team (manager access): deputy_get_team_roster, deputy_who_is_working, deputy_get_employee_info, deputy_search_shifts
Actions (only with DEPUTY_ALLOW_WRITES=true): deputy_clock_in, deputy_clock_out, deputy_set_unavailability, deputy_claim_open_shift

Safe by default

Read-only unless you set DEPUTY_ALLOW_WRITES=true; until then the action tools don't exist for the agent.
You confirm before a shift is claimed, since that skips Deputy's approval step.
No guessing: if a name matches several people, you get the list, not the first one.
Credential protection: by default, tokens go only to https://*.deputy.com and OAuth tokens live in your OS keychain; errors are scrubbed of secrets before an agent sees them.

Status

The everyday read tools and OAuth sign-in were tested against a real Deputy install with an employee account. Manager tools, actions and the OAuth token refresh are covered by automated tests but not yet verified on a live install. Not affiliated with Deputy.

How it's built and why
Contributing · Security · Changelog · Roadmap

License

MIT

Deputy MCP

Overview

PopNx MCP’s three pillars

What you can do with it

Install

Before you install

Values you fill in

What it can do

Basic checksi

Maker matches the repo

Still maintained

Has a licence

Endpoint responds

Sign-in with OAuth

No hidden instructions in tool descriptions

Compared with others in Otheri

Common questions

Alternatives

Spec Driven Development

Remote Desktop Commander

Soleil Clusters

README from the maker

Deputy MCP

What you can ask

Install

Employee OAuth

Admin API token

Codex CLI

Tools

Safe by default

Status

More

License