# HR Assist

HR Assist is an AI-powered HR automation agent that uses Claude Desktop and MCP tools to handle tasks like onboarding, leave management, meeting scheduling, and ticket creation.

## Architecture

![HR Assist Architecture](images/architecture.png)

HR Assist is an agentic AI-powered HR automation system built using **Claude Desktop, MCP (Model Context Protocol), and Python**.

Claude Desktop acts as the **AI agent and MCP client**, understanding user requests and deciding which HR actions need to be performed. The MCP server exposes HR operations as tools and connects Claude with the HRMS components.

The system includes the following managers:

- **Employee Manager**
- **Leave Manager**
- **Meeting Manager**
- **Ticket Manager**

## How It Works

The user provides an HR request through Claude Desktop. Claude understands the request, selects the required MCP tools, and executes the appropriate actions through the MCP server.

For example, when onboarding a new employee, the system can add the employee, send a welcome email, notify the manager, raise a laptop ticket, schedule an introduction meeting, and handle leave-related actions.

### Tool Selection

![Tool Selection](images/tool_selection.png)

### Employee Onboarding Inputs

![Prompt Inputs](images/prompt_inputs.png)

### Meeting Scheduling

![Meeting Time Selection](images/meeting_time_selection.png)

### Onboarding Result

![Onboarding Summary](images/onboarding_summary.png)

## MCP Tools

The project provides tools for:

- 👤 Adding and retrieving employees
- 🗓️ Managing leave
- 📧 Sending emails
- 📅 Scheduling meetings
- 🎫 Creating HR/IT tickets
- 🚀 Supporting employee onboarding workflows

## Project Structure

```text
hrms/
├── employee_manager.py
├── leave_manager.py
├── meeting_manager.py
├── ticket_manager.py
└── schemas.py

images/
├── architecture.png
├── tool_selection.png
├── prompt_inputs.png
├── meeting_time_selection.png
└── onboarding_summary.png

server.py
emails.py
utils.py
pyproject.toml
README.md
```

## Tech Stack

- 🐍 Python
- 🤖 Claude Desktop
- 🔌 Model Context Protocol (MCP)
- 📦 uv
- ✉️ Gmail SMTP
- 🏢 HRMS Components

## Setup

Clone the repository and install the dependencies:

```bash
uv sync
```

Run the MCP server:

```bash
uv run python server.py
```

Configure the MCP server with Claude Desktop and start interacting with HR Assist.

## Example

```text
User:
Onboard a new employee named Likhitha and assign Tony Sharma as the manager.

HR Assist:
✓ Employee added
✓ Welcome email sent
✓ Manager notified
✓ Laptop ticket created
✓ Introduction meeting scheduled
✓ Leave status checked
```

## Conclusion

HR Assist demonstrates how agentic AI + MCP tools can automate real-world HR workflows by allowing an AI agent to understand requests, select tools, and execute multiple actions autonomously.