PeopleForce MCP by usefulapi

Read employees, leave, timesheets and recruitment candidates in PeopleForce.

Should I use this

Quality & Safety

A
Description quality
100%
Schema completeness
93%
Naming quality
71%
Poisoning risk
100%
Permission match
100%
Protocol compliance
100%

Findings (9)

  • LOWTool 'peopleforce_list_terminated_employees' name length outside 3-30 rangein peopleforce_list_terminated_employees
  • LOWTool 'peopleforce_list_employee_leave_balances' name length outside 3-30 rangein peopleforce_list_employee_leave_balances
  • LOWTool 'peopleforce_list_employee_tasks' name length outside 3-30 rangein peopleforce_list_employee_tasks
  • LOWTool 'peopleforce_list_leave_requests' name length outside 3-30 rangein peopleforce_list_leave_requests
  • LOWTool 'peopleforce_list_pending_leave_requests' name length outside 3-30 rangein peopleforce_list_pending_leave_requests
  • LOWTool 'peopleforce_list_timesheet_entries' name length outside 3-30 rangein peopleforce_list_timesheet_entries
  • LOWTool 'peopleforce_list_recruitment_vacancies' name length outside 3-30 rangein peopleforce_list_recruitment_vacancies
  • LOWTool 'peopleforce_get_recruitment_vacancy' name length outside 3-30 rangein peopleforce_get_recruitment_vacancy
  • LOWTool 'peopleforce_list_recruitment_candidates' name length outside 3-30 rangein peopleforce_list_recruitment_candidates

Based on automated analysis of tool definitions and protocol compliance.

Context Cost

~3,437Tokens (tool definitions)
~1.3 KBTypical response size
Significant attention impact (2.69% of 128k context)

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-http

What it can do

Tool inventory

Tools (21)

🟢 Read-only🟡 Write🔴 Delete⚪ Unknown
🟢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

Rate this Server

Evidence

Recent observations

verifiedversion not recorded21 tools