PeopleForce MCP by usefulapi
Read employees, leave, timesheets and recruitment candidates in PeopleForce.
Should I use this
Quality & Safety
Findings (9)
- LOWin peopleforce_list_terminated_employees
- LOWin peopleforce_list_employee_leave_balances
- LOWin peopleforce_list_employee_tasks
- LOWin peopleforce_list_leave_requests
- LOWin peopleforce_list_pending_leave_requests
- LOWin peopleforce_list_timesheet_entries
- LOWin peopleforce_list_recruitment_vacancies
- LOWin peopleforce_get_recruitment_vacancy
- LOWin peopleforce_list_recruitment_candidates
Based on automated analysis of tool definitions and protocol compliance.
Context Cost
This is the approximate number of tokens consumed each time the server's tools are loaded into a model's context. Higher counts reduce the attention available for other tasks.
Install
One-Click Install
Add this to your `claude_desktop_config.json` file:
{
"mcpServers": {
"peopleforce": {
"url": "https://peopleforce.usefulapi.io/mcp"
}
}
}Remote endpoints
https://peopleforce.usefulapi.io/mcpstreamable-httpWhat it can do
Tool inventory
Tools (21)
🟢peopleforce_list_employees(page, status, ids, emails, employee_numbers, ...)
List employees with status, job position, department, division, location, manager and hire date. Filter by status, ids, emails or employee numbers. Company API: GET /employees.
Input Schema
{
"type": "object",
"properties": {
"page": {
"description": "Page number (50 items per page). Default 1.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"status": {
"description": "Employment status filter.",
"type": "string",
"enum": [
"active",
"employed",
"terminated",
"hired",
"probation",
"all"
]
},
"ids": {
"description": "Employee ids to include.",
"type": "array",
"items": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
}
},
"emails": {
"description": "Work email addresses to include.",
"type": "array",
"items": {
"type": "string"
}
},
"employee_numbers": {
"description": "Employee numbers to include.",
"type": "array",
"items": {
"type": "string"
}
},
"manager_id": {
"description": "Only direct reports of this employee id.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"legal_entity_id": {
"description": "Only this legal entity id.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"hired_on_from": {
"description": "Hired on or after this date.",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"hired_on_to": {
"description": "Hired on or before this date.",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢peopleforce_get_employee(employee_id, include_historical_values)
Get one employee by id with contact, job, department, division, location and manager fields. Company API: GET /employees/{id}.
Input Schema
{
"type": "object",
"properties": {
"employee_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "The employee id (from peopleforce_list_employees)."
},
"include_historical_values": {
"description": "Include earlier values of changed fields.",
"type": "boolean"
}
},
"required": [
"employee_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢peopleforce_list_terminated_employees(page, terminated_on_from, terminated_on_to)
List employees who left, with termination date and comment. Company API: GET /employees/terminated.
Input Schema
{
"type": "object",
"properties": {
"page": {
"description": "Page number (50 items per page). Default 1.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"terminated_on_from": {
"description": "Terminated on or after this date.",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"terminated_on_to": {
"description": "Terminated on or before this date.",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢peopleforce_list_employee_leave_balances(employee_id)
List one employee's leave balances per leave type, with the effective date. Company API: GET /employees/{id}/leave_balances.
Input Schema
{
"type": "object",
"properties": {
"employee_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "The employee id."
}
},
"required": [
"employee_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢peopleforce_list_employee_tasks(employee_id, completed, page)
List onboarding or HR tasks assigned to one employee. Company API: GET /employees/{id}/tasks.
Input Schema
{
"type": "object",
"properties": {
"employee_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "The employee id."
},
"completed": {
"description": "true for completed tasks, false for open tasks.",
"type": "boolean"
},
"page": {
"description": "Page number (50 items per page). Default 1.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
}
},
"required": [
"employee_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢peopleforce_list_departments(page)
List departments with parent, manager and level. Company API: GET /departments.
Input Schema
{
"type": "object",
"properties": {
"page": {
"description": "Page number (50 items per page). Default 1.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢peopleforce_list_divisions(page)
List divisions. Company API: GET /divisions.
Input Schema
{
"type": "object",
"properties": {
"page": {
"description": "Page number (50 items per page). Default 1.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢peopleforce_list_locations(page)
List office and work locations with time zone and country. Company API: GET /locations.
Input Schema
{
"type": "object",
"properties": {
"page": {
"description": "Page number (50 items per page). Default 1.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢peopleforce_list_teams(page)
List teams with the team lead and team members. Company API: GET /teams.
Input Schema
{
"type": "object",
"properties": {
"page": {
"description": "Page number (50 items per page). Default 1.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢peopleforce_list_positions(page)
List job positions (titles). Company API: GET /positions.
Input Schema
{
"type": "object",
"properties": {
"page": {
"description": "Page number (50 items per page). Default 1.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢peopleforce_list_job_profiles(page)
List job profiles with job group and salary band limits. Company API: GET /job_profiles.
Input Schema
{
"type": "object",
"properties": {
"page": {
"description": "Page number (50 items per page). Default 1.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢peopleforce_list_leave_requests(page, employee_id, employee_ids, states, starts_on, ...)
List leave requests with state, dates, amount, leave type and approvals. Filter by employee, state or date range. Company API: GET /leave_requests.
Input Schema
{
"type": "object",
"properties": {
"page": {
"description": "Page number (50 items per page). Default 1.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"employee_id": {
"description": "Only this employee id.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"employee_ids": {
"description": "Only these employee ids.",
"type": "array",
"items": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
}
},
"states": {
"description": "Leave request states to include.",
"type": "array",
"items": {
"type": "string",
"enum": [
"pending",
"approved",
"rejected",
"withdrawn"
]
}
},
"starts_on": {
"description": "Leave starts on or after this date.",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"ends_on": {
"description": "Leave ends on or before this date.",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢peopleforce_list_pending_leave_requests(page)
List leave requests waiting for approval. Company API: GET /leave_requests/pending.
Input Schema
{
"type": "object",
"properties": {
"page": {
"description": "Page number (50 items per page). Default 1.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢peopleforce_get_leave_request(leave_request_id)
Get one leave request by id with its entries and approvals. Company API: GET /leave_requests/{id}.
Input Schema
{
"type": "object",
"properties": {
"leave_request_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "The leave request id (from peopleforce_list_leave_requests)."
}
},
"required": [
"leave_request_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢peopleforce_list_leave_types(page)
List leave types (for example vacation or sick leave) with unit and colour. Company API: GET /leave_types.
Input Schema
{
"type": "object",
"properties": {
"page": {
"description": "Page number (50 items per page). Default 1.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢peopleforce_list_holidays(page)
List public holidays with their date and holiday policy. Company API: GET /holidays.
Input Schema
{
"type": "object",
"properties": {
"page": {
"description": "Page number (50 items per page). Default 1.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢peopleforce_list_timesheets(page, year, month, employee_ids, project_ids)
List monthly timesheet totals per employee: expected, worked, break and leave minutes. Company API: GET /time/timesheets.
Input Schema
{
"type": "object",
"properties": {
"page": {
"description": "Page number (50 items per page). Default 1.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"year": {
"description": "Year, for example 2026.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"month": {
"description": "Month number, 1 to 12.",
"type": "integer",
"minimum": 1,
"maximum": 12
},
"employee_ids": {
"description": "Only these employee ids.",
"type": "array",
"items": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
}
},
"project_ids": {
"description": "Only these project ids.",
"type": "array",
"items": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
}
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢peopleforce_list_timesheet_entries(starts_on, ends_on, page, employee_ids, status, ...)
List clock-in and clock-out entries in a date range, with minutes and type. Filter by approval status. Company API: GET /time/timesheet_entries.
Input Schema
{
"type": "object",
"properties": {
"starts_on": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "First day of the range (required)."
},
"ends_on": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Last day of the range (required)."
},
"page": {
"description": "Page number (50 items per page). Default 1.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"employee_ids": {
"description": "Only these employee ids.",
"type": "array",
"items": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
}
},
"status": {
"description": "Approval statuses to include.",
"type": "array",
"items": {
"type": "string",
"enum": [
"unsubmitted",
"pending",
"approved",
"rejected"
]
}
},
"type": {
"description": "Entry type.",
"type": "string",
"enum": [
"working",
"break"
]
}
},
"required": [
"starts_on",
"ends_on"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢peopleforce_list_recruitment_vacancies(page, title, location_ids, sort_by, sort_dir)
List open and closed job vacancies with title, pipeline, location and dates. Company API: GET /recruitment/vacancies.
Input Schema
{
"type": "object",
"properties": {
"page": {
"description": "Page number (50 items per page). Default 1.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"title": {
"description": "Filter by vacancy title.",
"type": "string"
},
"location_ids": {
"description": "Only these location ids.",
"type": "array",
"items": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
}
},
"sort_by": {
"description": "Sort field.",
"type": "string",
"enum": [
"opened_at",
"created_at",
"updated_at"
]
},
"sort_dir": {
"description": "Sort direction.",
"type": "string",
"enum": [
"asc",
"desc"
]
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢peopleforce_get_recruitment_vacancy(vacancy_id)
Get one vacancy by id with its pipeline, hiring lead and description. Company API: GET /recruitment/vacancies/{id}.
Input Schema
{
"type": "object",
"properties": {
"vacancy_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "The vacancy id (from peopleforce_list_recruitment_vacancies)."
}
},
"required": [
"vacancy_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢peopleforce_list_recruitment_candidates(page, email, vacancy_ids, pipeline_stage_id)
List job candidates with contact fields, skills and their applications. Filter by email, vacancy or pipeline stage. Company API: GET /recruitment/candidates.
Input Schema
{
"type": "object",
"properties": {
"page": {
"description": "Page number (50 items per page). Default 1.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"email": {
"description": "Candidate email address.",
"type": "string"
},
"vacancy_ids": {
"description": "Only candidates who applied to these vacancy ids.",
"type": "array",
"items": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
}
},
"pipeline_stage_id": {
"description": "Only candidates in this pipeline stage id.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}Community
Evidence