Skip to main content
Glama
KVenkatasriram

hr-assist

README.md
## **HR-ASSIST Agentic AI System**
---
HR ASSIST is an Agentic AI system designed to help HR teams automate routine workflows. This example demonstrates automation of the employee onboarding process, streamlining tasks that typically require manual intervention.

In terms of technical architecture, for MCP client we use Claude Desktop and the code base here represents the MCP server with necessary tools that will be used by MCP client 

🛠️ Setup Instructions

To set up and run HR ASSIST, follow these steps:

- Configure claude_desktop_config.json
Add the following configuration to your claude_desktop_config.json file:

    ```json
    {
    "mcpServers": {
        "hr-assist": {
        "command": "C:\\Users\\dhaval\\.local\\bin\\uv",
        "args": [
            "--directory",
            "C::\\code\\atliq-hr-assist",
            "run",
            "server.py"
        ],
        "env": {
            "CB_EMAIL": "YOUR_EMAIL",
            "CB_EMAIL_PWD": "YOUR_APP_PASSWORD"
        }
        }
    }
    }
    ```

- Replace YOUR_EMAIL with your actual email.
- Replace YOUR_APP_PASSWORD with your email provider’s app-specific password (e.g., for Gmail).


## đź§  AI Development Conversation

This project was developed and tested using Claude Desktop as the AI client, with MCP used to connect the AI assistant to the HR tools and services.

👉 [View the Claude Desktop conversation](https://claude.ai/share/ff6bd419-9e8d-40b1-b8d7-3453538635b7)

TDQS

C2.8/5.0

Scored across 12 tools

Disambiguation4/5

Tools have distinct purposes related to employee management, leave, tickets, and meetings. However, 'send_email' has no description, creating ambiguity about its scope and potential overlap with other communication tools.

Naming Consistency4/5

Most tool names follow a consistent verb-noun pattern (e.g., get_leave_history, add_employee, update_ticket_status). Minor deviations like 'send_email' and 'schedule_meeting' still fit the pattern, but the mix of 'emp_id' and 'employee_id' in parameters is slightly inconsistent.

Tool Count5/5

12 tools is well-scoped for an HR assistant, covering employee records, leave, tickets, and meetings without redundancy. Each tool appears to serve a distinct function.

Completeness3/5

Core operations for leave and tickets are present, but missing update/delete for employee records and leave, and the 'send_email' tool lacks description, suggesting an incomplete or unclear communication surface.

Maintenance

ActivityMaintained
ResponsivenessNo issues