Connect your AI to Personio

What your AI can do with Personio

Once connected, these tools appear automatically in your AI assistant:

• list_employeesread-only

  List the people of the company, with their employments. Filter by email or by name to find someone without knowing their id.

• get_employeeread-only

  Get one person, with their personal details and current employment.

• create_employeewrite · needs approval

  Create a person and their first employment — an onboarding. Only the name is strictly required, but an employment without a start date, status and type is of little use, so give those together. Needs the persons:write scope on the Personio credential.

• update_employeewrite · needs approval

  Change a person's own details. Their employment is changed with update_employment.

• list_employmentsread-only

  List a person's employments — their contracts over time, with start and end dates, working hours, legal entity, job and manager.

• get_employmentread-only

  Get one employment of a person in full.

• update_employmentwrite · needs approval

  Change a contract: status, dates, working hours, job, manager or legal entity. This is the record of someone's terms of employment — a wrong value here is visible to payroll.

• list_compensationsread-only

  List compensation entries — salaries and other paid components, each with its amount, currency, interval and the date it takes effect. Personio refuses a date range wider than one month, so ask month by month.

• create_compensationwrite · needs approval

  Record a compensation for a person — a raise, a bonus, a new salary. Takes effect on `effectiveFrom` and feeds payroll. The type comes from list_compensation_types.

• list_compensation_typesread-only

  List the kinds of compensation the company has defined — base salary, bonus, allowance. Their ids are what create_compensation needs.

• list_salary_bandsread-only

  List the salary bands defined for the company.

• get_salary_bandread-only

  Get one salary band, with its range.

• list_absencesread-only

  List absence periods — holidays, sick leave, and every other kind of time off, each with its type, dates and who is standing in.

• get_absenceread-only

  Get one absence period in full.

• list_absence_typesread-only

  List the kinds of absence the company has defined — paid leave, sick leave, unpaid. Their ids are what create_absence needs.

• create_absencewrite · needs approval

  Book an absence for someone. Dates are given without a timezone; use `startHalf` or `endHalf` when the absence covers only half of the first or last day. Whether a stand-in is required, optional or forbidden depends on the absence type's own policy.

• update_absencewrite · needs approval

  Change the dates, stand-in or comment of an absence already booked.

• list_attendancesread-only

  List attendance periods — the hours people actually worked, and their breaks, optionally booked against a project.

• get_attendanceread-only

  Get one attendance period in full.

• create_attendancewrite · needs approval

  Record worked time or a break for someone. A period cannot exceed 24 hours, and a break cannot be booked against a project — only work can.

• update_attendancewrite · needs approval

  Change the times, project or comment of an attendance period already recorded.

• list_projectsread-only

  List the projects time can be booked against.

• get_projectread-only

  Get one project.

• create_projectwrite · needs approval

  Create a project people can book time against.

• update_projectwrite · needs approval

  Rename a project, or close it to new time bookings.

• list_project_membersread-only

  List the people who can book time against a project.

• add_project_memberswrite · needs approval

  Let people book time against a project.

• remove_project_memberswrite · needs approval

  Stop people booking time against a project. Time already booked stays — only the right to add more is removed.

• list_org_unitsread-only

  List the organisational units — departments and teams.

• get_org_unitread-only

  Get one organisational unit, with its place in the hierarchy.

• list_legal_entitiesread-only

  List the legal entities of the group — the companies people are employed by.

• get_legal_entityread-only

  Get one legal entity.

• list_cost_centersread-only

  List the cost centres employments can be charged to.

• list_workplacesread-only

  List the workplaces — the offices and sites people are attached to.

• list_jobsread-only

  List the jobs defined for the company — the roles people are hired into.

• get_jobread-only

  Get one job.

• list_documentsread-only

  List the metadata of employee documents — contracts, certificates, payslips. Returns what each document is, not its content.

• list_applicationsread-only

  List job applications, with the candidate and the job each one is for.

• get_applicationread-only

  Get one application in full.

• list_application_stagesread-only

  List an application's stage transitions — when it moved to each step of the hiring process, which is how you measure where candidates stall.

• list_candidatesread-only

  List the candidates who have applied.

• get_candidateread-only

  Get one candidate's details.

• list_open_positionsread-only

  List the positions open to applications. These are recruiting jobs, distinct from the company's job catalogue returned by list_jobs.

• get_open_positionread-only

  Get one open position.

• list_job_categoriesread-only

  List the categories open positions are grouped under.

• list_reportsread-only

  List the custom reports built in Personio. Running one is how you answer a question the other tools do not cover, using the company's own definitions.

• get_reportread-only

  Get one report with its data.

• list_report_attributesread-only

  List the attributes a report can be built from — the company's own fields, including the custom ones. Read this to know what Personio actually holds before asking for it.

Example prompts

Just ask your AI in plain language — it picks the right Personio tool:

• “List the people of the company, with their employments. Filter by email or by name to find someone without knowing their id — from Personio, in plain language.”
• “Get one person, with their personal details and current employment — from Personio, in plain language.”
• “List a person's employments — their contracts over time, with start and end dates, working hours, legal entity, job and manager — from Personio, in plain language.”
• “Get one employment of a person in full — from Personio, in plain language.”

How it works

1. Create your Proxoria account and add your MCP endpoint to Claude or ChatGPT.
2. Connect Personio with your API key — each user connects their own account, credentials encrypted at rest.
3. Your AI instantly gets the Personio tools. Write actions wait for your approval in the dashboard before anything changes.

Frequently asked questions

Does Personio have an official MCP server?

You don't need one. Proxoria exposes Personio to your AI through the Model Context Protocol, so you can use it from Claude, ChatGPT, Mistral or any MCP-compatible client — no official Personio MCP server required.

What can my AI do with Personio through Proxoria?

It gets 48 tools: list_employees, get_employee, create_employee, update_employee, list_employments, get_employment, update_employment, list_compensations, create_compensation, list_compensation_types, list_salary_bands, get_salary_band, list_absences, get_absence, list_absence_types, create_absence, update_absence, list_attendances, get_attendance, create_attendance, update_attendance, list_projects, get_project, create_project, update_project, list_project_members, add_project_members, remove_project_members, list_org_units, get_org_unit, list_legal_entities, get_legal_entity, list_cost_centers, list_workplaces, list_jobs, get_job, list_documents, list_applications, get_application, list_application_stages, list_candidates, get_candidate, list_open_positions, get_open_position, list_job_categories, list_reports, get_report, list_report_attributes. For example, list the people of the company, with their employments. filter by email or by name to find someone without knowing their id.

Is the Personio connector read-only?

No — it can also make changes. Write actions go through Proxoria's confirmation guardrail by default: your AI proposes them, and you approve each one from your dashboard before anything is written to Personio.

How do I connect Personio to my AI?

Create a Proxoria account, connect Personio with your API key, and add your Proxoria MCP endpoint to Claude or ChatGPT. Your AI instantly gains the Personio tools.