Deputy MCP

Name: Deputy MCP
Author: augbastos

de augbastosversión 0.4.2i★ –iSe ejecuta en tu computadora

Nombre en el registroio.github.augbastos/deputy-mcp

Instalar

Resumen

Descripción del creador (original en inglés)

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

Los tres pilares de PopNx MCP

Estos tres nunca se combinan en una sola puntuación: las opiniones, las mediciones y la popularidad son cosas distintas.

Opinión de usuariosiAún no hay reseñasLas reseñas se abrirán junto con las cuentas en una etapa posterior
Nuestras revisiones básicasi1 de 1 superadasRevisado con información pública; el código aún no se ha escaneado
UsoiMuy nuevo↓ 54/sem · ★ –

Qué puedes hacer con él

Todavía no escribimos un resumen sencillo para este. Abajo están los datos que leímos del registro.

Conexión: Se ejecuta en tu computadora
Transporte: stdio
Categoría: Otros
Debes completar: DEPUTY_API_TOKEN, DEPUTY_OAUTH_CLIENT_SECRET, DEPUTY_CALENDAR_URL

Instalación

Elige la app de IA que usas y copia la configuración.

Antes de instalar

Revisiones básicas: 1 de 1 superadas
Se ejecuta en tu computadora con los permisos de tu usuario (archivos, red, apps).
Debes completar tú: DEPUTY_API_TOKEN, DEPUTY_BASE_URL, DEPUTY_OAUTH_CLIENT_ID, DEPUTY_OAUTH_CLIENT_SECRET, DEPUTY_CALENDAR_URL, DEPUTY_ALLOW_WRITES, DEPUTY_TOKEN_STORE

Los valores marcados como secretos son llaves de tu cuenta. Nunca los compartas ni los pegues en un chat.

Necesitas

PyPIuv de Python instalado (para el comando uvx)

¿Qué app usas?

ClaudeClaude CodeCursorVS CodeChatGPT

Elige tu app arriba. La recordamos, así que la próxima vez el botón dirá “Instalar en …”.

Abre Claude Desktop → Settings → Developer → Edit Config y pega esto en 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"
      }
    }
  }
}

Ejecuta esto en tu 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

Completa los valores vacíos antes de ejecutarlo.

Abrir en Cursor

O copia la configuración tú

Pégalo en .cursor/mcp.json de tu proyecto, o en ~/.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"
      }
    }
  }
}

Tu navegador te pide permiso para abrir la app; luego la app muestra la configuración y te pide confirmar. Los valores de las claves quedan vacíos para que los completes tú.

Abrir en VS Code

O copia la configuración tú

Pégalo en .vscode/mcp.json de tu proyecto

{
  "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"
      }
    }
  }
}

Tu navegador te pide permiso para abrir la app; luego la app muestra la configuración y te pide confirmar. Los valores de las claves quedan vacíos para que los completes tú.

Este se ejecuta en tu computadora, y ChatGPT solo puede conectarse a servidores en internet. Elige otra app.

Tu elección se guarda en una cookie en este dispositivo; no necesitas cuenta.

Valores que debes completar

DEPUTY_API_TOKEN secreto 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 secreto env
OAuth mode: client secret of the same app.
DEPUTY_CALENDAR_URL secreto 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.

Esta configuración se genera a partir de la ficha del creador en el registro. Si el README dice otra cosa, sigue el README.

Qué puede hacer

Se ejecuta en tu computadora; la lista de herramientas aparece en tu app de IA después de instalarlo.

Revisiones básicasi

Revisamos información que cualquiera puede ver; no hemos leído el código. Las revisiones que no aplican no se cuentan. · Revisado el 8 nov 2026

✓ Superada
El creador coincide con el repo
El nombre en el registro se verificó con la cuenta de GitHub augbastos, dueña del repo
… Aún sin revisar
Sigue en mantenimiento
Todavía no hemos leído este repo en GitHub
… Aún sin revisar
Tiene licencia
Todavía no hemos leído este repo en GitHub
– No aplica
El endpoint responde
Este se ejecuta en tu computadora; no hay endpoint en internet
– No aplica
Inicio de sesión con OAuth
Se ejecuta en tu computadora y usa ajustes locales en su lugar
… Aún sin revisar
Sin instrucciones ocultas en las descripciones de herramientas
Se ejecuta en tu computadora; solo podemos leer listas de herramientas de endpoints en internet

Comparado con otros en Otrosi

Más estrellas que el 0% de los otros 18477 servidores de esta categoría
Publicado en el registro más recientemente que el 71% de los otros 18477 servidores de esta categoría
Revisiones básicas iguales o mejores que el 100% de los otros 18477 servidores de esta categoría

Comparado con todos los servidores activos de esta categoría en el registro. Las estrellas solo cuentan cuando quien lo publica es dueño del repo.

Preguntas frecuentes

¿Es seguro Deputy MCP?

Superó 1 de 1 revisiones básicas aplicables. No hemos leído el código. Antes de agregar una clave o un token, revisa qué acceso pide el servidor y usa una clave que tenga solo los permisos que necesitas.

¿Qué claves o códigos necesita?

Debes completar: DEPUTY_API_TOKEN, DEPUTY_OAUTH_CLIENT_SECRET, DEPUTY_CALENDAR_URL

¿Se ejecuta en mi computadora o en la nube?

Se ejecuta en tu computadora. Tu app de IA lo inicia cuando hace falta, y los datos no pasan por los servidores del creador (a menos que el propio servidor llame a un servicio en línea).

¿Sigue en mantenimiento?

El repo de GitHub cambió por última vez –, y la última versión (0.4.2) llegó al registro hace 17 días.

¿Qué apps pueden usarlo?

Las apps compatibles con MCP, como Claude Desktop, Claude Code, Cursor y VS Code. También necesitas Python (uv) en tu computadora.

¿Qué puedo usar en su lugar?

En la misma categoría: Spec Driven Development, Remote Desktop Commander, Readfirst

Alternativas

Servidores de la misma categoría hechos por otros creadores, ordenados por estrellas.

Cómo leer una tarjeta:↓ Descargas por semanai★ Estrellas de GitHubiTres pilares: reseñas · revisiones · usoiActualizado = fecha en que se publicó la última versión en el registroi

Spec Driven Development

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

de formulahendryInicial↓ 66/sem★ 440Actualizado hace 14 meses

Se ejecuta en tu computadora

Instalar

Remote Desktop Commander

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

de desktop-commanderEn crecimiento★ 211Actualizado hace 3 días

Se ejecuta en la nube✓ desktopcommander.app

Instalar

Readfirst

What to read and check before changing a file: project rules, risks, checks and tests per file.

de jeonghun917En crecimiento↓ 5,3 mil/semActualizado hoy

Se ejecuta en tu computadora

Instalar

README del creador

Abrir el README

Copiado tal cual del repo del creador. PopNx MCP no lo ha revisado ni lo respalda. Se quitaron HTML, imágenes y scripts. Los enlaces llevan fuera de este sitio.

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

Resumen

Los tres pilares de PopNx MCP

Qué puedes hacer con él

Instalación

Antes de instalar

Valores que debes completar

Qué puede hacer

Revisiones básicasi

El creador coincide con el repo

Sigue en mantenimiento

Tiene licencia

El endpoint responde

Inicio de sesión con OAuth

Sin instrucciones ocultas en las descripciones de herramientas

Comparado con otros en Otrosi

Preguntas frecuentes

Alternativas

Spec Driven Development

Remote Desktop Commander

Readfirst

README del creador

Deputy MCP

What you can ask

Install

Employee OAuth

Admin API token

Codex CLI

Tools

Safe by default

Status

More

License