🏢 Atliq HRMS Assist — MCP Server

An AI-powered Human Resource Management System (HRMS) built as a Model Context Protocol (MCP) server. It connects directly to Claude Desktop, allowing you to manage employees, leaves, meetings, tickets, and emails using natural language.

📋 Table of Contents

• Overview

• Features

• Project Structure

• Prerequisites

• Installation

• Configuration

• Running the MCP Server

• Connecting to Claude Desktop

• Available Tools

• Available Prompts

• Usage Examples

Related MCP server: HRizzle-HR-Assist

🌟 Overview

Atliq HRMS Assist is an MCP server that exposes HR management capabilities as tools and prompts for AI assistants. Built with FastMCP and Pydantic, it enables Claude to perform real HR operations — from onboarding employees to scheduling meetings — all through natural language.

✨ Features

📁 Project Structure

atliq-hrms-assist/
├── HRMS/
│   ├── __init__.py          # Exports all managers and schemas
│   ├── employee_manager.py  # Employee CRUD and search
│   ├── leave_manager.py     # Leave balance and application
│   ├── meeting_manager.py   # Meeting scheduling and cancellation
│   ├── ticket_manager.py    # Equipment/IT ticket management
│   └── schemas.py           # Pydantic data models
├── src/
│   └── atliq_hrms_assist/
│       └── __init__.py
├── email_sender.py          # SMTP email utility
├── server.py                # MCP server — tools & prompts
├── utils.py                 # Seed data for demo employees
├── pyproject.toml           # Project dependencies
└── .env                     # Environment variables (not committed)

✅ Prerequisites

• Python 3.12+

• uv package manager

• Claude Desktop (for MCP integration)

• A Gmail account with an App Password (for email sending)

⚙️ Installation

1. Clone the repository

git clone https://github.com/Ayush-og/atliq-hrms-assist.git
cd atliq-hrms-assist

2. Install dependencies using uv

uv sync

Or install manually:

uv add "mcp[cli]<2.0.0" pydantic python-dotenv

🔐 Configuration

Create a .env file in the project root:

CB_EMAIL=your_gmail_address@gmail.com
CB_EMAIL_PWD=your_gmail_app_password

Note: Use a Gmail App Password, not your regular Gmail password. Enable 2FA on your account first.

🚀 Running the MCP Server

Test that the server runs without errors:

uv run python server.py

🔗 Connecting to Claude Desktop

1. Open Claude Desktop → Settings → Developer → Edit Config.

2. Add the following to claude_desktop_config.json:

{
  "mcpServers": {
    "atliq-hr-assist": {
      "command": "C:\\Users\\<your-username>\\.local\\bin\\uv.exe",
      "args": [
        "--directory",
        "C:\\path\\to\\atliq-hrms-assist",
        "run",
        "python",
        "server.py"
      ]
    }
  }
}

3. Save and restart Claude Desktop.

4. The atliq-hr-assist connector will appear as 🟢 Connected.

🛠️ Available Tools

👤 Employee Tools

🌴 Leave Manager Tools

📅 Meeting Scheduler Tools

🎫 Ticket Tools

📧 Email Tool

🤖 Available Prompts

These are pre-built multi-step workflows you can invoke from Claude Desktop via "Add from atliq-hr-assist".

1. onboard_new_employee

Onboards a new employee end-to-end.

Steps performed automatically:

• Adds employee to HRMS

• Sends welcome email with login credentials

• Notifies the manager

• Raises equipment tickets (laptop, ID card, etc.)

2. apply_leave_request

Processes a leave application for an employee.

Steps performed automatically:

• Looks up employee ID

• Checks leave balance

• Applies leave if balance is sufficient

• Sends confirmation email

3. schedule_meeting_request

Schedules a meeting and sends invites.

Steps performed automatically:

• Looks up both employee and manager IDs

• Schedules the meeting

• Sends invitation email to both parties

💡 Usage Examples

Ask Claude in natural language:

"Onboard Peter Pandey with Tony Sharma as his manager."

"Apply leave for Tony Sharma on August 22 and 23, 2026."

"Schedule a 1:1 meeting between Peter Pandey and Tony Sharma on August 20 at 10 AM."

"Check leave balance for employee E004."

"Create a ticket for Peter Pandey to get a new laptop."

🧑‍💻 Author

Ayush — @Ayush-og

📄 License

This project is open source and available under the MIT License.