Skip to main content
Glama

πŸš€ AtliQ HR Assist - MCP Server

An AI-powered HR Assistant built using the Model Context Protocol (MCP) and FastMCP. The assistant automates common HR operations such as employee management, leave management, ticket creation, meeting scheduling, and email notifications through natural language conversations.


✨ Features

  • πŸ‘€ Add, update, and delete employees

  • πŸ” Search employee details

  • πŸ“… Apply leave and check leave balance

  • πŸ“œ View employee leave history

  • 🎫 Create IT support tickets

  • 🀝 Schedule introduction meetings

  • πŸ“§ Send email notifications

  • πŸ’¬ Expose all HR operations as MCP tools for Claude Desktop


Related MCP server: AI HR Leave Management MCP Server

πŸ› οΈ Tech Stack

  • Python 3.12

  • FastMCP

  • Model Context Protocol (MCP)

  • Pydantic

  • Python Dotenv

  • Emails Library


πŸ“ Project Structure

atliq-hr-assist/
β”‚
β”œβ”€β”€ HRMS/
β”‚   β”œβ”€β”€ employee_manager.py
β”‚   β”œβ”€β”€ leave_manager.py
β”‚   β”œβ”€β”€ meeting_manager.py
β”‚   β”œβ”€β”€ ticket_manager.py
β”‚   β”œβ”€β”€ schemas.py
β”‚   └── __init__.py
β”‚
β”œβ”€β”€ server.py
β”œβ”€β”€ utils.py
β”œβ”€β”€ emails.py
β”œβ”€β”€ requirements.txt
β”œβ”€β”€ README.md
└── pyproject.toml

βš™οΈ Installation

Clone the repository:

git clone <repository-url>
cd atliq-hr-assist

Install the required dependencies:

pip install -r requirements.txt

or

uv sync

▢️ Running the Server

uv run server.py

The MCP server starts using the STDIO transport and can be connected to Claude Desktop.


πŸ”§ Claude Desktop Configuration

Add the following server configuration to your claude_desktop_config.json:

{
  "mcpServers": {
    "atliq-hr-assist": {
      "command": "uv",
      "args": [
        "run",
        "server.py"
      ],
      "cwd": "<path-to-your-project>/atliq-hr-assist"
    }
  }
}

πŸ’‘ Example Prompts

  • Add a new employee named John Doe.

  • Show employee details for Sonali Gaikwad.

  • Check leave balance for employee E004.

  • Apply leave for E004 on 2026-07-20.

  • Create a laptop request for employee E004.

  • Schedule an introduction meeting for employee E004.

  • Send a welcome email to a new employee.


πŸ‘©β€πŸ’» Author

Sonali Gaikwad

Built using the Model Context Protocol (MCP).

Available Tools

11 tools
add_employeeC

Add a new employee to the HRMS system. :param emp_name: Employee name :param manager_id: Manager ID (optional) :return: Confirmation message

Inputs: email (required), emp_name (required), manager_id (required). Returns: result

apply_leaveC

Apply leave for an employee. Example: leave_dates = ["2026-07-20", "2026-07-21"]

Inputs: employee_id (required), leave_dates (required). Returns: result

create_ticketD

Inputs: item (required), emp_id (required), reason (required). Returns: result

delete_employeeD

Inputs: emp_id (required). Returns: result

get_employee_detailsA

Get employee details by name : param name: Employee name :return: Employee id and manager id

Inputs: name (required). Returns: result

get_leave_balanceA

Get current leave balance of an employee. Args: employee_id: Employee ID (e.g. E004) Returns: Current leave balance.

Inputs: employee_id (required). Returns: result

get_leave_historyD

Inputs: employee (required). Returns: result

schedule_intro_meetingD

Inputs: emp_id (required). Returns: result

send_emailD

Inputs: body (required), subject (required), to_emails (required).

update_employeeD

Inputs: emp_id (required), name, email, manager_id. Returns: result

update_leave_balanceD

Inputs: balance (required), 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

    D1.9/5.0

    Scored across 11 tools

    Disambiguation2/5

    Many tools lack descriptions, making it hard to distinguish them. 'apply_leave' and 'get_leave_history' could be confused, and 'create_ticket' is ambiguous as it doesn't fit the HR domain clearly.

    Naming Consistency3/5

    Tools mostly follow a verb_noun pattern but the verbs are inconsistent (add, apply, create, delete, get, schedule, send, update). Some tools like 'get_employee_details' and 'get_leave_balance' align, but overall lacks a uniform convention.

    Tool Count4/5

    With 11 tools, the count is reasonable for an HR system. However, tools like 'create_ticket' and 'send_email' might be extraneous, slightly increasing the scope beyond core HR.

    Completeness2/5

    Missing descriptions for several tools hinder assessment. Obvious gaps exist: no tool for listing employees, no leave approval workflow, and no role management. The surface feels incomplete for a typical HR system.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      Not graded
      quality
      D
      maintenance
      An MCP-powered HR management system that automates employee onboarding, leave tracking, meeting scheduling, and IT ticketing. It allows users to manage organizational workflows and administrative tasks through natural language interactions with Claude.
      2
      -
    • F
      license
      Not graded
      quality
      D
      maintenance
      Provides tools for managing human resources tasks such as applying for leave, checking leave balances, and viewing holiday schedules. It enables natural language interaction for employee information and leave history tracking via the Model Context Protocol.
      -