Leave Tracker MCP

mcp-leave

Servidor MCP para un rastreador de permisos y PTO de personal: solicitudes, aprobaciones, saldos, quién está fuera y una exportación de calendario. Permisos de empleados y PTO: saldos, aprobaciones, calendarios y resúmenes de quién está fuera.

Funciona con Claude Desktop, Claude Code, Cursor y cualquier cliente del Model Context Protocol. Se ejecuta en tu propia máquina, o alojado sin instalación.

Página del producto: https://mcp.zovo.one/s/leave — qué hace, las herramientas que expone y un endpoint de token en vivo.

Instalación

Alojado, nada que instalar. Obtén un token de https://mcp.zovo.one/mcp/connect (la página de conexión) o https://mcp.zovo.one/mcp/token (el mismo token como JSON); se emite uno anónimo gratuito al instante y una clave Pro funciona de la misma manera. Luego apunta un cliente MCP a https://mcp.zovo.one/mcp/leave a través de streamable-http y envía el token como Authorization: Bearer <token>.

Si tu cliente no puede configurar encabezados, coloca el token en la ruta en su lugar: https://mcp.zovo.one/mcp/leave/t/<token>. Ambas formas funcionan. La URL desnuda sin token responde 401 en tools/call, por lo que el token no es opcional.

Claude Desktop, un clic. Descarga leave.mcpb desde la última versión y haz doble clic en él.

Desde el código fuente. El espejo es autónomo: cada dependencia de @theluckystrike/* está incluida, por lo que un clon nuevo se compila sin configuración adicional.

git clone https://github.com/theluckystrike/mcp-leave.git
cd mcp-leave
npm install && npm run build

Luego apunta tu cliente al punto de entrada compilado:

{
  "mcpServers": {
    "leave": {
      "command": "node",
      "args": ["/absolute/path/to/mcp-leave/dist/index.js"]
    }
  }
}

@theluckystrike/mcp-leave aún no está publicado en npm, por lo que un comando npx -y @theluckystrike/mcp-leave fallará. Las tres rutas anteriores son las que funcionan y cada una es probada por CI.

Espejo de solo lectura de mcp-servers/servers/leave. Consulta MIRROR.md.

En el Registro oficial de MCP (io.github.theluckystrike/leave). Seguimiento de permisos/PTO de empleados para solopreneurs y pequeños estudios: quién está fuera, cuándo y cuántos días le quedan a cada persona. Agrega empleados con una asignación anual y cualquier día transferido, registra solicitudes de vacaciones/enfermedad/personales (incluidos medios días), apruébalas o recházalas, y lee saldos, conflictos y calendarios de quién está fuera directamente desde tu cliente MCP — Claude Desktop, Cursor o cualquier host MCP.

Herramientas

• "leave_employee_add" — agrega un empleado con annualAllowance (y carriedOver opcional).
• "leave_request" — registra una solicitud de permiso (employee, type, start, end, halfDay opcional, reason).
• "leave_approve" / "leave_reject" — decide una solicitud; las decisiones se registran con fechas.
• "leave_cancel" — cancela una solicitud pendiente o aprobada (conserva el registro de auditoría).
• "leave_balance" — asignación, transferidos, aprobados, pendientes, comprometidos y días restantes por empleado.
• "leave_out_range" — quién está fuera en un rango de fechas: filas de calendario día a día más días-persona.
• "leave_list" — todos los empleados y solicitudes, filtrables por empleado y estado.
• "leave_import" (Pro) — crea solicitudes en masa desde CSV; las filas conflictivas se rechazan una por una, las filas válidas aún se aplican.
• "leave_export_ics" (Pro) — exporta permisos aprobados como un calendario RFC5545 .ics.

La única regla que decide todo lo demás

Un día está comprometido cuando la solicitud que lo gasta está aprobada o pendiente. El saldo es allowance + carried − approved − pending. Cancelar devuelve los días inmediatamente; rechazar nunca los cargó.

Las solicitudes superpuestas para la misma persona se rechazan en el momento de la creación — tanto pendientes como aprobadas cuentan — por lo que el calendario nunca contiene dos solicitudes que reclamen el mismo día.

Gratis vs Pro

El nivel gratuito es la superficie completa de CRUD: empleados, solicitudes, aprobaciones, saldos, calendarios — sin marcas de agua, sin límites de solicitudes. Pro (una MCP_LICENSE_KEY, actívala con "license_activate") agrega importación CSV en masa y exportación de calendario ICS. Ejecuta "license_status" para ver el nivel actual.

Inicio rápido

{
  "mcpServers": {
    "leave": { "command": "npx", "args": ["-y", "@theluckystrike/mcp-leave"] }
  }
}

Los datos viven en un único almacén JSON (~/.mcp-leave/store.json, o $XDG_DATA_HOME/mcp-servers/leave/store.json cuando está configurado), escrito atómicamente bajo un bloqueo de archivo, por lo que dos clientes en una máquina nunca intercalan escrituras.

Usa estos documentos como un servidor MCP

Cualquier cliente MCP (Claude, Cursor, Windsurf, VS Code) puede leer la documentación de este repositorio directamente a través de GitMCP — sin instalación:

• URL de Docs MCP: https://gitmcp.io/theluckystrike/mcp-leave