employee-leave-management-mcp
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@employee-leave-management-mcp Add employee E001, Alice Johnson"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Leave Management MCP Server
This project provides a simple MCP server for an employee leave-management system built with UV and Python.
Features
Add employees
List all employees
Add leave entries for an employee
List leave entries for an employee
Delete leave entries
Startup and tool logging for troubleshooting
Related MCP server: leave-manager-mcp-server
Project structure
src/leave_management_mcp/server.py– MCP tool definitions and in-memory leave data storesrc/leave_management_mcp/__init__.py– package exports and entry pointtests/test_leave_management.py– regression tests for the core behaviorleave_management_mcp.log– runtime log file generated by the server
Run locally
From the project root:
cd C:\Users\VIJAY\Codebase\mcp\leave-management
uv run leave-management-mcpThe server uses stdio transport, which is the recommended transport for Claude Desktop.
Claude Desktop config
Create or edit this file:
%APPDATA%\Claude\claude_desktop_config.jsonUse this exact config:
{
"mcpServers": {
"leave-management": {
"command": "C:\\Users\\VIJAY\\AppData\\Local\\Programs\\Python\\Python314\\Scripts\\uv.exe",
"args": [
"--directory",
"C:\\Users\\VIJAY\\Codebase\\mcp\\leave-management",
"run",
"leave-management-mcp"
]
}
}
}Important:
The earlier path
C:\Users\VIJAY\.local\bin\uv.exewas invalid on this machine.The actual installed UV path is under the Python Scripts folder.
Restart Claude Desktop after saving the file.
Example prompts in Claude
"Add employee E001, Alice Johnson"
"List all employees"
"Add leave for E001 from 2026-08-20 to 2026-08-22 as annual"
"Show leave records for E001"
"Delete leave for E001 from 2026-08-20 to 2026-08-22"
Logging
The server writes logs to:
stderr for immediate output
leave_management_mcp.login the project root for persisted troubleshooting
This helps confirm whether the MCP server is starting correctly when Claude Desktop launches it.
Validation
Run the test suite:
cd C:\Users\VIJAY\Codebase\mcp\leave-management
uv run pytest -qVerified result:
2 passed in 2.85sThe project passes the current regression tests and the server launch path has been verified.
Available Tools
5 toolsadd_employeeB
Add a new employee to the leave management system.
Inputs: name (required), employee_id (required). Returns: result
add_leaveC
Add a leave record for an employee.
Inputs: end_date (required), leave_type (required), start_date (required), employee_id (required). Returns: result
delete_leaveC
Delete a leave record for an employee.
Inputs: end_date (required), start_date (required), employee_id (required). Returns: result
list_employeesA
List all employees in the system.
Inputs: no named parameters. Returns: result
list_leaves_for_employeeA
List all leave entries for a single employee.
Inputs: employee_id (required). Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 5 tools
Each tool targets a distinct resource and action: employee creation/listing versus leave creation/listing/deletion. No two tools appear to do the same thing.
All tool names follow a consistent verb_noun snake_case pattern (add_, list_, delete_). The slightly longer list_leaves_for_employee still fits the convention clearly.
Five tools is well-scoped for a focused employee leave management server. Each tool covers a meaningful core operation without unnecessary bloat.
The tool set covers basic employee creation/listing and leave creation/listing/deletion, but lacks employee update/delete and leave update operations. Agents can manage core workflows but will hit dead ends for modifications.
Maintenance
Related MCP Connectors
Employee leave and PTO: requests, approvals, balances, who is out, and conflict checks.
Track and manage employee time off with quick balance lookups and streamlined applications. Find t…
Read employees, leave, recruiting and reports; book or decide leave and add applicant notes.
Read Breathe HR employees, absences, sickness and leave; create and review leave requests.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceEnables managing employee leave requests, balances, and approvals through natural language with Claude Desktop, using SQLite for persistence and fuzzy name matching.-
- FlicenseBqualityDmaintenanceEnables LLMs to manage employee leave by checking balances, applying for leave, and viewing history.3-
- FlicenseAqualityDmaintenanceExposes employee leave-management operations (add employees, check balance, apply/cancel leave, view history) as MCP tools for AI clients like Claude Desktop to call directly.6-
- FlicenseBqualityDmaintenanceEnables managing employee leave requests including checking balance, applying for leave, and viewing history.3-