PeopleHR MCP Server
for AI Agents

Create a new employee record

Retrieve a list of all employees

Retrieve details for a specific employee by ID. Use list_employees first to find the EmployeeId.

Update an existing employee's details. Requires EmployeeId, ReasonForChange, and all core fields (name, gender, dates, job role, location, department with effective dates). Use get_employee first to retrieve current values.

Add a new unplanned absence record (sick leave, personal leave) for an employee. DurationType codes: 1=Days, 2=Hours, 3=Half Day. Use list_employees to find the EmployeeId first.

Retrieve unplanned absence records (sick leave, personal leave) for an employee within a date range. Use list_employees to find the EmployeeId first.

Update an existing absence record. Requires OldStartDate and OldEndDate from the original record — use get_absences first to retrieve these.

Delete an absence record for an employee. Identified by StartDate and EndDate — use get_absences first to find the dates.

Book a new planned annual leave / vacation for an employee. DurationType codes: 1=Days, 2=Hours, 3=Half Day. Use list_employees to find the EmployeeId first.

Retrieve planned annual leave / vacation booking records for an employee, optionally filtered by date range. Use list_employees to find the EmployeeId first.

Update an existing planned leave booking for an employee. Requires OldStartDate and OldEndDate from the original booking — use get_holidays first to retrieve these.

Delete a holiday booking for an employee. Identified by StartDate and EndDate of the booking — use get_holidays first to find the dates.

Create a new salary record for an employee. Use list_employees to find the EmployeeId first. Deductions and Entitlements can be empty arrays [] if not applicable.

Retrieve salary details for an employee, with optional history. Use list_employees to find the EmployeeId first.

Delete a salary record for an employee. Identified by EffectiveFrom date — use get_salary first to find it.

Upload a document to an employee's record. Requires base64-encoded file content in the File field and a Category (e.g. "General", "Contract").

Retrieve all documents for an employee. Use list_employees to find the EmployeeId first.

Retrieve a specific employee document by DocumentId. Use list_documents first to find the DocumentId.

Create a new timesheet entry for an employee

Retrieve timesheet records for an employee. Use list_employees to find the EmployeeId first.

Update an existing timesheet entry for an employee

Delete a timesheet entry for an employee. Identified by TimesheetDate — use get_timesheets first to find the date.

Create a new appraisal record for an employee

Retrieve a specific appraisal record by AppraisalId. Use get_appraisals_by_employee first to find the AppraisalId.

Update an existing appraisal record

Delete an appraisal record. Requires AppraisalId — use get_appraisals_by_employee first to find it.

Add a new benefit record for an employee

Retrieve a specific benefit record by its BenefitId. Use get_benefits_by_employee first to find the BenefitId.

Update an existing benefit record for an employee

Delete a benefit record for an employee. Requires BenefitId — use get_benefits_by_employee first to find it.

Add a new qualification record for an employee

Retrieve a specific qualification record by QualificationId. Use get_qualifications_by_employee first to find the QualificationId.

Update an existing qualification record for an employee

Delete a qualification record for an employee. Requires QualificationId — use get_qualifications_by_employee first to find it.

Add a new training record for an employee

Retrieve all training records for a specific employee. Use list_employees to find the EmployeeId first.

Update an existing training record for an employee

Delete a training record for an employee. Requires TrainingId — use get_trainings first to find it.

Retrieve current year holiday entitlement (remaining allowance) for a specific employee. Use list_employees to find the EmployeeId first.

Update the current year holiday entitlement for a specific employee. Requires EntitlementThisYear value and ReasonForChange.

Retrieve next year's holiday entitlement (future year allowance) for a specific employee. For current year, use get_holiday_entitlement instead.

Update next year's holiday entitlement for a specific employee. For current year, use update_holiday_entitlement instead.

Add a new maternity/paternity record for an employee

Retrieve a specific maternity/paternity record by MaternityPaternityTxnId. Use get_maternity_paternity_by_employee first to find the ID.

Update an existing maternity/paternity record for an employee

Delete a maternity/paternity record. Requires MaternityPaternityTxnId — use get_maternity_paternity_by_employee first to find it.

Add a new right to work / visa / work permit record for an employee. DocumentId here means the document reference number (e.g. passport number), not a database ID.

Retrieve right to work / visa / work permit details for a specific employee. Use list_employees to find the EmployeeId first.

Update an existing right to work record for an employee

Delete a right to work record. Requires RightToWorkTxnId — use get_right_to_work first to find it.