Connectors · Work & projects
Humaans MCP server for AI agents.
actionlake is an MCP gateway: one remote MCP server that connects Claude and other MCP clients to Humaans and the rest of your systems. It gives your agent 165 Humaans actions (81 reads, 56 writes and 28 that wait for a confirmation) and holds the Humaans credential itself, so the agent never does. It paces Humaans'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: "humaans.people.list", intent: "check which Humaans account is connected"}# List all people · read · 1 upstream call- 165actionsin one signed file
- 81readlook, never change
- 56writecreate and update
- 28wait for a yesdestructive, confirmed first
Set up
Connect Humaans 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 Humaans.
Bearer token. 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.
tokenHumaans API access token (Settings > API access tokens)
account { op: "connections.requirements", service: "humaans" } # 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: "humaans.people.list" }# list all people · read · 1 upstream callcheck { action: "humaans.people.create", input: { … } }# free: inputs, permissions, cost and confirmations, nothing sent
Humaans at a glance
- Sign-in
- Bearer token. 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
token- Limits we pace to
- 400 calls a minute, per connection
- API covered
- Humaans REST API (unversioned; https://app.humaans.io/api)
app.humaans.io - Built from
- Humaans's documentation, read 23 October 2026docs.humaans.io
- Service file
- Version 1.0.0, signed (Ed25519)
- Cached reads
- 72 of 81 reads, for up to 5 minutes; a write clears what it affects
- Shared entities
- 3, so ask can line Humaans up with your other systems
- Data
- Processed and stored in Sydney, Australia. No US region yet
Capabilities
What an AI agent can do in Humaans.
165 actions in 46 areas. Every one carries its effect, so a key can allow the reads and hold the rest.
- 81readlook, never change
- 56writecreate and update
- 28destructivewait for a confirmation
Bank accounts
52 read · 2 write · 1 destructive
List all bank accounts · Create a bank account · Update a bank account · Retrieve a bank account
Compensations
52 read · 2 write · 1 destructive
List all compensations · Create a compensation · Retrieve a compensation · Update a compensation
Custom fields
52 read · 2 write · 1 destructive
Create a custom field · List all custom fields · Retrieve a custom field · Update a custom field
Custom values
52 read · 2 write · 1 destructive
Create a custom value · List all custom values · Retrieve a custom value · Update a custom value
Documents
52 read · 2 write · 1 destructive
List all documents · Update a document · Delete a document · Retrieve a document
Emergency contacts
52 read · 2 write · 1 destructive
Create an emergency contact · List all emergency contacts · Retrieve an emergency contact · Update an emergency contact
Equipment
52 read · 2 write · 1 destructive
Create an equipment · List all equipment · Retrieve an equipment · Update an equipment
Identity documents
52 read · 2 write · 1 destructive
Create an identity document · List all identity documents · Retrieve an identity document · Update an identity document
38 more areas · 125 actions
- Job library levels 5
- Job library profiles 5
- Job library roles 5
- Job roles 5
- Locations 5
- People 5
- Public holiday calendar days 5
- Spaces 5
- Time away 5
- Time away adjustments 5
- Time away allocations 5
- Time away policies 5
- Time away types 5
- Timesheet entries 5
- Timesheet submissions 5
- Webhooks 5
- Working pattern allocations 5
- Working patterns 5
- Document types 4
- Companies 3
- Data exports 3
- Compensation types 2
- Org hierarchies 2
- Org unit assignments 2
- Org units 2
- Performance cycle instances 2
- Performance cycle review templates 2
- Performance cycle reviews 2
- Performance cycles 2
- Equipment names 1
- Equipment types 1
- Files 1
- Identity document types 1
- Me 1
- Public holiday calendars 1
- Public holidays 1
- Time away periods 1
- Token info 1
Top actions
The Humaans API, shaped for agents.
The ids your agent types, what each does, and the one name it shares with other systems. 42 of Humaans's 42 action names are shared with at least one other connector, so an agent learns them once.
| Action | What it does | Effect | Same name in |
|---|---|---|---|
humaans.people.listList all people | List all people. | read | hr.employee.list61 connectors |
humaans.locations.listList all locations | List all locations. | read | hr.location.list32 connectors |
humaans.people.createCreate a person | Create a person. | write | hr.employee.create51 connectors |
humaans.locations.createCreate a location | Create a location. | write | hr.location.create23 connectors |
humaans.people.deleteDelete a person | Delete a person. | destructive | hr.employee.delete34 connectors |
humaans.time_away.createCreate a time away | Create a time away. | write | hr.leave_request.create32 connectors |
humaans.me.getRetrieve me | Retrieve me. | read | identity.current_user.get307 connectors |
humaans.time_away.listList all time away | List all time away. | read | hr.leave_request.list29 connectors |
humaans.time_away_types.listList all time away types | List all time away types. | read | hr.leave_type.list23 connectors |
humaans.timesheet_entries.createCreate a timesheet entry | Create a timesheet entry. | write | hr.time_clock_entry.create17 connectors |
humaans.timesheet_entries.listList all timesheet entries | List all timesheet entries. | read | hr.time_clock_entry.list15 connectors |
humaans.compensations.listList all compensations | List all compensations. | read | hr.compensation.list9 connectors |
Try it
Prompts to paste into Claude.
Each one names the Humaans actions it will call, so you know what it reads and what it changes before you send it.
- Readread
List everyone in Humaans with their department and start date.
calls
humaans.people.list - Writewrite
Create a person in Humaans. Show me exactly what you will send before you save it.
calls
humaans.people.create
Governance for Humaans
Destructive actions wait for a yes.
28 Humaans actions are destructive. These are all of them:
- Delete a person
humaans.people.delete - Delete a location
humaans.locations.delete - Delete a time away
humaans.time_away.delete - Delete a timesheet entry
humaans.timesheet_entries.delete - Delete a time away type
humaans.time_away_types.delete - Delete a document
humaans.documents.delete - Delete a compensation
humaans.compensations.delete - Delete a bank account
humaans.bank_accounts.delete - Delete a space
humaans.spaces.delete - Delete a webhook
humaans.webhooks.delete - Delete an equipment
humaans.equipment.delete - Delete a job role
humaans.job_roles.delete - Delete a data export
humaans.data_exports.delete - Delete a custom field
humaans.custom_fields.delete - Delete a custom value
humaans.custom_values.delete - Delete a document type
humaans.document_types.delete - Delete a working pattern
humaans.working_patterns.delete - Delete a job library role
humaans.job_library_roles.delete - Delete an emergency contact
humaans.emergency_contacts.delete - Delete an identity document
humaans.identity_documents.delete - Delete a job library level
humaans.job_library_levels.delete - Delete a time away policy
humaans.time_away_policies.delete - Delete a job library profile
humaans.job_library_profiles.delete - Delete a time away adjustment
humaans.time_away_adjustments.delete - Delete a time away allocation
humaans.time_away_allocations.delete - Delete a timesheet submission
humaans.timesheet_submissions.delete - Delete a working pattern allocation
humaans.working_pattern_allocations.delete - Delete a Public holiday calendar day
humaans.public_holiday_calendar_days.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.
Delete a person?
intent: the user asked me to delete a person
account { op: "keys.create", name: "humaans-agent", allowed_actions: ["humaans.*"], cap_calls: 2000, confirm_policy: "human_for_writes", approval_rules: [ { match: "humaans.people.delete", approver: "[email protected]" }, { match: "humaans.locations.delete", approver: "[email protected]" }, { match: "humaans.time_away.delete", approver: "[email protected]" } ]}Cost
What Humaans costs on actionlake.
Every Humaans action is one upstream call, the only thing actionlake bills. Searching, check, cost, account and any call Humaans 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 165 Humaans actions
- 165actions pageeach page of a long list is one call
- 72reads can be cacheda cache hit costs nothing
- 100,000calls a month, freepaid plans from US$49 a month for 250,000
Action index
Every Humaans action.
165 actions by area: the id your agent calls, what it does, and its effect.
Bank accounts5
humaans.bank_accounts.createCreate a bank accountwritehumaans.bank_accounts.deleteDelete a bank accountdestructivehumaans.bank_accounts.getRetrieve a bank accountreadhumaans.bank_accounts.listList all bank accountsreadhumaans.bank_accounts.updateUpdate a bank accountwrite
Compensations5
humaans.compensations.createCreate a compensationwritehumaans.compensations.deleteDelete a compensationdestructivehumaans.compensations.getRetrieve a compensationreadhumaans.compensations.listList all compensationsreadhumaans.compensations.updateUpdate a compensationwrite
Custom fields5
humaans.custom_fields.createCreate a custom fieldwritehumaans.custom_fields.deleteDelete a custom fielddestructivehumaans.custom_fields.getRetrieve a custom fieldreadhumaans.custom_fields.listList all custom fieldsreadhumaans.custom_fields.updateUpdate a custom fieldwrite
Custom values5
humaans.custom_values.createCreate a custom valuewritehumaans.custom_values.deleteDelete a custom valuedestructivehumaans.custom_values.getRetrieve a custom valuereadhumaans.custom_values.listList all custom valuesreadhumaans.custom_values.updateUpdate a custom valuewrite
Documents5
humaans.documents.createCreate a documentwritehumaans.documents.deleteDelete a documentdestructivehumaans.documents.getRetrieve a documentreadhumaans.documents.listList all documentsreadhumaans.documents.updateUpdate a documentwrite
Emergency contacts5
humaans.emergency_contacts.createCreate an emergency contactwritehumaans.emergency_contacts.deleteDelete an emergency contactdestructivehumaans.emergency_contacts.getRetrieve an emergency contactreadhumaans.emergency_contacts.listList all emergency contactsreadhumaans.emergency_contacts.updateUpdate an emergency contactwrite
Equipment5
humaans.equipment.createCreate an equipmentwritehumaans.equipment.deleteDelete an equipmentdestructivehumaans.equipment.getRetrieve an equipmentreadhumaans.equipment.listList all equipmentreadhumaans.equipment.updateUpdate an equipmentwrite
Identity documents5
humaans.identity_documents.createCreate an identity documentwritehumaans.identity_documents.deleteDelete an identity documentdestructivehumaans.identity_documents.getRetrieve an identity documentreadhumaans.identity_documents.listList all identity documentsreadhumaans.identity_documents.updateUpdate an identity documentwrite
Job library levels5
humaans.job_library_levels.createCreate a job library levelwritehumaans.job_library_levels.deleteDelete a job library leveldestructivehumaans.job_library_levels.getRetrieve a job library levelreadhumaans.job_library_levels.listList all job library levelsreadhumaans.job_library_levels.updateUpdate a job library levelwrite
Job library profiles5
humaans.job_library_profiles.createCreate a job library profilewritehumaans.job_library_profiles.deleteDelete a job library profiledestructivehumaans.job_library_profiles.getRetrieve a job library profilereadhumaans.job_library_profiles.listList all job library profilesreadhumaans.job_library_profiles.updateUpdate a job library profilewrite
Job library roles5
humaans.job_library_roles.createCreate a job library rolewritehumaans.job_library_roles.deleteDelete a job library roledestructivehumaans.job_library_roles.getRetrieve a job library rolereadhumaans.job_library_roles.listList all job library rolesreadhumaans.job_library_roles.updateUpdate a job library rolewrite
Job roles5
humaans.job_roles.createCreate a job rolewritehumaans.job_roles.deleteDelete a job roledestructivehumaans.job_roles.getRetrieve a job rolereadhumaans.job_roles.listList all job rolesreadhumaans.job_roles.updateUpdate a job rolewrite
Locations5
humaans.locations.createCreate a locationwritehumaans.locations.deleteDelete a locationdestructivehumaans.locations.getRetrieve a locationreadhumaans.locations.listList all locationsreadhumaans.locations.updateUpdate a locationwrite
People5
humaans.people.createCreate a personwritehumaans.people.deleteDelete a persondestructivehumaans.people.getRetrieve a personreadhumaans.people.listList all peoplereadhumaans.people.updateUpdate a personwrite
Public holiday calendar days5
humaans.public_holiday_calendar_days.createCreate a Public holiday calendar daywritehumaans.public_holiday_calendar_days.deleteDelete a Public holiday calendar daydestructivehumaans.public_holiday_calendar_days.getRetrieve a Public holiday calendar dayreadhumaans.public_holiday_calendar_days.listList all Public holiday calendar daysreadhumaans.public_holiday_calendar_days.updateUpdate a Public holiday calendar daywrite
Spaces5
humaans.spaces.createCreate a spacewritehumaans.spaces.deleteDelete a spacedestructivehumaans.spaces.getRetrieve a spacereadhumaans.spaces.listList all spacesreadhumaans.spaces.updateUpdate a spacewrite
Time away5
humaans.time_away.createCreate a time awaywritehumaans.time_away.deleteDelete a time awaydestructivehumaans.time_away.getRetrieve a time awayreadhumaans.time_away.listList all time awayreadhumaans.time_away.updateUpdate a time awaywrite
Time away adjustments5
humaans.time_away_adjustments.createCreate a time away adjustmentwritehumaans.time_away_adjustments.deleteDelete a time away adjustmentdestructivehumaans.time_away_adjustments.getRetrieve a time away adjustmentreadhumaans.time_away_adjustments.listList all time away adjustmentsreadhumaans.time_away_adjustments.updateUpdate a time away adjustmentwrite
Time away allocations5
humaans.time_away_allocations.createCreate a time away allocationwritehumaans.time_away_allocations.deleteDelete a time away allocationdestructivehumaans.time_away_allocations.getRetrieve a time away allocationreadhumaans.time_away_allocations.listList all time away allocationsreadhumaans.time_away_allocations.updateUpdate a time away allocationwrite
Time away policies5
humaans.time_away_policies.createCreate a time away policywritehumaans.time_away_policies.deleteDelete a time away policydestructivehumaans.time_away_policies.getRetrieve a time away policyreadhumaans.time_away_policies.listList all time away policiesreadhumaans.time_away_policies.updateUpdate a time away policywrite
Time away types5
humaans.time_away_types.createCreate a time away typewritehumaans.time_away_types.deleteDelete a time away typedestructivehumaans.time_away_types.getRetrieve a time away typereadhumaans.time_away_types.listList all time away typesreadhumaans.time_away_types.updateUpdate a time away typewrite
Timesheet entries5
humaans.timesheet_entries.createCreate a timesheet entrywritehumaans.timesheet_entries.deleteDelete a timesheet entrydestructivehumaans.timesheet_entries.getRetrieve a timesheet entryreadhumaans.timesheet_entries.listList all timesheet entriesreadhumaans.timesheet_entries.updateUpdate a timesheet entrywrite
Timesheet submissions5
humaans.timesheet_submissions.createCreate a timesheet submissionwritehumaans.timesheet_submissions.deleteDelete a timesheet submissiondestructivehumaans.timesheet_submissions.getRetrieve a timesheet submissionreadhumaans.timesheet_submissions.listList all timesheet submissionsreadhumaans.timesheet_submissions.updateUpdate a timesheet submissionwrite
Webhooks5
humaans.webhooks.createCreate a webhookwritehumaans.webhooks.deleteDelete a webhookdestructivehumaans.webhooks.getRetrieve a webhookreadhumaans.webhooks.listList all webhooksreadhumaans.webhooks.updateUpdate a webhookwrite
Working pattern allocations5
humaans.working_pattern_allocations.createCreate a working pattern allocationwritehumaans.working_pattern_allocations.deleteDelete a working pattern allocationdestructivehumaans.working_pattern_allocations.getRetrieve a working pattern allocationreadhumaans.working_pattern_allocations.listList all working pattern allocationsreadhumaans.working_pattern_allocations.updateUpdate a working pattern allocationwrite
Working patterns5
humaans.working_patterns.createCreate a working patternwritehumaans.working_patterns.deleteDelete a working patterndestructivehumaans.working_patterns.getRetrieve a working patternreadhumaans.working_patterns.listList all working patternsreadhumaans.working_patterns.updateUpdate a working patternwrite
Document types4
humaans.document_types.createCreate a document typewritehumaans.document_types.deleteDelete a document typedestructivehumaans.document_types.listList all document typesreadhumaans.document_types.updateUpdate a document typewrite
Companies3
humaans.companies.getRetrieve a companyreadhumaans.companies.listList all companiesreadhumaans.companies.updateUpdate a companywrite
Data exports3
humaans.data_exports.createCreate a data exportwritehumaans.data_exports.deleteDelete a data exportdestructivehumaans.data_exports.getRetrieve a data exportread
Compensation types2
humaans.compensation_types.getRetrieve a compensation typereadhumaans.compensation_types.listList all compensation typesread
Org hierarchies2
humaans.org_hierarchies.getRetrieve an org hierarchyreadhumaans.org_hierarchies.listList all org hierarchiesread
Org unit assignments2
humaans.org_unit_assignments.getRetrieve an org unit assignmentreadhumaans.org_unit_assignments.listList all org unit assignmentsread
Org units2
humaans.org_units.getRetrieve an org unitreadhumaans.org_units.listList all org unitsread
Performance cycle instances2
humaans.performance_cycle_instances.getRetrieve a performance instancereadhumaans.performance_cycle_instances.listList all performance instancesread
Performance cycle review templates2
humaans.performance_cycle_review_templates.getRetrieve a performance templatereadhumaans.performance_cycle_review_templates.listList all performance templatesread
Performance cycle reviews2
humaans.performance_cycle_reviews.getRetrieve a performance reviewreadhumaans.performance_cycle_reviews.listList all performance reviewsread
Performance cycles2
humaans.performance_cycles.getRetrieve a performance cyclereadhumaans.performance_cycles.listList all performance cyclesread
Equipment names1
humaans.equipment_names.listList all equipment namesread
Equipment types1
humaans.equipment_types.listList all equipment typesread
Files1
humaans.files.getRetrieve a fileread
Identity document types1
humaans.identity_document_types.listList all identity document typesread
Me1
humaans.me.getRetrieve meread
Public holiday calendars1
humaans.public_holiday_calendars.listList all public holiday calendarsread
Public holidays1
humaans.public_holidays.listList all public holidaysread
Time away periods1
humaans.time_away_periods.listList all time away periodsread
Token info1
humaans.token_info.getRetrieve my token inforead
Questions
The Humaans MCP server, answered.
Is there a Humaans MCP server for Claude?
Yes. actionlake is an MCP gateway: a remote MCP server that gives Claude, or another MCP client, 165 Humaans actions across bank accounts, compensations, custom fields and custom values, through the same eight tools it uses for every other connector. actionlake is independent; it is not made or endorsed by Humaans.
What do I need to connect Humaans?
Humaans API access token (Settings > API access tokens). The free call account { op: "connections.requirements", service: "humaans" } lists exactly what to paste.
Can an AI agent delete or change things in Humaans?
Only if its key allows it, and only with an explicit confirmation. 28 Humaans actions are destructive, including delete a person, delete a location and delete a time away. 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 Humaans API limit?
actionlake paces every call to the limits in the Humaans service file: 400 calls a minute per connection. Repeated reads are answered from cache (72 Humaans actions can be), which never reaches Humaans.
What does a Humaans action cost?
One upstream call, the only unit actionlake bills. A list that pages bills one call per page (165 Humaans actions page). Cache hits, searches, dry runs and calls Humaans 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 Humaans API does it cover?
The Humaans REST API (unversioned; https://app.humaans.io/api) at app.humaans.io. It is built from Humaans's documentation as read on 23 October 2026. 165 actions in 46 areas, each one in the signed service file (version 1.0.0).
Does actionlake keep my Humaans 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 Humaans 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 Humaans today.
Start free - 100,000 calls/month, no card. No signup. Hard caps on every key. Cached answers are free.