--- title: "Humaans MCP server for AI agents - actionlake" description: "Give Claude 165 Humaans actions through one MCP server: bank accounts, compensations. Your agent never holds the credential. 100,000 calls a month free." canonical: https://actionlake.com/connectors/humaans updated: 2026-10-23 --- 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. [Connect Humaans free](https://actionlake.com/console?start=sandbox) [See pricing](https://actionlake.com/pricing) 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 ``` - 165 actions in one signed file - 81 read look, never change - 56 write create and update - 28 wait for a yes destructive, 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. - `token` Humaans 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 call check { 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 2026[docs.humaans.io](https://docs.humaans.io/api/) **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. - **81** read look, never change - **56** write create and update - **28** destructive wait 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. | Action | What it does | Effect | Same name in | | --- | --- | --- | --- | | `humaans.people.list` List all people | List all people. | read | `hr.employee.list` 61 connectors | | `humaans.locations.list` List all locations | List all locations. | read | `hr.location.list` 32 connectors | | `humaans.people.create` Create a person | Create a person. | write | `hr.employee.create` 51 connectors | | `humaans.locations.create` Create a location | Create a location. | write | `hr.location.create` 23 connectors | | `humaans.people.delete` Delete a person | Delete a person. | destructive | `hr.employee.delete` 34 connectors | | `humaans.time_away.create` Create a time away | Create a time away. | write | `hr.leave_request.create` 32 connectors | | `humaans.me.get` Retrieve me | Retrieve me. | read | `identity.current_user.get` 307 connectors | | `humaans.time_away.list` List all time away | List all time away. | read | `hr.leave_request.list` 29 connectors | | `humaans.time_away_types.list` List all time away types | List all time away types. | read | `hr.leave_type.list` 23 connectors | | `humaans.timesheet_entries.create` Create a timesheet entry | Create a timesheet entry. | write | `hr.time_clock_entry.create` 17 connectors | | `humaans.timesheet_entries.list` List all timesheet entries | List all timesheet entries. | read | `hr.time_clock_entry.list` 15 connectors | | `humaans.compensations.list` List all compensations | List all compensations. | read | `hr.compensation.list` 9 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. Read read List everyone in Humaans with their department and start date. calls `humaans.people.list` 2. Write write 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. do humaans.people.delete confirm_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: "lead@example.com" }, { match: "humaans.locations.delete", approver: "lead@example.com" }, { match: "humaans.time_away.delete", approver: "lead@example.com" } ] } ``` 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. - 1 upstream call per action all 165 Humaans actions - 165 actions page each page of a long list is one call - 72 reads can be cached a cache hit costs nothing - 100,000 calls a month, free paid plans from US$49 a month for 250,000 [See pricing](https://actionlake.com/pricing) Action index ## Every Humaans action. 165 actions by area: the id your agent calls, what it does, and its effect. **Bank accounts 5** - `humaans.bank_accounts.create` Create a bank account write - `humaans.bank_accounts.delete` Delete a bank account destructive - `humaans.bank_accounts.get` Retrieve a bank account read - `humaans.bank_accounts.list` List all bank accounts read - `humaans.bank_accounts.update` Update a bank account write **Compensations 5** - `humaans.compensations.create` Create a compensation write - `humaans.compensations.delete` Delete a compensation destructive - `humaans.compensations.get` Retrieve a compensation read - `humaans.compensations.list` List all compensations read - `humaans.compensations.update` Update a compensation write **Custom fields 5** - `humaans.custom_fields.create` Create a custom field write - `humaans.custom_fields.delete` Delete a custom field destructive - `humaans.custom_fields.get` Retrieve a custom field read - `humaans.custom_fields.list` List all custom fields read - `humaans.custom_fields.update` Update a custom field write **Custom values 5** - `humaans.custom_values.create` Create a custom value write - `humaans.custom_values.delete` Delete a custom value destructive - `humaans.custom_values.get` Retrieve a custom value read - `humaans.custom_values.list` List all custom values read - `humaans.custom_values.update` Update a custom value write **Documents 5** - `humaans.documents.create` Create a document write - `humaans.documents.delete` Delete a document destructive - `humaans.documents.get` Retrieve a document read - `humaans.documents.list` List all documents read - `humaans.documents.update` Update a document write **Emergency contacts 5** - `humaans.emergency_contacts.create` Create an emergency contact write - `humaans.emergency_contacts.delete` Delete an emergency contact destructive - `humaans.emergency_contacts.get` Retrieve an emergency contact read - `humaans.emergency_contacts.list` List all emergency contacts read - `humaans.emergency_contacts.update` Update an emergency contact write **Equipment 5** - `humaans.equipment.create` Create an equipment write - `humaans.equipment.delete` Delete an equipment destructive - `humaans.equipment.get` Retrieve an equipment read - `humaans.equipment.list` List all equipment read - `humaans.equipment.update` Update an equipment write **Identity documents 5** - `humaans.identity_documents.create` Create an identity document write - `humaans.identity_documents.delete` Delete an identity document destructive - `humaans.identity_documents.get` Retrieve an identity document read - `humaans.identity_documents.list` List all identity documents read - `humaans.identity_documents.update` Update an identity document write **Job library levels 5** - `humaans.job_library_levels.create` Create a job library level write - `humaans.job_library_levels.delete` Delete a job library level destructive - `humaans.job_library_levels.get` Retrieve a job library level read - `humaans.job_library_levels.list` List all job library levels read - `humaans.job_library_levels.update` Update a job library level write **Job library profiles 5** - `humaans.job_library_profiles.create` Create a job library profile write - `humaans.job_library_profiles.delete` Delete a job library profile destructive - `humaans.job_library_profiles.get` Retrieve a job library profile read - `humaans.job_library_profiles.list` List all job library profiles read - `humaans.job_library_profiles.update` Update a job library profile write **Job library roles 5** - `humaans.job_library_roles.create` Create a job library role write - `humaans.job_library_roles.delete` Delete a job library role destructive - `humaans.job_library_roles.get` Retrieve a job library role read - `humaans.job_library_roles.list` List all job library roles read - `humaans.job_library_roles.update` Update a job library role write **Job roles 5** - `humaans.job_roles.create` Create a job role write - `humaans.job_roles.delete` Delete a job role destructive - `humaans.job_roles.get` Retrieve a job role read - `humaans.job_roles.list` List all job roles read - `humaans.job_roles.update` Update a job role write **Locations 5** - `humaans.locations.create` Create a location write - `humaans.locations.delete` Delete a location destructive - `humaans.locations.get` Retrieve a location read - `humaans.locations.list` List all locations read - `humaans.locations.update` Update a location write **People 5** - `humaans.people.create` Create a person write - `humaans.people.delete` Delete a person destructive - `humaans.people.get` Retrieve a person read - `humaans.people.list` List all people read - `humaans.people.update` Update a person write **Public holiday calendar days 5** - `humaans.public_holiday_calendar_days.create` Create a Public holiday calendar day write - `humaans.public_holiday_calendar_days.delete` Delete a Public holiday calendar day destructive - `humaans.public_holiday_calendar_days.get` Retrieve a Public holiday calendar day read - `humaans.public_holiday_calendar_days.list` List all Public holiday calendar days read - `humaans.public_holiday_calendar_days.update` Update a Public holiday calendar day write **Spaces 5** - `humaans.spaces.create` Create a space write - `humaans.spaces.delete` Delete a space destructive - `humaans.spaces.get` Retrieve a space read - `humaans.spaces.list` List all spaces read - `humaans.spaces.update` Update a space write **Time away 5** - `humaans.time_away.create` Create a time away write - `humaans.time_away.delete` Delete a time away destructive - `humaans.time_away.get` Retrieve a time away read - `humaans.time_away.list` List all time away read - `humaans.time_away.update` Update a time away write **Time away adjustments 5** - `humaans.time_away_adjustments.create` Create a time away adjustment write - `humaans.time_away_adjustments.delete` Delete a time away adjustment destructive - `humaans.time_away_adjustments.get` Retrieve a time away adjustment read - `humaans.time_away_adjustments.list` List all time away adjustments read - `humaans.time_away_adjustments.update` Update a time away adjustment write **Time away allocations 5** - `humaans.time_away_allocations.create` Create a time away allocation write - `humaans.time_away_allocations.delete` Delete a time away allocation destructive - `humaans.time_away_allocations.get` Retrieve a time away allocation read - `humaans.time_away_allocations.list` List all time away allocations read - `humaans.time_away_allocations.update` Update a time away allocation write **Time away policies 5** - `humaans.time_away_policies.create` Create a time away policy write - `humaans.time_away_policies.delete` Delete a time away policy destructive - `humaans.time_away_policies.get` Retrieve a time away policy read - `humaans.time_away_policies.list` List all time away policies read - `humaans.time_away_policies.update` Update a time away policy write **Time away types 5** - `humaans.time_away_types.create` Create a time away type write - `humaans.time_away_types.delete` Delete a time away type destructive - `humaans.time_away_types.get` Retrieve a time away type read - `humaans.time_away_types.list` List all time away types read - `humaans.time_away_types.update` Update a time away type write **Timesheet entries 5** - `humaans.timesheet_entries.create` Create a timesheet entry write - `humaans.timesheet_entries.delete` Delete a timesheet entry destructive - `humaans.timesheet_entries.get` Retrieve a timesheet entry read - `humaans.timesheet_entries.list` List all timesheet entries read - `humaans.timesheet_entries.update` Update a timesheet entry write **Timesheet submissions 5** - `humaans.timesheet_submissions.create` Create a timesheet submission write - `humaans.timesheet_submissions.delete` Delete a timesheet submission destructive - `humaans.timesheet_submissions.get` Retrieve a timesheet submission read - `humaans.timesheet_submissions.list` List all timesheet submissions read - `humaans.timesheet_submissions.update` Update a timesheet submission write **Webhooks 5** - `humaans.webhooks.create` Create a webhook write - `humaans.webhooks.delete` Delete a webhook destructive - `humaans.webhooks.get` Retrieve a webhook read - `humaans.webhooks.list` List all webhooks read - `humaans.webhooks.update` Update a webhook write **Working pattern allocations 5** - `humaans.working_pattern_allocations.create` Create a working pattern allocation write - `humaans.working_pattern_allocations.delete` Delete a working pattern allocation destructive - `humaans.working_pattern_allocations.get` Retrieve a working pattern allocation read - `humaans.working_pattern_allocations.list` List all working pattern allocations read - `humaans.working_pattern_allocations.update` Update a working pattern allocation write **Working patterns 5** - `humaans.working_patterns.create` Create a working pattern write - `humaans.working_patterns.delete` Delete a working pattern destructive - `humaans.working_patterns.get` Retrieve a working pattern read - `humaans.working_patterns.list` List all working patterns read - `humaans.working_patterns.update` Update a working pattern write **Document types 4** - `humaans.document_types.create` Create a document type write - `humaans.document_types.delete` Delete a document type destructive - `humaans.document_types.list` List all document types read - `humaans.document_types.update` Update a document type write **Companies 3** - `humaans.companies.get` Retrieve a company read - `humaans.companies.list` List all companies read - `humaans.companies.update` Update a company write **Data exports 3** - `humaans.data_exports.create` Create a data export write - `humaans.data_exports.delete` Delete a data export destructive - `humaans.data_exports.get` Retrieve a data export read **Compensation types 2** - `humaans.compensation_types.get` Retrieve a compensation type read - `humaans.compensation_types.list` List all compensation types read **Org hierarchies 2** - `humaans.org_hierarchies.get` Retrieve an org hierarchy read - `humaans.org_hierarchies.list` List all org hierarchies read **Org unit assignments 2** - `humaans.org_unit_assignments.get` Retrieve an org unit assignment read - `humaans.org_unit_assignments.list` List all org unit assignments read **Org units 2** - `humaans.org_units.get` Retrieve an org unit read - `humaans.org_units.list` List all org units read **Performance cycle instances 2** - `humaans.performance_cycle_instances.get` Retrieve a performance instance read - `humaans.performance_cycle_instances.list` List all performance instances read **Performance cycle review templates 2** - `humaans.performance_cycle_review_templates.get` Retrieve a performance template read - `humaans.performance_cycle_review_templates.list` List all performance templates read **Performance cycle reviews 2** - `humaans.performance_cycle_reviews.get` Retrieve a performance review read - `humaans.performance_cycle_reviews.list` List all performance reviews read **Performance cycles 2** - `humaans.performance_cycles.get` Retrieve a performance cycle read - `humaans.performance_cycles.list` List all performance cycles read **Equipment names 1** - `humaans.equipment_names.list` List all equipment names read **Equipment types 1** - `humaans.equipment_types.list` List all equipment types read **Files 1** - `humaans.files.get` Retrieve a file read **Identity document types 1** - `humaans.identity_document_types.list` List all identity document types read **Me 1** - `humaans.me.get` Retrieve me read **Public holiday calendars 1** - `humaans.public_holiday_calendars.list` List all public holiday calendars read **Public holidays 1** - `humaans.public_holidays.list` List all public holidays read **Time away periods 1** - `humaans.time_away_periods.list` List all time away periods read **Token info 1** - `humaans.token_info.get` Retrieve my token info read 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. ## More connectors like Humaans Shares the most action names with - [Employment Hero 18](https://actionlake.com/connectors/employment-hero) - [Sling 12](https://actionlake.com/connectors/sling) - [Workable 11](https://actionlake.com/connectors/workable) - [Connecteam 10](https://actionlake.com/connectors/connecteam) - [Deel 6](https://actionlake.com/connectors/deel) - [Recruitee 6](https://actionlake.com/connectors/recruitee) Joins with, on shared entities - [Gusto 3](https://actionlake.com/connectors/gusto) - [Rippling 3](https://actionlake.com/connectors/rippling) - [Kombo 3](https://actionlake.com/connectors/kombo) - [Xero 2](https://actionlake.com/connectors/xero) - [Deputy 2](https://actionlake.com/connectors/deputy) - [Odoo 2](https://actionlake.com/connectors/odoo) Browse - [All Work & projects connectors](https://actionlake.com/connectors/category/work-and-projects) - [All connectors](https://actionlake.com/connectors) - [How actionlake compares](https://actionlake.com/compare) actionlake is independent. It is not made or endorsed by Humaans; the name is the vendor's own. Counts are from the Humaans service file, version 1.0.0. ## Give your agent Humaans today. [Connect Humaans free](https://actionlake.com/console?start=sandbox) [See pricing](https://actionlake.com/pricing) Start free - 100,000 calls/month, no card. No signup. Hard caps on every key. Cached answers are free. --- Source: https://actionlake.com/connectors/humaans More: https://actionlake.com/llms.txt