# 🚀 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

---

## 🛠️ Tech Stack

- Python 3.12
- FastMCP
- Model Context Protocol (MCP)
- Pydantic
- Python Dotenv
- Emails Library

---

## 📁 Project Structure

```text
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:

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

Install the required dependencies:

```bash
pip install -r requirements.txt
```

or

```bash
uv sync
```

---

## ▶️ Running the Server

```bash
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`:

```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)**.