AtliQ HR Assist

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

---

🛠️ 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).