Skip to content

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/mcp
the first call
do {  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.

  1. 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
  2. 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
  3. 03

    Make the first call. Check before a write.

    Ask in plain words; Claude picks the action. Before anything changes, check validates 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
  1. Bank accounts

    5

    2 read · 2 write · 1 destructive

    List all bank accounts · Create a bank account · Update a bank account · Retrieve a bank account

  2. Compensations

    5

    2 read · 2 write · 1 destructive

    List all compensations · Create a compensation · Retrieve a compensation · Update a compensation

  3. Custom fields

    5

    2 read · 2 write · 1 destructive

    Create a custom field · List all custom fields · Retrieve a custom field · Update a custom field

  4. Custom values

    5

    2 read · 2 write · 1 destructive

    Create a custom value · List all custom values · Retrieve a custom value · Update a custom value

  5. Documents

    5

    2 read · 2 write · 1 destructive

    List all documents · Update a document · Delete a document · Retrieve a document

  6. Emergency contacts

    5

    2 read · 2 write · 1 destructive

    Create an emergency contact · List all emergency contacts · Retrieve an emergency contact · Update an emergency contact

  7. Equipment

    5

    2 read · 2 write · 1 destructive

    Create an equipment · List all equipment · Retrieve an equipment · Update an equipment

  8. Identity documents

    5

    2 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.

ActionWhat it doesEffectSame name in
humaans.people.listList all peopleList all people.readhr.employee.list61 connectors
humaans.locations.listList all locationsList all locations.readhr.location.list32 connectors
humaans.people.createCreate a personCreate a person.writehr.employee.create51 connectors
humaans.locations.createCreate a locationCreate a location.writehr.location.create23 connectors
humaans.people.deleteDelete a personDelete a person.destructivehr.employee.delete34 connectors
humaans.time_away.createCreate a time awayCreate a time away.writehr.leave_request.create32 connectors
humaans.me.getRetrieve meRetrieve me.readidentity.current_user.get307 connectors
humaans.time_away.listList all time awayList all time away.readhr.leave_request.list29 connectors
humaans.time_away_types.listList all time away typesList all time away types.readhr.leave_type.list23 connectors
humaans.timesheet_entries.createCreate a timesheet entryCreate a timesheet entry.writehr.time_clock_entry.create17 connectors
humaans.timesheet_entries.listList all timesheet entriesList all timesheet entries.readhr.time_clock_entry.list15 connectors
humaans.compensations.listList all compensationsList all compensations.readhr.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.

  1. Readread

    List everyone in Humaans with their department and start date.

    callshumaans.people.list

  2. Writewrite

    Create a person in Humaans. Show me exactly what you will send before you save it.

    callshumaans.people.create

Governance for Humaans

Destructive actions wait for a yes.

28 Humaans actions are destructive. These are all of them:

  • Delete a personhumaans.people.delete
  • Delete a locationhumaans.locations.delete
  • Delete a time awayhumaans.time_away.delete
  • Delete a timesheet entryhumaans.timesheet_entries.delete
  • Delete a time away typehumaans.time_away_types.delete
  • Delete a documenthumaans.documents.delete
  • Delete a compensationhumaans.compensations.delete
  • Delete a bank accounthumaans.bank_accounts.delete
  • Delete a spacehumaans.spaces.delete
  • Delete a webhookhumaans.webhooks.delete
  • Delete an equipmenthumaans.equipment.delete
  • Delete a job rolehumaans.job_roles.delete
  • Delete a data exporthumaans.data_exports.delete
  • Delete a custom fieldhumaans.custom_fields.delete
  • Delete a custom valuehumaans.custom_values.delete
  • Delete a document typehumaans.document_types.delete
  • Delete a working patternhumaans.working_patterns.delete
  • Delete a job library rolehumaans.job_library_roles.delete
  • Delete an emergency contacthumaans.emergency_contacts.delete
  • Delete an identity documenthumaans.identity_documents.delete
  • Delete a job library levelhumaans.job_library_levels.delete
  • Delete a time away policyhumaans.time_away_policies.delete
  • Delete a job library profilehumaans.job_library_profiles.delete
  • Delete a time away adjustmenthumaans.time_away_adjustments.delete
  • Delete a time away allocationhumaans.time_away_allocations.delete
  • Delete a timesheet submissionhumaans.timesheet_submissions.delete
  • Delete a working pattern allocationhumaans.working_pattern_allocations.delete
  • Delete a Public holiday calendar dayhumaans.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.

dohumaans.people.deleteconfirm_policy: human

Delete a person?

intent: the user asked me to delete a person

run suspended · waiting for a named person · key humaans-agent cannot confirm itself
In the console, or from an emailed signed link.
a key for this connector
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]" }  ]}
Illustrative. Scoped to Humaans only, capped at 2,000 upstream calls, every write confirmed, and the destructive ones approved by a named person.

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

See pricing

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 accountwrite
  • humaans.bank_accounts.deleteDelete a bank accountdestructive
  • humaans.bank_accounts.getRetrieve a bank accountread
  • humaans.bank_accounts.listList all bank accountsread
  • humaans.bank_accounts.updateUpdate a bank accountwrite
Compensations5
  • humaans.compensations.createCreate a compensationwrite
  • humaans.compensations.deleteDelete a compensationdestructive
  • humaans.compensations.getRetrieve a compensationread
  • humaans.compensations.listList all compensationsread
  • humaans.compensations.updateUpdate a compensationwrite
Custom fields5
  • humaans.custom_fields.createCreate a custom fieldwrite
  • humaans.custom_fields.deleteDelete a custom fielddestructive
  • humaans.custom_fields.getRetrieve a custom fieldread
  • humaans.custom_fields.listList all custom fieldsread
  • humaans.custom_fields.updateUpdate a custom fieldwrite
Custom values5
  • humaans.custom_values.createCreate a custom valuewrite
  • humaans.custom_values.deleteDelete a custom valuedestructive
  • humaans.custom_values.getRetrieve a custom valueread
  • humaans.custom_values.listList all custom valuesread
  • humaans.custom_values.updateUpdate a custom valuewrite
Documents5
  • humaans.documents.createCreate a documentwrite
  • humaans.documents.deleteDelete a documentdestructive
  • humaans.documents.getRetrieve a documentread
  • humaans.documents.listList all documentsread
  • humaans.documents.updateUpdate a documentwrite
Emergency contacts5
  • humaans.emergency_contacts.createCreate an emergency contactwrite
  • humaans.emergency_contacts.deleteDelete an emergency contactdestructive
  • humaans.emergency_contacts.getRetrieve an emergency contactread
  • humaans.emergency_contacts.listList all emergency contactsread
  • humaans.emergency_contacts.updateUpdate an emergency contactwrite
Equipment5
  • humaans.equipment.createCreate an equipmentwrite
  • humaans.equipment.deleteDelete an equipmentdestructive
  • humaans.equipment.getRetrieve an equipmentread
  • humaans.equipment.listList all equipmentread
  • humaans.equipment.updateUpdate an equipmentwrite
Identity documents5
  • humaans.identity_documents.createCreate an identity documentwrite
  • humaans.identity_documents.deleteDelete an identity documentdestructive
  • humaans.identity_documents.getRetrieve an identity documentread
  • humaans.identity_documents.listList all identity documentsread
  • humaans.identity_documents.updateUpdate an identity documentwrite
Job library levels5
  • humaans.job_library_levels.createCreate a job library levelwrite
  • humaans.job_library_levels.deleteDelete a job library leveldestructive
  • humaans.job_library_levels.getRetrieve a job library levelread
  • humaans.job_library_levels.listList all job library levelsread
  • humaans.job_library_levels.updateUpdate a job library levelwrite
Job library profiles5
  • humaans.job_library_profiles.createCreate a job library profilewrite
  • humaans.job_library_profiles.deleteDelete a job library profiledestructive
  • humaans.job_library_profiles.getRetrieve a job library profileread
  • humaans.job_library_profiles.listList all job library profilesread
  • humaans.job_library_profiles.updateUpdate a job library profilewrite
Job library roles5
  • humaans.job_library_roles.createCreate a job library rolewrite
  • humaans.job_library_roles.deleteDelete a job library roledestructive
  • humaans.job_library_roles.getRetrieve a job library roleread
  • humaans.job_library_roles.listList all job library rolesread
  • humaans.job_library_roles.updateUpdate a job library rolewrite
Job roles5
  • humaans.job_roles.createCreate a job rolewrite
  • humaans.job_roles.deleteDelete a job roledestructive
  • humaans.job_roles.getRetrieve a job roleread
  • humaans.job_roles.listList all job rolesread
  • humaans.job_roles.updateUpdate a job rolewrite
Locations5
  • humaans.locations.createCreate a locationwrite
  • humaans.locations.deleteDelete a locationdestructive
  • humaans.locations.getRetrieve a locationread
  • humaans.locations.listList all locationsread
  • humaans.locations.updateUpdate a locationwrite
People5
  • humaans.people.createCreate a personwrite
  • humaans.people.deleteDelete a persondestructive
  • humaans.people.getRetrieve a personread
  • humaans.people.listList all peopleread
  • humaans.people.updateUpdate a personwrite
Public holiday calendar days5
  • humaans.public_holiday_calendar_days.createCreate a Public holiday calendar daywrite
  • humaans.public_holiday_calendar_days.deleteDelete a Public holiday calendar daydestructive
  • humaans.public_holiday_calendar_days.getRetrieve a Public holiday calendar dayread
  • humaans.public_holiday_calendar_days.listList all Public holiday calendar daysread
  • humaans.public_holiday_calendar_days.updateUpdate a Public holiday calendar daywrite
Spaces5
  • humaans.spaces.createCreate a spacewrite
  • humaans.spaces.deleteDelete a spacedestructive
  • humaans.spaces.getRetrieve a spaceread
  • humaans.spaces.listList all spacesread
  • humaans.spaces.updateUpdate a spacewrite
Time away5
  • humaans.time_away.createCreate a time awaywrite
  • humaans.time_away.deleteDelete a time awaydestructive
  • humaans.time_away.getRetrieve a time awayread
  • humaans.time_away.listList all time awayread
  • humaans.time_away.updateUpdate a time awaywrite
Time away adjustments5
  • humaans.time_away_adjustments.createCreate a time away adjustmentwrite
  • humaans.time_away_adjustments.deleteDelete a time away adjustmentdestructive
  • humaans.time_away_adjustments.getRetrieve a time away adjustmentread
  • humaans.time_away_adjustments.listList all time away adjustmentsread
  • humaans.time_away_adjustments.updateUpdate a time away adjustmentwrite
Time away allocations5
  • humaans.time_away_allocations.createCreate a time away allocationwrite
  • humaans.time_away_allocations.deleteDelete a time away allocationdestructive
  • humaans.time_away_allocations.getRetrieve a time away allocationread
  • humaans.time_away_allocations.listList all time away allocationsread
  • humaans.time_away_allocations.updateUpdate a time away allocationwrite
Time away policies5
  • humaans.time_away_policies.createCreate a time away policywrite
  • humaans.time_away_policies.deleteDelete a time away policydestructive
  • humaans.time_away_policies.getRetrieve a time away policyread
  • humaans.time_away_policies.listList all time away policiesread
  • humaans.time_away_policies.updateUpdate a time away policywrite
Time away types5
  • humaans.time_away_types.createCreate a time away typewrite
  • humaans.time_away_types.deleteDelete a time away typedestructive
  • humaans.time_away_types.getRetrieve a time away typeread
  • humaans.time_away_types.listList all time away typesread
  • humaans.time_away_types.updateUpdate a time away typewrite
Timesheet entries5
  • humaans.timesheet_entries.createCreate a timesheet entrywrite
  • humaans.timesheet_entries.deleteDelete a timesheet entrydestructive
  • humaans.timesheet_entries.getRetrieve a timesheet entryread
  • humaans.timesheet_entries.listList all timesheet entriesread
  • humaans.timesheet_entries.updateUpdate a timesheet entrywrite
Timesheet submissions5
  • humaans.timesheet_submissions.createCreate a timesheet submissionwrite
  • humaans.timesheet_submissions.deleteDelete a timesheet submissiondestructive
  • humaans.timesheet_submissions.getRetrieve a timesheet submissionread
  • humaans.timesheet_submissions.listList all timesheet submissionsread
  • humaans.timesheet_submissions.updateUpdate a timesheet submissionwrite
Webhooks5
  • humaans.webhooks.createCreate a webhookwrite
  • humaans.webhooks.deleteDelete a webhookdestructive
  • humaans.webhooks.getRetrieve a webhookread
  • humaans.webhooks.listList all webhooksread
  • humaans.webhooks.updateUpdate a webhookwrite
Working pattern allocations5
  • humaans.working_pattern_allocations.createCreate a working pattern allocationwrite
  • humaans.working_pattern_allocations.deleteDelete a working pattern allocationdestructive
  • humaans.working_pattern_allocations.getRetrieve a working pattern allocationread
  • humaans.working_pattern_allocations.listList all working pattern allocationsread
  • humaans.working_pattern_allocations.updateUpdate a working pattern allocationwrite
Working patterns5
  • humaans.working_patterns.createCreate a working patternwrite
  • humaans.working_patterns.deleteDelete a working patterndestructive
  • humaans.working_patterns.getRetrieve a working patternread
  • humaans.working_patterns.listList all working patternsread
  • humaans.working_patterns.updateUpdate a working patternwrite
Document types4
  • humaans.document_types.createCreate a document typewrite
  • humaans.document_types.deleteDelete a document typedestructive
  • humaans.document_types.listList all document typesread
  • humaans.document_types.updateUpdate a document typewrite
Companies3
  • humaans.companies.getRetrieve a companyread
  • humaans.companies.listList all companiesread
  • humaans.companies.updateUpdate a companywrite
Data exports3
  • humaans.data_exports.createCreate a data exportwrite
  • humaans.data_exports.deleteDelete a data exportdestructive
  • humaans.data_exports.getRetrieve a data exportread
Compensation types2
  • humaans.compensation_types.getRetrieve a compensation typeread
  • humaans.compensation_types.listList all compensation typesread
Org hierarchies2
  • humaans.org_hierarchies.getRetrieve an org hierarchyread
  • humaans.org_hierarchies.listList all org hierarchiesread
Org unit assignments2
  • humaans.org_unit_assignments.getRetrieve an org unit assignmentread
  • humaans.org_unit_assignments.listList all org unit assignmentsread
Org units2
  • humaans.org_units.getRetrieve an org unitread
  • humaans.org_units.listList all org unitsread
Performance cycle instances2
  • humaans.performance_cycle_instances.getRetrieve a performance instanceread
  • humaans.performance_cycle_instances.listList all performance instancesread
Performance cycle review templates2
  • humaans.performance_cycle_review_templates.getRetrieve a performance templateread
  • humaans.performance_cycle_review_templates.listList all performance templatesread
Performance cycle reviews2
  • humaans.performance_cycle_reviews.getRetrieve a performance reviewread
  • humaans.performance_cycle_reviews.listList all performance reviewsread
Performance cycles2
  • humaans.performance_cycles.getRetrieve a performance cycleread
  • humaans.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.