leave-management
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
Leave Management MCP Server
An MCP (Model Context Protocol) server for employee leave management, built with FastMCP and Python.
Features
Check leave balance — query remaining leave days for an employee
Apply for leave — submit leave requests for specific dates
View leave history — retrieve past leave records
Greeting resource — personalized greeting endpoint
Related MCP server: HR Leave Management MCP Server
Prerequisites
uv — fast Python package manager
Claude Desktop (to use the server with Claude)
Environment Setup
1. Install uv
curl -LsSf https://astral.sh/uv/install.sh | shVerify the installation:
uv --version2. Clone the repository
git clone <your-repo-url>
cd mcp1_leave_management3. Install Python 3.14
uv will read the .python-version file and auto-install the correct Python version:
uv python install4. Create a virtual environment
uv venv5. Activate the virtual environment
# macOS / Linux
source .venv/bin/activate
# Windows
.venv\Scripts\activate6. Install the mcp dependency
uv add mcp7. Verify the installation
python -c "from mcp.server.fastmcp import FastMCP; print('MCP installed successfully')"Running the Server
Standalone (for testing)
python main.pyWith MCP Inspector (interactive testing)
npx @modelcontextprotocol/inspector python main.pyThen open http://localhost:5173 in your browser to interact with the tools.
Connecting to Claude Desktop
1. Find your Claude Desktop config file
OS | Path |
macOS |
|
Windows |
|
2. Add the server configuration
Open the config file and add an entry under mcpServers:
{
"mcpServers": {
"leave-management": {
"command": "uv",
"args": [
"run",
"--directory",
"/absolute/path/to/mcp1_leave_management",
"python",
"main.py"
]
}
}
}Replace /absolute/path/to/mcp1_leave_management with the actual path on your machine.
3. Restart Claude Desktop
Quit and relaunch Claude Desktop. The leave management tools will appear in the tool panel.
Available Tools
Tool | Description | Parameters |
| Returns remaining leave days |
|
| Applies leave for given dates |
|
| Returns past leave dates |
|
Example usage (in Claude)
Check leave balance for employee E001
Apply leave for E002 on 2025-06-10 and 2025-06-11
Show leave history for E001Mock Data
The server starts with two pre-seeded employees:
Employee ID | Initial Balance | Pre-existing Leaves |
E001 | 18 days | 2024-12-25, 2025-01-01 |
E002 | 20 days | None |
Data is held in memory and resets each time the server restarts.
Project Structure
mcp1_leave_management/
├── main.py # MCP server and tool definitions
├── pyproject.toml # Project metadata and dependencies
├── uv.lock # Locked dependency versions
├── .python-version # Pinned Python version (3.14)
└── README.mdTerminal setup steps from zero
uv venv --python 3.14 .venv
source .venv/bin/activate
which python
python --version
uv pip install mcp
uv
uv init
uv pip show mcp
uv run mcp install main.pyTool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Employee leave and PTO: requests, approvals, balances, who is out, and conflict checks.
Ask Claude or ChatGPT about your team in PapaHR: who is away, hiring, probation, eNPS, HR costs.
Track and manage employee time off with quick balance lookups and streamlined applications. Find t…
CharlieHR MCP server for ChatGPT, Claude and any AI agent: list team members, list time off requests, approve time off request, deny time off request, book time off, record sick day, adjust time off allowance and cancel time off booking in your own CharlieHR account. Cotlet works in the account through your Cloud Browser, a real Chrome where you sign in to CharlieHR yourself; Cotlet does not store your password and you need no CharlieHR API key. About the official CharlieHR API: CharlieHR has an API, but a narrow one, and no official MCP server (checked 20 Oct 2026). A Super Admin creates a Client ID and Client Secret under Company > Integrations > API Access; the API covers team members, leave, offices and teams. Setup and FAQ: https://cotlet.dev/integrations/charliehr-api-mcp-server
Related MCP Servers
- AlicenseCqualityDmaintenanceAutomates HR workflows such as employee onboarding, leave management, and ticket tracking through natural language prompts in Claude Desktop.12MIT
- FlicenseBqualityDmaintenanceEnables managing employee leave requests (apply, view, list leaves) through Claude desktop using natural language.6-
- FlicenseNot gradedqualityDmaintenanceEnables managing employee leave requests, balances, and approvals through natural language with Claude Desktop, using SQLite for persistence and fuzzy name matching.-
- AlicenseAqualityDmaintenanceManages employee leave with Claude Desktop via natural language. Enables checking balances, applying, approving, and reviewing leave requests through a Supabase-backed MCP server.10MIT