suresh-hr-assist

Suresh Amgoth HR Assist

Suresh Amgoth HR Assist is a Python-based agentic HR workflow project built around the Model Context Protocol. It automates common HR tasks such as employee onboarding, email notifications, leave management, meeting coordination, and ticket handling through a Claude Desktop compatible MCP server.

The project is structured as a lightweight local service that can be run on a Windows machine and connected to Claude Desktop for interactive HR operations. The code is organized into small service classes, typed request schemas, and reusable tools so the workflow stays easy to extend.

Core Features

• Employee onboarding and lookup
• Leave balance, leave application, and leave history tracking
• Meeting scheduling and cancellation
• IT and HR ticket creation with status updates
• Email notifications for onboarding and support workflows
• Seeded demo data for quick local testing

Tech Stack

• Python 3.10+
• Model Context Protocol (MCP)
• Claude Desktop
• Pydantic
• SMTP email integration

Local Setup

1. Open the project folder on your computer.
2. Create a virtual environment and install the dependencies.
3. Set your email credentials in the environment file.
4. Point Claude Desktop to this project folder and run the MCP server.

Claude Desktop Configuration

Use a local path that matches your machine. If this repository is stored under your Windows user profile, a configuration like the following works well:

{
  "mcpServers": {
    "suresh-hr-assist": {
      "command": "uv",
      "args": [
        "--directory",
        "%USERPROFILE%\\OneDrive\\Desktop\\Project\\GenAI_Project3_Resources\\GenAI_Project3_Resources",
        "run",
        "server.py"
      ],
      "env": {
        "CB_EMAIL": "your-email@example.com",
        "CB_EMAIL_PWD": "your-app-password"
      }
    }
  }
}

Email Setup

• Set CB_EMAIL to the account that will send notification emails.
• Set CB_EMAIL_PWD to the app password generated by your email provider.
• Update the sender address in the project code if you want to use a different domain.

Screenshot

<img src="Resources/image.jpg" alt="Claude Desktop prompt showing the HR Assist workflow" style="width:auto;height:300px;padding-left:30px">

Personal Project Summary

This project is presented as part of Suresh Amgoth's portfolio to demonstrate practical AI workflow automation, structured Python design, and MCP-based tool integration.