Integration · Payroll & HR

Connect Claude & ChatGPT to Factorial

Ask your AI who is off next week, how many vacation days an employee has left, or to approve a pending leave in Factorial. It can read employees, teams, locations, time off, attendance, worked time, expenses, documents and recruiting, request, approve or reject time off, clock people in and out, and create and update tasks.

Connect Factorial free

Free plan, no credit card. Takes about a minute.

Try asking

“Who on the sales team is off next week?”
The AI finds the team and lists approved and pending leaves for its members in that week.
“How many vacation days does Peter have left this year?”
It finds Peter and reads his time-off balances: available, used and remaining days per allowance.
“Approve Sofie's pending leave request for June.”
It finds the pending leave and approves it. Sofie is notified.

What your AI can do

Employees and teams

Find and read employees, update personal details, and list teams, locations, legal entities and documents.

Time off and attendance

Request, update, approve or reject leaves, read balances and holidays, clock in and out, and see shifts, worked time and overtime requests.

Recruiting, expenses and tasks

List job postings, candidates and applications, read expenses, and create and update tasks.

“How many hours did the warehouse team work last month?”
It summarizes worked time per employee for the date range.
“Which candidates have applied for the open developer job?”
It finds the job posting and lists its applications and candidates.
“Create a task for Lars to prepare the onboarding pack by Friday.”
It creates the task with a due date and assigns it to Lars.

30 tools for Factorial

These tools are switched on when you connect. You can switch any of them off, or require your approval before it runs.

approve_leaveVisible to othersApprove a pending time-off leave by its id. The employee is notified.
clock_inChanges dataClock an employee in. Requires now (the clock-in time); pass employee_id, and optionally location_type (office, business_trip, work_from_home) and observations.
clock_outChanges dataClock an employee out. Requires now (the clock-out time); pass employee_id and optional observations.
create_leaveChanges dataRequest time off for an employee. Requires employee_id and start_on (YYYY-MM-DD); add finish_on, leave_type_id, half_day and description.
create_taskChanges dataCreate a task with name and status; optionally content, due_on and assignee_ids.
get_documentGet one document by document_id, including its name, folder, employee and file details.
get_employeeGet one employee by employee_id, including contact details, manager, location and legal entity.
get_expenseGet one expense by expense_id, with amount, status, category and receipt details.
get_leaveGet one time-off leave by leaf_id, with its dates, type, employee and approval status.
list_applicationsList job applications, filtered by ats_job_posting_id, ats_candidate_ids, ats_application_phase_id or a search text.
list_attendance_shiftsList clock-in/clock-out attendance shifts. half_day and sort_created_at_asc are required booleans; filter by employee_ids and start_on/end_on dates.
list_candidatesList recruiting candidates, filtered by job_posting_ids, emails, active, archived, team_ids or location_ids.
list_company_holidaysList company holidays, optionally filtered by start_at, end_at, location_ids, team_ids or employee_ids.
list_documentsList employee documents. by_trash_bin and by_pending_assignment are required booleans (false for normal documents); filter by employee_ids or folder_id.
list_employeesList employees. only_active and only_managers are required booleans; filter by full_text_name, emails, team_ids, location_ids or legal_entity_ids. Use to find an employee's ID.
list_expensesList expenses, filtered by employee_ids and from/to dates. include_attachments and include_manual_drafts are required booleans.
list_job_postingsList recruiting job postings, filtered by status, team_id, location_id or legal_entity_id.
list_leave_typesList the time-off leave types (vacation, sick leave and so on), optionally only active or for one employee_id. Use to find a leave_type_id.
list_leavesList time-off leaves. include_deleted_leaves is required; filter by employee_ids, from and to dates, leave_type_id, approved or include_pending.
list_legal_entitiesList the legal entities (the employing companies), optionally filtered by ids or country_ids.
list_locationsList the company's work locations (offices), optionally filtered by ids or employee_ids.
list_overtime_requestsList overtime requests, filtered by employee_ids, status or start_on/end_on dates. include_approval_flow is a required boolean.
list_tasksList tasks, filtered by assignee_id, task_status, due_on or already_due.
list_teamsList the teams in the company, optionally by ids, with their members.
list_time_off_balancesList time-off balances (available, used and remaining days per allowance) for employee_ids, optionally at a reference_date.
list_worked_timesSummarize worked time per employee for a date range (start_on, end_on, employee_ids). include_time_range_category and include_non_attendable_employees are required booleans.
reject_leaveVisible to othersReject a pending time-off leave by its id, with an optional reason. The employee is notified.
update_employeeChanges dataUpdate an employee's personal details, such as name, address, phone, personal email, manager_id or location_id. Pass the employee ID as both employee_id and id; only the fields you pass change.
update_leaveChanges dataUpdate a time-off leave, such as its dates, leave type or description. Pass the leave ID as both leaf_id and id; only the fields you pass change.
update_taskChanges dataUpdate a task's name, status, content, due date or assignees. Pass the task ID as both task_id and id.

Set up in three steps

1
Pick the app
Create a free PipMCP account and choose Factorial from the app list.
2
Paste your key
Paste a Factorial API key. A Factorial admin creates it: in Factorial open Settings > Integrations/API keys, create a new API key and copy it. The key has full company-wide access and does not expire.
3
Add the link to your AI
You get a personal MCP link. Add it to Claude, ChatGPT or Cursor:
1. Click your name, then Settings › Connectors › Add custom connector.
2. Paste your link as the Remote MCP server URL.
3. Switch it on from the + menu in a chat.

Questions

What can the AI do in Factorial?

It can read employees, teams, locations, legal entities, documents, leaves, leave types, time-off balances, company holidays, attendance shifts, worked time, overtime requests, expenses, tasks, job postings, candidates and applications. It can request, update, approve and reject leaves, clock employees in and out, update employee details and create and update tasks.

Does the AI see my Factorial API key?

No. Your Factorial API key is encrypted at rest and never shown to the AI. After you save it, it is not shown again, not even to you. The AI only sees the results of the tools it calls.

Can I control what the AI is allowed to do?

Yes. You choose which tools are switched on, so you can start with lookups only. Approving or rejecting a leave notifies the employee, and updating employee details changes their record, so those tools can require your approval before they run. Every tool call is logged.

Does it work with ChatGPT?

Yes. In ChatGPT, open Settings › Apps & Connectors › Advanced, turn on Developer mode and add your PipMCP link. Developer mode needs a paid ChatGPT plan: Plus, Pro, Business or Enterprise. The same link also works in Claude (Settings › Connectors › Add custom connector), Cursor and other MCP clients.

What does it cost?

PipMCP has a free plan with no credit card required. Paid plans bill per completed task. You also need your own Factorial account.

Who can create the Factorial API key?

A Factorial admin, under Settings > Integrations/API keys. The key has full company-wide access and does not expire, so the tools you switch on in PipMCP are what limits the AI. Start with the lookups you need and add more later.