Leave Management MCP Server

@ItsMistahJi

Repository

Basic information

About Leave Management MCP Server

This is my attempt at creating a leave management mcp server to retrieve details of employees stored in a workbook.

#leave-management #mcp#employee-management

Leave Management MCP Server config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "itsmistahji-leave-management-mcp": {
      "command": "uv",
      "args": [
        "init",
        "."
      ]
    }
  }
}

Leave Management MCP Server tools

Tool list not available yet

This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is Leave Management MCP Server?

The Leave Management MCP Server is a Model Context Protocol server for managing employee leave within an organization. It integrates with Excel workbooks containing employee leave data and provides tools for querying and analyzing leave records, designed for use with MCP clients like Claude Desktop.

How to use Leave Management MCP Server?

Install dependences via UV, configure a .env file pointing to your Excel workbook, then run the server locally with uv run python -m src.leave_server or install it into an MCP client using uv run mcp install src/leave_server.py --name "Leave Management". For VS Code, add the provided JSON configuration to your settings.

Key features of Leave Management MCP Server

Integrates with Excel workbooks for leave data storage
Enables natural-language queries about employee leave
Supports queries by employee name, ID, month, or date
Built with Python and uses Pandas for data processing
Can be run locally or installed in MCP clients

Use cases of Leave Management MCP Server

Ask who is on leave today and get instant answers
Check leave balance for a specific employee by ID
List all employees on leave in a given month
Retrieve leave details for a named employee
Query when a particular employee took leave in a specific period

Frequently asked questions

What does the server do?

It reads an Excel workbook containing employee leave records and exposes MCP tools that allow an AI assistant (e.g., Claude) to answer questions about leave status, balances, and history.

What are the prerequisites?

Python 3.9+, the UV package manager, an MCP client (e.g., Claude Desktop), and an Excel workbook with leave data structured with columns for employee details and monthly leave marks.

Where is the leave data stored?

The data lives in an Excel workbook (e.g., `leave_tracker.xlsx`) located in a directory specified by the `DATA_DIR` environment variable. The server expects a sheet named "Leaves-2025" with specific columns.

How do I handle "No module named 'src'" errors?

Ensure `__init__.py` files exist in `src/` and `src/models/`, add a sys.path modification, or use the provided `main.py` wrapper in the root directory.

How do I resolve "No module named 'pandas'" errors?

Install all dependencies in the same environment using `uv add pandas openpyxl python-dotenv PyPDF2` or use the `--with` flag when running the server.

Comments

More Other MCP servers

Maestro

mobile-dev-inc

Painless E2E Automation for Mobile and Web

14.8K

Screenpipe

screenpipe

YC (S26) | Open Computer History | Continuously record your company computer work, map your workflows, help you find work worth automating, and power your agents' context

22.0K

Senso MCP for Joomla

sensomedia

Senso MCP turns a Joomla 5 or 6 site into a remote MCP server. It runs inside Joomla itself (no extra server, no Node.js bridge) and is secured with OAuth 2.1 and Joomla's own ACL. The free pack lets an AI assistant crea

MCP Toolbox for Databases

googleapis

MCP Toolbox for Databases is an open source MCP server for databases.

15.9K

FastMCP v2 🚀

jlowin

🚀 The fast, Pythonic way to build MCP servers and clients.

26.0K