# Personio MCP > The Personio MCP connects your AI agent directly to your HR platform data, letting you handle complex people operations tasks via natural conversation. You can manage employee records, track time off, update attendance logs, and even run custom reports without logging into the dedicated system or copying spreadsheets. ## Overview - **Category:** human-resources - **Price:** Free - **Tags:** employee-management, attendance-tracking, payroll, people-ops, recruiting, hr-automation ## Description Managing staff data used to mean jumping between multiple tabs: one for payroll, another for absences, and a third just for open job listings. Now, you can handle your entire people operation workflow right from your chat window. Just talk to your agent about what you need—like listing all current employees or checking if someone logged their time today. You can create records, update attendance logs, or even build reports by asking questions in plain English. The MCP handles the connection to Personio and surfaces the answers instantly. If you're exploring how to connect external systems to your AI agent, Vinkius is the central catalog where you find this connector alongside thousands of others. This tool lets you go beyond simple data retrieval. You can create a brand new person or update an existing employee’s details in minutes. It also keeps your recruiting pipeline moving by letting you list job openings and manage applications without leaving your current task. ## Tools ### create_absence Generates a new record confirming an employee's approved time off. ### create_application Posts a new job application into the recruiting system. ### create_attendance Records a specific period of daily employee working hours. ### create_employee Creates an entirely new profile for an active company employee. ### create_person Adds a general contact record, used when the person isn't yet a full employee. ### create_webhook Sets up an alert to fire whenever specific HR events happen in Personio. ### delete_absence Removes a previously recorded absence time off record. ### delete_attendance Deletes an incorrect or outdated attendance record. ### delete_webhook Turns off and removes a configured system alert. ### get_custom_report_columns Fetches the required column headers for any custom report you want to analyze. ### get_custom_report_data Retrieves and analyzes the actual data rows from a specific, pre-built HR report. ### list_absences Fetches a comprehensive list of all current employee absences. ### list_applications Lists job applications and candidates in the recruiting pipeline. ### list_attendances Retrieves a list of all recorded employee working hours. ### list_candidates Gets a list of potential candidates in the talent pool. ### list_custom_attributes Shows what extra data fields you can collect for employees beyond the standard profile. ### list_custom_reports Lists all custom reports that have been set up in your HR system. ### list_employees Retrieves a list of every active employee on the company payroll. ### list_jobs Shows all currently open job listings available for hiring. ### list_persons Retrieves a list of contacts, whether or not they are employees. ### list_webhooks Shows all webhooks currently configured to monitor HR events. ### update_attendance Modifies the recorded working hours for an employee's attendance record. ### update_employee Changes key details, such as a name or department, on an existing employee profile. ### update_person Edits general contact information for a person who is not currently employed. ### update_webhook Changes the settings or destination of an existing system alert. ## Prompt Examples **Prompt:** ``` List all active employees in the Engineering department. ``` **Response:** ``` I've retrieved the employee list. There are 12 active employees in Engineering, including Sarah Chen (Lead Developer) and Marco Rossi (DevOps). Would you like to see their contact details? ``` **Prompt:** ``` Create an attendance record for employee ID 456 for today from 09:00 to 18:00. ``` **Response:** ``` Attendance record created successfully for employee 456 on 2023-10-27 (09:00 - 18:00). ``` **Prompt:** ``` Show me the data from my custom report 'Monthly Payroll Export'. ``` **Response:** ``` Fetching report data... I've loaded the 'Monthly Payroll Export'. It contains 50 rows of data across columns like 'Base Salary', 'Bonus', and 'Department'. Should I summarize the totals for you? ``` ## Capabilities ### Manage Employee Records Create, read, and modify full records for employees or general persons within the system. ### Track Time & Absences Record daily working hours, log attendance periods, and manage time off requests and deletions. ### Handle Recruiting Pipelines List job openings and track the status of candidates applying for roles. ### Access Custom HR Data Fetch data from custom reports you've built in Personio so your agent can analyze it immediately. ### Automate Webhook Management Create, read, or delete webhooks to keep other external systems connected and synchronized with HR events. ## Use Cases ### Checking Team Availability Before Planning a Sprint A team lead needs to know who is available next week. Instead of checking individual calendars or running several reports, they ask their agent to 'list all employees and check their absence status.' The MCP uses `list_employees` and `list_absences` to give an immediate, compiled list, allowing them to plan the sprint without delay. ### Onboarding a New Contractor A manager needs to add a temporary worker who isn't yet fully onboarded. They prompt their agent to 'create a new person with these details.' The MCP uses `create_person` to log the contact immediately, keeping track of them until they become full employees. ### Analyzing Quarterly Performance Trends The HR manager wants to understand year-over-year salary changes. Instead of exporting and manually cleaning data from several sources, they ask their agent to 'show me the custom report data for payroll.' The MCP uses `get_custom_report_data` to load the relevant figures directly into your chat workspace for immediate analysis. ### Fixing an Incorrect Time Log An employee realizes they forgot to log their full hours. They tell their agent, 'update my attendance record for Tuesday.' The MCP uses `update_attendance` to correct the data instantly, ensuring payroll accuracy without needing manual form submissions. ## Benefits - Instead of manually running reports, you can simply ask your agent to 'get the Q3 payroll summary' or 'list all employees in engineering,' getting instant data analysis without leaving your workflow. - You save time on attendance tracking. Instead of logging into a separate dashboard to check hours, your agent tracks and updates records using tools like `create_attendance` right from your conversation. - Recruiting becomes faster. You can list open jobs (`list_jobs`) and manage candidate applications (`list_applications`) with one prompt, keeping the hiring process moving without manual data entry. - The ability to fetch custom reports means you don't need a dedicated BI tool. Just ask your agent for specific columns or data points from a report you already built in Personio. - You maintain data accuracy because you can use tools like `update_employee` and `create_person` through natural language, eliminating the risk of spreadsheet errors and manual API calls. ## How It Works The bottom line is, you never have to manually export data or jump between multiple HR dashboards again. 1. Subscribe to this MCP on Vinkius and input your required Personio Client ID and Client Secret. 2. Your AI client connects, establishing a secure data channel that allows the agent access to all HR functions. 3. You simply ask your agent conversational questions—like 'list employees in marketing' or 'create an absence record for John Doe on October 1st.' — and get direct actions taken. ## Frequently Asked Questions **How does Personio MCP handle payroll data?** The MCP provides access to custom reporting tools that let you pull specific payroll metrics from your established reports. You ask for the summary, and it fetches the raw, structured data for analysis. **Can I use Personio MCP to list all active employees?** Yes, calling 'list_employees' retrieves a comprehensive roster of every employee currently registered in your system. It’s useful for quick audits or departmental headcounts. **What if I need to change an employee's department?** You can use the `update_employee` tool through your agent. Just tell it which employee needs updating and what the new department is, and it handles the change directly in Personio. **Does Personio MCP help with recruiting job listings?** Yes, you can use 'list_jobs' to see all currently open roles. It also lets you manage applicants by listing candidates using `list_candidates`. **Is updating attendance records difficult with Personio MCP?** No. By using the agent and the `update_attendance` tool, you simply tell it which employee needs their hours changed and what the correct times are; it handles the update immediately.