Use Personio with AI via MCP
Personio brings employee master data, absences and recruiting together in one system – and with them many of the questions that land in the HR inbox every day. Personio does not offer an MCP server, but it does publish an official REST API v2 with an OpenAPI specification, which we use to build the CompanyGPT integration.
What is Personio?
Personio is an HR platform from Personio SE & Co. KG in Munich, Germany, aimed at European mid-sized companies. Its scope ranges from the digital personnel file through absence and time management to recruiting, onboarding and preparatory payroll. It is offered exclusively as a SaaS solution.
Personio is interesting for AI assistants because so many recurring information requests find their answer there: leave balances, responsibilities, deadlines in the recruiting process, the status of ongoing onboardings. The vendor actively supports this use – it publishes an llms.txt and makes its OpenAPI specifications explicitly available for AI agents.
Connection at a Glance
- MCP server
- None official – individual integration via the REST API
- Interface
- Personio REST API v2 (OpenAPI), webhooks
- Authentication
- OAuth2 client credentials with scopes (e.g. personio:persons:read)
- Operating model
- SaaS
- Notable
- Personio publishes OpenAPI specifications and an llms.txt for AI agents
How to Connect Personio to CompanyGPT
Personio does not currently run an MCP server of its own, and none is present in the company’s GitHub organization. For CompanyGPT that is not an obstacle, because the conditions for an individual integration are unusually good here.
The basis is the Personio REST API v2, fully described in OpenAPI form; the older v1 is being phased out. From that specification we derive MCP tools covering exactly the resources needed – for example person records, absences or application status. Authentication uses OAuth2 with the client credentials flow and fine-grained scopes such as personio:persons:read. This makes it possible to limit access to read operations and to individual data areas rather than opening up the integration broadly. Webhooks are available in addition for event-driven processes and can be orchestrated with n8n.
Because HR data is particularly sensitive, we recommend tight role control: in CompanyGPT your administrators release the integration specifically for HR roles, while general workforce accounts never see it. Which scopes are granted should be decided together with HR, data protection and, where applicable, the works council.
Typical Use Cases
How AI agents in CompanyGPT work with Personio
Plan around absences
Team leads query leave balances and planned absences for their team so they can arrange cover and project dates realistically.
Keep recruiting in view
The recruiting team has the status of open positions summarized – how many applications sit in which stage and where feedback is still pending.
Take load off HR
Recurring questions about processes and responsibilities are answered by the assistant from released data, so the HR team can focus on individual cases.
Frequently Asked Questions
Personio and AI – the most important answers
Does Personio have an official MCP server?
No. Personio does not currently operate its own MCP server. It does, however, provide a documented REST API v2 with an OpenAPI specification, which we use to build the CompanyGPT integration individually.
How much effort is the individual integration?
Comparatively manageable, because a complete OpenAPI specification exists. We select the endpoints required, turn them into MCP tools and set up OAuth2 access with the matching scopes.
Which data can the assistant see?
Only the areas released through the granted scopes – for example read access to master data or absences. Sensitive fields can be excluded, and roles and groups in CompanyGPT determine who may use the integration at all.
What should be considered regarding data protection?
This is employee data, whose processing requires a clear legal basis and, in many companies, involvement of the works council. CompanyGPT runs in your own cloud tenant and calls the Personio API directly, without intermediaries.
Can the AI make changes in Personio?
Technically the API also allows write operations. In practice we set up HR integrations read-only first; write access is enabled only after explicit approval and for clearly defined processes.
Personio and Your AI – GDPR-Compliant with CompanyGPT
CompanyGPT is the enterprise AI assistant in your own cloud tenant: all relevant AI models, your company data and integrations like Personio – centrally managed, with roles and permissions. We set up the connection together with you.
Personio is a trademark of its respective owner (Personio SE & Co. KG). Its mention describes compatibility and does not imply any partnership or endorsement. Availability and scope of the connection depend on the respective vendor.