Connectors · Accounting & finance
Factorial MCP server for AI agents.
actionlake is an MCP gateway: one remote MCP server that connects Claude and other MCP clients to Factorial and the rest of your systems. It gives your agent 608 Factorial actions (317 reads, 221 writes and 70 that wait for a confirmation) and holds the Factorial credential itself, so the agent never does. It paces Factorial's limits and records every call.
100,000 free calls a month. No card, no email, no password: press Start a free sandbox on the next screen and keep the key it shows you.
claude mcp add --transport http actionlake https://connect.actionlake.com/mcpdo { action: "factorial.locations.list", intent: "check which Factorial account is connected"}# Reads all Locations · read · 1 upstream call- 608actionsin one signed file
- 317readlook, never change
- 221writecreate and update
- 70wait for a yesdestructive, confirmed first
Set up
Connect Factorial in three steps.
- 01
Add actionlake to Claude.
Run the command once in Claude Code; its consent page can create a free sandbox: 100,000 calls a month, no card. In the Claude app, add a custom connector with the URL below and paste your key on the consent page. Creating a new sandbox from the Claude app is not yet tested by us.
https://connect.actionlake.com/mcp - 02
Connect Factorial.
API key. No consent screen: your agent can connect it for you, but the key then passes through your chat. To keep it out of the model's context, paste it in the console instead. actionlake stores what you paste write-only, sealed under your tenant's key.
api_keyFactorial API key: an admin opens Settings > Integrations > API keys (Developers) in Factorial, creates a key and…hostWhere your Factorial lives: your host
account { op: "connections.requirements", service: "factorial" } # free: exactly what to paste, and what is found for you - 03
Make the first call. Check before a write.
Ask in plain words; Claude picks the action. Before anything changes,
checkvalidates the call and prices it, for free.do { action: "factorial.locations.list" }# reads all locations · read · 1 upstream callcheck { action: "factorial.locations.create", input: { … } }# free: inputs, permissions, cost and confirmations, nothing sent
Factorial at a glance
- Sign-in
- API key. No consent screen: your agent can connect it for you, but the key then passes through your chat. To keep it out of the model's context, paste it in the console instead.
- You provide
api_key- Setup fields
host- Limits we pace to
- 100 calls a minute, per connection
- API covered
- Factorial API 2026-10-01 (OpenAPI 3.1.0)
api.factorialhr.com - Built from
- Factorial's documentation, read 23 October 2026api.factorialhr.comapidoc.factorialhr.com
- Service file
- Version 1.0.0, signed (Ed25519)
- Cached reads
- 315 of 317 reads, for up to 5 minutes; a write clears what it affects
- Shared entities
- 7, so ask can line Factorial up with your other systems
- Data
- Processed and stored in Sydney, Australia. No US region yet
Capabilities
What an AI agent can do in Factorial.
608 actions in 38 areas. Every one carries its effect, so a key can allow the reads and hold the rest.
- 317readlook, never change
- 221writecreate and update
- 70destructivewait for a confirmation
Performance
5624 read · 27 write · 5 destructive
Bulk initiates an Agreement · Initiates an Agreement · Reads all Agreements · Reads all Company employee score scales
Project management
5021 read · 21 write · 8 destructive
Reads all Projects · Creates a Project · Reads a single Project · Updates a Project
ATS
4424 read · 15 write · 5 destructive
Reads all Candidates · Creates a Candidate · Reads a single Candidate · Updates a Candidate
Timeoff
4318 read · 16 write · 9 destructive
Creates a Leave · Reads all Leaves · Reads all Leave types · Reads a single Leave
Contracts
4130 read · 9 write · 2 destructive
Creates a Compensation · Reads all Compensations · List the activity periods of a contract · Reads all Contract templates
Finance
4125 read · 15 write · 1 destructive
Reads all Tax rates · Reads all Journal entries · Creates a Tax rate · Creates a Journal entry
Attendance
3413 read · 17 write · 4 destructive
Creates a shift · Reads all Shifts · Updates a Shift · Reads a single Shift
Trainings
3414 read · 13 write · 7 destructive
Reads all Trainings · Creates a Training · Reads a single Training · Updates a Training
30 more areas · 265 actions
- Compensations 23
- Procurement 18
- Posts 16
- Custom fields 14
- Tasks 13
- Work schedule 13
- Employee updates 12
- Teams 12
- Documents 11
- It management 11
- Locations 11
- Expenses 10
- Integrations 9
- Payroll 9
- Payroll employees 9
- Custom resources 8
- Employees 8
- Time planning 8
- Banking 7
- API public 6
- Job catalog 6
- Shift management 6
- Time settings 6
- Payroll integrations base 4
- Bookkeepers management 3
- Companies 3
- Processes 3
- Approvals 2
- Holidays 2
- Marketplace 2
Top actions
The Factorial API, shaped for agents.
The ids your agent types, what each does, and the one name it shares with other systems. 83 of Factorial's 83 action names are shared with at least one other connector, so an agent learns them once.
| Action | What it does | Effect | Same name in |
|---|---|---|---|
factorial.employees.listReads all Employees | Reads all Employees. | read | hr.employee.list61 connectors |
factorial.locations.listReads all Locations | Reads all Locations. | read | hr.location.list32 connectors |
factorial.candidates.listReads all Candidates | Reads all Candidates. | read | hr.candidate.list22 connectors |
factorial.expenses.listReads all Expenses | Reads all Expenses. | read | finance.expense.list40 connectors |
factorial.tasks.listReads all Tasks | Reads all Tasks. | read | work.task.list122 connectors |
factorial.projects.listReads all Projects | Reads all Projects. | read | work.project.list109 connectors |
factorial.employees.getReads a single Employee | Reads a single Employee. | read | hr.employee.get58 connectors |
factorial.locations.createCreates a Location | Creates a Location. | write | hr.location.create23 connectors |
factorial.candidates.createCreates a Candidate | Creates a Candidate. | write | hr.candidate.create20 connectors |
factorial.tasks.createCreates a Task | Creates a Task. | write | work.task.create127 connectors |
factorial.projects.createCreates a Project | Creates a Project. | write | work.project.create102 connectors |
factorial.locations.deleteDeletes a Location | Deletes a Location. | destructive | hr.location.delete20 connectors |
Try it
Prompts to paste into Claude.
Each one names the Factorial actions it will call, so you know what it reads and what it changes before you send it.
- Readread
Which Factorial tasks are overdue, and who owns each one?
calls
factorial.tasks.list - Writewrite
Creates a Location in Factorial. Show me exactly what you will send before you save it.
calls
factorial.locations.create
Governance for Factorial
Destructive actions wait for a yes.
70 Factorial actions are destructive. The first 10:
- Deletes a Location
factorial.locations.delete - Deletes a Candidate
factorial.candidates.delete - Deletes a Task
factorial.tasks.delete - Deletes a Leave
factorial.leaves.delete - Deletes a Shift
factorial.shift_management_shifts.delete - Deletes a Shift
factorial.attendance_shifts.delete - Deletes a Training
factorial.trainings.delete - Deletes an Application
factorial.applications.delete - Deletes a Job posting
factorial.job_postings.delete - Deletes a Time record
factorial.time_records.delete
A destructive action runs only with confirm: true. Under the human policy the agent cannot confirm for itself: the run stops until a named person approves, in the console or from a signed link in an email. The cap on a key is refused before the call is sent, never after.
Deletes a Location?
intent: the user asked me to deletes a Location
account { op: "keys.create", name: "factorial-agent", allowed_actions: ["factorial.*"], cap_calls: 2000, confirm_policy: "human_for_writes", approval_rules: [ { match: "factorial.locations.delete", approver: "[email protected]" }, { match: "factorial.candidates.delete", approver: "[email protected]" }, { match: "factorial.tasks.delete", approver: "[email protected]" } ]}Cost
What Factorial costs on actionlake.
Every Factorial action is one upstream call, the only thing actionlake bills. Searching, check, cost, account and any call Factorial refused with 401, 403, 429 or a 5xx are free. Paid plans start at US$49 a month for 250,000 calls, with overage from US$0.30 down to US$0.18 per 1,000.
- 1upstream call per actionall 608 Factorial actions
- 608actions pageeach page of a long list is one call
- 315reads can be cacheda cache hit costs nothing
- 100,000calls a month, freepaid plans from US$49 a month for 250,000
Action index
Every Factorial action.
608 actions by area: the id your agent calls, what it does, and its effect.
Performance56
factorial.agreements.bulk_initiateBulk initiates an Agreementwritefactorial.agreements.initiateInitiates an Agreementwritefactorial.agreements.listReads all Agreementsreadfactorial.company_employee_score_scales.listReads all Company employee score scalesreadfactorial.agreements.getReads a single Agreementreadfactorial.company_employee_score_scales.getReads a single Company employee score scaleread- and 50 more in this area
Project management50
factorial.projects.createCreates a Projectwritefactorial.projects.getReads a single Projectreadfactorial.projects.listReads all Projectsreadfactorial.projects.updateUpdates a Projectwritefactorial.budget_strategies.createCreates a Budget strategywritefactorial.budget_strategies.deleteDeletes a Budget strategydestructive- and 44 more in this area
ATS44
factorial.candidates.createCreates a Candidatewritefactorial.candidates.getReads a single Candidatereadfactorial.candidates.listReads all Candidatesreadfactorial.candidates.updateUpdates a Candidatewritefactorial.answers.createCreates an Answerwritefactorial.answers.getReads a single Answerread- and 38 more in this area
Timeoff43
factorial.leave_types.listReads all Leave typesreadfactorial.leaves.createCreates a Leavewritefactorial.leaves.getReads a single Leavereadfactorial.leaves.listReads all Leavesreadfactorial.allowance_incidences.createCreates an Allowance incidencewritefactorial.allowance_incidences.deleteDeletes an Allowance incidencedestructive- and 37 more in this area
Contracts41
factorial.compensations.createCreates a Compensationwritefactorial.compensations.listReads all Compensationsreadfactorial.contract_activity_periods.listList the activity periods of a contractreadfactorial.contract_templates.listReads all Contract templatesreadfactorial.compensations.deleteDeletes a Compensationdestructivefactorial.compensations.getReads a single Compensationread- and 35 more in this area
Finance41
factorial.journal_entries.createCreates a Journal entrywritefactorial.journal_entries.listReads all Journal entriesreadfactorial.tax_rates.createCreates a Tax ratewritefactorial.tax_rates.listReads all Tax ratesreadfactorial.accounting_settings.getReads a single Accounting settingreadfactorial.accounting_settings.listReads all Accounting settingsread- and 35 more in this area
Attendance34
factorial.attendance_shifts.createCreates a shiftwritefactorial.attendance_shifts.getReads a single Shiftreadfactorial.attendance_shifts.listReads all Shiftsreadfactorial.attendance_shifts.updateUpdates a Shiftwritefactorial.attendance_break_configurations.createCreates a Break configurationwritefactorial.attendance_break_configurations.getReads a single Break configurationread- and 28 more in this area
Trainings34
factorial.trainings.createCreates a Trainingwritefactorial.trainings.getReads a single Trainingreadfactorial.trainings.listReads all Trainingsreadfactorial.trainings.updateUpdates a Trainingwritefactorial.session_access_memberships.bulk_createBulk creates a Session access membershipwritefactorial.session_access_memberships.bulk_destroyBulk destroys a Session access membershipdestructive- and 28 more in this area
Compensations23
factorial.additional_compensations.createCreates an Additional compensationwritefactorial.additional_compensations.listReads all Additional compensationsreadfactorial.payroll_runs.getReads a single Payroll runreadfactorial.payroll_runs.listReads all Payroll runsreadfactorial.additional_compensations.deleteDeletes an Additional compensationdestructivefactorial.additional_compensations.getReads a single Additional compensationread- and 17 more in this area
Procurement18
factorial.purchase_orders.createCreates a Purchase orderwritefactorial.purchase_orders.getReads a single Purchase orderreadfactorial.purchase_orders.listReads all Purchase ordersreadfactorial.purchase_orders.updateUpdates a Purchase orderwritefactorial.po_field_values.getReads a single Po field valuereadfactorial.po_field_values.listReads all Po field valuesread- and 12 more in this area
Posts16
factorial.comments.createCreates a Commentwritefactorial.comments.listReads all Commentsreadfactorial.groups.createCreates a Groupwritefactorial.groups.listReads all Groupsreadfactorial.comments.deleteDeletes a Commentdestructivefactorial.comments.getReads a single Commentread- and 10 more in this area
Custom fields14
factorial.custom_fields_values.createCreates a Valuewritefactorial.custom_fields_values.listReads all Valuesreadfactorial.fields.createCreates a Fieldwritefactorial.fields.listReads all Fieldsreadfactorial.custom_fields_values.getReads a single Valuereadfactorial.custom_fields_values.updateUpdates a Valuewrite- and 8 more in this area
Tasks13
factorial.tasks.createCreates a Taskwritefactorial.tasks.getReads a single Taskreadfactorial.tasks.listReads all Tasksreadfactorial.tasks.updateUpdates a Taskwritefactorial.task_files.deleteDeletes a Task filedestructivefactorial.task_files.getReads a single Task fileread- and 7 more in this area
Work schedule13
factorial.day_configurations.listReads all Day configurationsreadfactorial.overlap_periods.createCreates an Overlap periodwritefactorial.overlap_periods.listReads all Overlap periodsreadfactorial.schedules.createCreates a Schedulewritefactorial.day_configurations.bulk_cudBulk cuds a Day configurationwritefactorial.day_configurations.getReads a single Day configurationread- and 7 more in this area
Employee updates12
factorial.absences.listReads all Absencesreadfactorial.contract_changes.listReads all Contract changesreadfactorial.new_hires.listReads all New hiresreadfactorial.personal_changes.listReads all Personal changesreadfactorial.absences.getReads a single Absencereadfactorial.contract_changes.getReads a single Contract changeread- and 6 more in this area
Teams12
factorial.memberships.createCreates a Membershipwritefactorial.memberships.listReads all Membershipsreadfactorial.teams.createCreates a Teamwritefactorial.teams.listReads all Teamsreadfactorial.memberships.deleteDeletes a Membershipdestructivefactorial.memberships.getReads a single Membershipread- and 6 more in this area
Documents11
factorial.folders.createCreates a Folderwritefactorial.folders.getReads a single Folderreadfactorial.folders.listReads all Foldersreadfactorial.folders.updateUpdates a Folderwritefactorial.documents.deleteDeletes a Documentdestructivefactorial.documents.getReads a single Documentread- and 5 more in this area
It management11
factorial.asset_categories.listReads all Asset categoriesreadfactorial.it_asset_models.createCreates an It asset modelwritefactorial.it_asset_models.listReads all It asset modelsreadfactorial.it_assets.createCreates an It assetwritefactorial.asset_categories.getReads a single Asset categoryreadfactorial.it_asset_models.getReads a single It asset modelread- and 5 more in this area
Locations11
factorial.locations.createCreates a Locationwritefactorial.locations.getReads a single Locationreadfactorial.locations.listReads all Locationsreadfactorial.locations.updateUpdates a Locationwritefactorial.locations.deleteDeletes a Locationdestructivefactorial.work_areas.archiveArchives a Work areawrite- and 5 more in this area
Expenses10
factorial.expensables.listReads all Expensablesreadfactorial.expenses.getReads a single Expensereadfactorial.expenses.listReads all Expensesreadfactorial.mileages.listReads all Mileagesreadfactorial.expensables.bulk_set_to_paidBulk set to paids an Expensabledestructivefactorial.expensables.getReads a single Expensableread- and 4 more in this area
Integrations9
factorial.sync_runs.createCreates a Sync runwritefactorial.sync_runs.listReads all Sync runsreadfactorial.syncable_states.listReads all Syncable statesreadfactorial.syncable_sync_runs.listReads all Syncable sync runsreadfactorial.sync_runs.getReads a single Sync runreadfactorial.syncable_states.getReads a single Syncable stateread- and 3 more in this area
Payroll9
factorial.family_situations.createCreates a Family situationwritefactorial.family_situations.listReads all Family situationsreadfactorial.supplements.createCreates a Supplementwritefactorial.supplements.listReads all Supplementsreadfactorial.family_situations.updateUpdates a Family situationwritefactorial.policy_periods.change_statusChange statuses a Policy periodwrite- and 3 more in this area
Payroll employees9
factorial.german_employee_data.createCreates a German employee datumwritefactorial.german_employee_data.listReads all German employee datareadfactorial.identifiers.createCreates an Identifierwritefactorial.identifiers.listReads all Identifiersreadfactorial.german_employee_data.getReads a single German employee datumreadfactorial.german_employee_data.updateUpdates a German employee datumwrite- and 3 more in this area
Custom resources8
factorial.custom_resources_values.createCreates a Valuewritefactorial.custom_resources_values.listReads all Valuesreadfactorial.resources.listReads all Resourcesreadfactorial.schemas.createCreates a Schemawritefactorial.custom_resources_values.getReads a single Valuereadfactorial.resources.getReads a single Resourceread- and 2 more in this area
Employees8
factorial.employees.create_with_contractCreate with contracts an Employeewritefactorial.employees.getReads a single Employeereadfactorial.employees.listReads all Employeesreadfactorial.employees.updateUpdates an Employeewritefactorial.employees.inviteInvites an Employeewritefactorial.employees.set_regular_access_start_dateSet regular access start dates an Employeewrite- and 2 more in this area
Time planning8
factorial.planned_breaks.bulk_createBulk creates a Planned breakwritefactorial.planned_breaks.listReads all Planned breaksreadfactorial.planning_versions.bulk_createBulk creates a Planning versionwritefactorial.planning_versions.createCreates a Planning versionwritefactorial.planned_breaks.getReads a single Planned breakreadfactorial.planning_versions.deleteDeletes a Planning versiondestructive- and 2 more in this area
Banking7
factorial.bank_accounts.create_manualCreate manuals a Bank accountwritefactorial.bank_accounts.listReads all Bank accountsreadfactorial.transactions.getReads a single Transactionreadfactorial.transactions.listReads all Transactionsreadfactorial.bank_accounts.getReads a single Bank accountreadfactorial.card_payments.getReads a single Card paymentread- and 1 more in this area
API public6
factorial.credentials.listReads all Credentialsreadfactorial.webhook_subscriptions.createCreates a Webhook subscriptionwritefactorial.webhook_subscriptions.getReads a single Webhook subscriptionreadfactorial.webhook_subscriptions.listReads all Webhook subscriptionsreadfactorial.webhook_subscriptions.deleteDeletes a Webhook subscriptiondestructivefactorial.webhook_subscriptions.updateUpdates a Webhook subscriptionwrite
Job catalog6
factorial.levels.listReads all Levelsreadfactorial.node_attributes.listReads all Node attributesreadfactorial.roles.listReads all Rolesreadfactorial.tree_nodes.listReads all Tree nodesreadfactorial.levels.getReads a single Levelreadfactorial.roles.getReads a single Roleread
Shift management6
factorial.shift_management_shifts.createCreates a Shiftwritefactorial.shift_management_shifts.deleteDeletes a Shiftdestructivefactorial.shift_management_shifts.getReads a single Shiftreadfactorial.shift_management_shifts.listReads all Shiftsreadfactorial.shift_management_shifts.bulk_createBulk creates a Shiftwritefactorial.shift_management_shifts.bulk_deleteBulk deletes a Shiftdestructive
Time settings6
factorial.split_custom_time_range_categories.getReads a single Split custom time range categoryreadfactorial.split_custom_time_range_categories.listReads all Split custom time range categoriesreadfactorial.time_settings_break_configurations.createCreates a Break configurationwritefactorial.time_settings_break_configurations.listReads all Break configurationsreadfactorial.time_settings_break_configurations.getReads a single Break configurationreadfactorial.time_settings_break_configurations.updateUpdates a Break configurationwrite
Payroll integrations base4
factorial.codes.createCreates a Codewritefactorial.codes.deleteDeletes a Codedestructivefactorial.codes.listReads all Codesreadfactorial.codes.updateUpdates a Codewrite
Bookkeepers management3
factorial.incidences.getReads a single Incidencereadfactorial.incidences.listReads all Incidencesreadfactorial.incidences.updateUpdates an Incidencewrite
Companies3
factorial.legal_entities.createCreates a Legal entitywritefactorial.legal_entities.getReads a single Legal entityreadfactorial.legal_entities.listReads all Legal entitiesread
Processes3
factorial.materialized_processes.createCreates a Materialized processwritefactorial.processes.getReads a single Processreadfactorial.processes.listReads all Processesread
Approvals2
factorial.materialized_approvals_flows.approve_resourceApproves an approval flow by resourcedestructivefactorial.materialized_approvals_flows.reject_resourceRejects an approval flow by resourcewrite
Holidays2
factorial.company_holidays.getReads a single Company holidayreadfactorial.company_holidays.listReads all Company holidaysread
Marketplace2
factorial.installation_settings.listReads all Installation settingsreadfactorial.installations.createCreates an Installationwrite
This index shows a sample of each area. All 608 actions, with their inputs and prices, are in the catalogue, which a free sandbox key can search.
Questions
The Factorial MCP server, answered.
Is there a Factorial MCP server for Claude?
Yes. actionlake is an MCP gateway: a remote MCP server that gives Claude, or another MCP client, 608 Factorial actions across performance, project management, ATS and timeoff, through the same eight tools it uses for every other connector. actionlake is independent; it is not made or endorsed by Factorial.
What do I need to connect Factorial?
Factorial API key: an admin opens Settings > Integrations > API keys (Developers) in Factorial, creates a key and…. Plus your host. The free call account { op: "connections.requirements", service: "factorial" } lists exactly what to paste.
Can an AI agent delete or change things in Factorial?
Only if its key allows it, and only with an explicit confirmation. 70 Factorial actions are destructive, including deletes a Location, deletes a Candidate and deletes a Task. Each runs only with confirm: true. Under the human confirm policy, or an approval rule on the key, the run waits until a named person approves it.
Will an AI agent use up my Factorial API limit?
actionlake paces every call to the limits in the Factorial service file: 100 calls a minute per connection. Repeated reads are answered from cache (315 Factorial actions can be), which never reaches Factorial.
What does a Factorial action cost?
One upstream call, the only unit actionlake bills. A list that pages bills one call per page (608 Factorial actions page). Cache hits, searches, dry runs and calls Factorial refused with 401, 403, 429 or a 5xx are free. The Free plan includes 100,000 calls a month with no card. Paid plans start at US$49 a month for 250,000 calls, with overage from US$0.30 down to US$0.18 per 1,000.
Which Factorial API does it cover?
The Factorial API 2026-10-01 (OpenAPI 3.1.0) at api.factorialhr.com by default, or the base URL set when you connect. It is built from Factorial's documentation as read on 23 October 2026. 608 actions in 38 areas, each one in the signed service file (version 1.0.0).
Does actionlake keep my Factorial data, and where?
actionlake processes and stores data in Sydney, Australia; there is no US region yet. Reads may be cached for up to 5 minutes, and a write clears the reads it affects. Each run's request and response is kept, sealed, for your plan's trace window: 1 day on Free, 3 days on Starter, 7 days on Pro, 14 days on Team, 30 days on Business and 30 days on Enterprise. Your Factorial credential is sealed under your tenant's key, never logged and never returned. Your traffic is not used to train models.
Which AI clients can use it?
Claude Code, tested by us end to end, and the Claude app as a custom connector, tested by us with an existing key. Other MCP clients that support remote servers over Streamable HTTP (MCP revisions 2025-06-18 and 2025-11-25) and OAuth dynamic client registration, or a bearer header, should connect the same way; we have not tested them. Or plain REST, under the same action names.
Give your agent Factorial today.
Start free - 100,000 calls/month, no card. No signup. Hard caps on every key. Cached answers are free.