HR-Assist
Sends welcome emails with credentials via Gmail SMTP using an App Password.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@HR-AssistOnboard new employee Alice under manager Bob"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
š¤ HR-Assist ā Agentic AI HR Helpdesk
HR-Assist is an Agentic AI system that helps HR teams automate routine workflows using Claude Desktop as the MCP client and a custom Python MCP server as the backend.
This project demonstrates end-to-end automation of the employee onboarding process ā tasks that typically require multiple manual steps are handled by the AI agent in a single prompt.
⨠What It Does
Task | Automated? |
Add employee to HRMS | ā |
Send welcome email with credentials | ā |
Notify the manager | ā |
Raise tickets for laptop, ID card & equipment | ā |
Schedule introductory meeting | ā |
Leave management | ā |
Ticket tracking & updates | ā |
Related MCP server: Leave Management MCP Server
šļø Architecture
āāāāāāāāāāāāāāāāāāāāāāā MCP Protocol āāāāāāāāāāāāāāāāāāāāāāā
ā ā āāāāāāāāāāāāāāāāāāāāāāāāāāāŗ ā ā
ā Claude Desktop ā ā HR-Assist Server ā
ā (MCP Client) ā ā (Python + uv) ā
ā ā ā ā
āāāāāāāāāāāāāāāāāāāāāāā āāāāāāāāāāāāāāāāāāāāāāā
ā
āāāāāāāāāāāāāāāāā¼āāāāāāāāāāāāāāāā
ā¼ ā¼ ā¼
employee_manager leave_manager ticket_manager
meeting_manager schemas utilsMCP Client ā Claude Desktop
MCP Server ā This codebase (
server.py+hrms/modules)Email ā SMTP via Gmail App Password
š Project Structure
HR_helpdesk/
ā
āāā hrms/
ā āāā __init__.py
ā āāā employee_manager.py # Add & fetch employee logic
ā āāā leave_manager.py # Leave apply, balance, history
ā āāā meeting_manager.py # Schedule & fetch meetings
ā āāā ticket_manager.py # Create & update tickets
ā āāā schemas.py # Pydantic data models
ā
āāā server.py # MCP server entry point
āāā utils.py # Shared utility functions
āāā emails.py # Email sending logic (SMTP)
āāā pyproject.toml # Project config (uv)
āāā sample.env # Environment variable template
āāā README.mdāļø Setup Instructions
Prerequisites
Claude Desktop installed
uv installed
Gmail account with App Password enabled
1. Clone the Repository
git clone https://github.com/saibalajijammu/HR_helpdesk.git
cd HR_helpdesk2. Install Dependencies
uv init
uv add mcp[cli]3. Set Up Environment Variables
cp sample.env .envEdit .env and fill in:
CB_EMAIL=your_email@gmail.com
CB_EMAIL_PWD=your_gmail_app_password4. Configure Claude Desktop
Open your claude_desktop_config.json file and add the following:
Location of config file:
Windows:
%APPDATA%\Claude\claude_desktop_config.jsonMac:
~/Library/Application Support/Claude/claude_desktop_config.json
{
"mcpServers": {
"hr-assist": {
"command": "C:\\Users\\<your-username>\\.local\\bin\\uv",
"args": [
"--directory",
"<full-path-to-project>\\HR_helpdesk",
"run",
"server.py"
],
"env": {
"CB_EMAIL": "YOUR_EMAIL",
"CB_EMAIL_PWD": "YOUR_APP_PASSWORD"
}
}
}
}Replace
<your-username>and<full-path-to-project>with your actual values.
5. Restart Claude Desktop
After saving the config, fully restart Claude Desktop. You should see hr-assist appear as a connected MCP server.
š¬ Usage
Option 1 ā Quick Onboarding via UI
Click the
+icon in Claude DesktopSelect
Add from hr-assistFill in the employee details when prompted
Option 2 ā Custom Prompt (Recommended)
Just type a natural language prompt like:
Onboard a new employee named Priya Mehta under manager Raj Kumar.The agent will automatically:
ā Add her to the HRMS
ā Send a welcome email
ā Notify her manager
ā Raise tickets for laptop, ID card & equipment
ā Schedule an intro meeting
š Environment Variables
Variable | Description |
| Your Gmail address used for sending emails |
| Gmail App Password (not your regular password) |
š§° Tech Stack
Component | Technology |
AI Model | Claude (Anthropic) |
MCP Client | Claude Desktop |
MCP Server | Python + |
Package Manager |
|
SMTP (Gmail) | |
Data Validation | Pydantic ( |
š¤ Contributing
Pull requests are welcome! For major changes, please open an issue first to discuss what you'd like to change.
š License
This project is licensed under the MIT License.
This server cannot be installed
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Related MCP Servers
- Flicense-qualityCmaintenanceEnables employees to check leave balance, apply for leave, and view leave history through natural language using Claude Desktop.Last updated
- Flicense-qualityCmaintenanceEnables HR teams to query and manage employee leave through natural language using Claude Desktop, with tools for checking balances, applying leave, and viewing history.Last updated
- Flicense-qualityCmaintenanceAgentic AI system that automates HR workflows like employee onboarding, enabling HR teams to streamline tasks through natural language interactions with Claude Desktop.Last updated
- FlicenseCqualityCmaintenanceAutomates employee onboarding workflows for HR teams, enabling tasks like data entry and email notifications through natural language.Last updated12
Related MCP Connectors
Automate tasks, processes, and approvals with AI.
Connect your team's living knowledge base ā docs, data, issues, CRM ā to Claude and ChatGPT.
Manage projects, tasks, time tracking, and team collaboration through natural language.
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/saibalajijammu/HR_helpdesk'
If you have feedback or need assistance with the MCP directory API, please join our Discord server