Leave Tracker MCP

Saldos de feriados e licenças: acúmulo, registro de dias de folga, veja quem está ausente e exporte um CSV pronto para RH. Tudo local.

GitHubExperimente este MCPPatrocinado

Documentação

mcp-leave

Servidor MCP para rastreamento de licenças e PTO de funcionários: solicitações, aprovações, saldos, quem está fora e exportação de calendário. Licenças de funcionários e PTO: saldos, aprovações, calendários e resumos de quem está fora.

Funciona com Claude Desktop, Claude Code, Cursor e qualquer cliente do Model Context Protocol. Roda na sua própria máquina ou hospedado, sem instalação.

Página do produto: https://mcp.zovo.one/s/leave — o que faz, as ferramentas que expõe e um endpoint de token ao vivo.

Instalação

Hospedado, nada para instalar. Obtenha um token em https://mcp.zovo.one/mcp/connect (a página de conexão) ou https://mcp.zovo.one/mcp/token (o mesmo token como JSON); um token anônimo gratuito é emitido na hora e uma chave Pro funciona da mesma forma. Em seguida, aponte um cliente MCP para https://mcp.zovo.one/mcp/leave via streamable-http e envie o token como Authorization: Bearer <token>.

Se o seu cliente não puder definir cabeçalhos, coloque o token no caminho: https://mcp.zovo.one/mcp/leave/t/<token>. Ambas as formas funcionam. A URL simples sem token responde 401 em tools/call, então o token não é opcional.

Claude Desktop, um clique. Baixe leave.mcpb da última versão e clique duas vezes nele.

A partir do código-fonte. O espelho é autossuficiente: cada dependência @theluckystrike/* é incluída, então um clone novo compila sem configuração extra.

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

Em seguida, aponte seu cliente para o ponto de entrada compilado:

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

@theluckystrike/mcp-leave ainda não está publicado no npm, então um comando npx -y @theluckystrike/mcp-leave falhará. Os três caminhos acima são os que funcionam e cada um é testado pelo CI.

leave demo

Espelho somente leitura de mcp-servers/servers/leave. Veja MIRROR.md.

theluckystrike/mcp-leave MCP server

No Registro MCP oficial (io.github.theluckystrike/leave). Rastreamento de licenças/PTO de funcionários para solopreneurs e pequenos estúdios: quem está fora, quando e quantos dias cada pessoa tem restantes. Adicione funcionários com uma cota anual e quaisquer dias acumulados, registre solicitações de férias/doença/pessoais (incluindo meio-dias), aprove ou rejeite-as, e leia saldos, conflitos e calendários de quem está fora diretamente do seu cliente MCP — Claude Desktop, Cursor ou qualquer host MCP.

Ferramentas

  • "leave_employee_add" — adiciona um funcionário com annualAllowance (e carriedOver opcional).
  • "leave_request" — registra uma solicitação de licença (employee, type, start, end, halfDay opcional, reason).
  • "leave_approve" / "leave_reject" — decide uma solicitação; as decisões são registradas com datas.
  • "leave_cancel" — cancela uma solicitação pendente ou aprovada (mantém o trilho de auditoria).
  • "leave_balance" — cota, dias acumulados, aprovados, pendentes, comprometidos e restantes por funcionário.
  • "leave_out_range" — quem está fora em um intervalo de datas: linhas de calendário dia a dia mais dias-pessoa.
  • "leave_list" — todos os funcionários e solicitações, filtráveis por funcionário e status.
  • "leave_import" (Pro) — cria solicitações em massa a partir de CSV; linhas conflitantes são rejeitadas uma a uma, linhas válidas ainda são aplicadas.
  • "leave_export_ics" (Pro) — exporta licenças aprovadas como um calendário RFC5545 .ics.

A única regra que decide todo o resto

Um dia é comprometido quando a solicitação que o gasta está aprovada ou pendente. O saldo é allowance + carried − approved − pending. O cancelamento devolve os dias imediatamente; a rejeição nunca os cobrou.

Solicitações sobrepostas para a mesma pessoa são recusadas no momento da criação — tanto pendentes quanto aprovadas contam — então o calendário nunca contém duas solicitações reivindicando o mesmo dia.

Gratuito vs Pro

O nível gratuito é a superfície CRUD completa: funcionários, solicitações, aprovações, saldos, calendários — sem marcas d'água, sem limites de solicitações. Pro (um MCP_LICENSE_KEY, ative com "license_activate") adiciona importação CSV em massa e exportação de calendário ICS. Execute "license_status" para ver o nível atual.

Início rápido

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

Os dados vivem em um único armazenamento JSON (~/.mcp-leave/store.json, ou $XDG_DATA_HOME/mcp-servers/leave/store.json quando definido), gravado atomicamente sob um bloqueio de arquivo, então dois clientes em uma máquina nunca intercalam gravações.

Use estes documentos como um servidor MCP

Qualquer cliente MCP (Claude, Cursor, Windsurf, VS Code) pode ler a documentação deste repositório diretamente via GitMCP — sem instalação: