# Humand MCP connector

The Humand connector lets Claude, ChatGPT, Cursor, or Elaichi's agent read and update Humand employees, groups, posts, documents, and rewards, with every action running under the signed-in person's own access and recorded in an audit log.

Source: https://elaichi.ai/connectors/humand/

## Facts

| | |
| --- | --- |
| Application | Humand |
| Category | HRIS |
| AI tools | 105 |
| Authentication | Connects with an API key |
| Needs your own OAuth app | No |
| MCP endpoint | https://api.elaichi.ai/mcp |
| Works with | Claude, ChatGPT, Cursor, any MCP client, and the Elaichi Agent |
| Tools advertised by name | No. 105 tools is past the 30-tool threshold, so clients use `search_tools` and `execute_tool` |

## What you can ask once Humand is connected

- Create a Humand profile for Ana Ruiz starting Monday in Finance
- Deactivate the Humand users who left last week
- Draft a post announcing the new parental leave policy

## Connect Humand in Elaichi

This happens once for the organization, before any client is involved.

1. Open Connections, choose Add connection, and pick Humand.
2. Optionally set Share with, then press Connect.
3. Paste a Humand API key. One person generates a token in Humand and pastes it once. Everyone else works through Share with, and never sees it.

Credentials are vaulted and nobody, including the AI, reads them back. The connection becomes a toolbox immediately, so you can curate which Humand tools are exposed, rename them, or freeze arguments before anyone points a client at it.

## Connect Humand to Claude

Endpoint: https://api.elaichi.ai/mcp

1. Open Customize, then Connectors.
2. Press Add.
3. Name it, paste the MCP server URL, then Continue.
4. Sign in and approve.

On Team and Enterprise, an Owner adds it once. Everyone else turns it on for themselves.

## Connect Humand to ChatGPT

Endpoint: https://api.elaichi.ai/mcp

1. Open Plugins, then press the + button.
2. Name it and paste the endpoint into Server URL.
3. Leave Authentication on OAuth, then tick the risk acknowledgement.
4. Press Create, then sign in and approve.

Works on the web today. The plugin directory lives at chatgpt.com/plugins.

## Connect Humand to Cursor

Endpoint: https://api.elaichi.ai/mcp

1. Open `~/.cursor/mcp.json`.
2. Add the endpoint under `mcpServers`.
3. Reload Cursor, then sign in and approve.

Set up per machine, so repeat it on each computer you work from.

## Connect Humand to any MCP client

Endpoint: https://api.elaichi.ai/mcp

1. Add the endpoint as a remote MCP server.
2. Sign in and approve.

The Elaichi Agent already has these tools, with nothing to set up.

## What the consent screen decides

Only Read is granted by default, which is not enough to call a Humand tool. Over MCP there is no trusted place to confirm a write in the moment, so the consent screen is the standing approval rather than a formality. Grant Read and Run tools. Think hard before granting Delete, which reaches into connected apps and cannot be undone.

## What teams do with Humand through Elaichi

### Set up a new hire before day one

HR. Create the employee's Humand profile, fill in their department, location, and manager, and add them to the right groups so their feed and documents are ready when they log in.

### Deactivate leavers and reactivate returners

HR. When someone leaves, switch off their Humand account the same day. When someone comes back from parental leave or a sabbatical, turn it back on without recreating anything.

### Publish an announcement to the right people

Internal communications. Draft a post or upload a policy document and publish it to a specific segment in Humand, such as one office or one department, instead of the whole company.

### Reset a password and fix profile details

IT helpdesk. Reset a locked-out employee's Humand password, correct a misspelled name or an old job title, and update their profile picture from the same conversation.

### Update hundreds of profiles after a reorg

People operations. Move people to new departments, managers, and locations across many Humand users in one pass, then create the new groups the reorg calls for.

### Keep the recognition store current

Rewards. Add a new product to the Humand rewards store, change its details or retire it, and review the exchanges employees have redeemed this month.

## Frequently asked questions

### How do I connect Humand to Claude?

In Elaichi, open Humand and paste the API key from your Humand admin settings. There is no OAuth application to register and no client ID or secret to generate. Then in Claude go to Customize, then Connectors, then Add, and paste https://api.elaichi.ai/mcp. Sign in with your Elaichi account and Humand is available in Claude alongside anything else you have connected.

### Does Humand work with ChatGPT and Cursor as well as Claude?

Yes. The same endpoint, https://api.elaichi.ai/mcp, works in Claude, ChatGPT, Cursor, any other MCP client, and the Elaichi Agent. You connect Humand once in Elaichi and every client picks it up, so there is nothing to set up again per app.

### What can an AI agent actually do with my Humand data?

With Humand connected, you can ask for an employee's profile, create a new hire, deactivate someone who has left, reset a password, or add people to a group. You can also publish a post or a document, add or update a product in the rewards store, and list the exchanges employees have made. Humand has a large set of actions, so short concrete asks like "deactivate Maria Lopez" work better than long paragraphs.

### Does connecting Humand give the AI access to every employee record?

No. The AI acts as the person who signed in, so it can only see and change what that person can already see and change in Humand. Elaichi can narrow that further with restrictions, and it never widens access beyond what the person already has.

### Can my team share one Humand connection?

Yes. One HR administrator connects Humand in Elaichi and shares the connection with a team, and nobody else ever handles the API key. Each teammate still signs in to Elaichi as themselves, so the audit log names the actual person behind every change in Humand.

### Can I stop an agent from deleting or changing things in Humand?

Yes. Restrictions in Elaichi work per action, so you can allow reading Humand profiles and publishing posts while blocking deletion of users or products. A blocked action is never shown to Claude, ChatGPT, or Cursor at all, so no prompt can reach it.

### What happens to a Humand connection when someone leaves?

Offboarding a person in Elaichi ends their access to Humand through every client at once. A Humand connection shared with the team keeps working for everyone else. If you want to remove Humand entirely, disconnecting it once in Elaichi removes it from Claude, ChatGPT, Cursor, and every other client.

## All 105 Humand tools

Every tool below is callable through https://api.elaichi.ai/mcp once Humand is connected, subject to the toolbox it is in and the restrictions on the caller.

- **List all Humand exchanges** (List). Get all exchanges in Humand. Returns: id, status, statusColor, cost, productId, product, userEmployeeInternalId, createdAt.
- **Create a Humand product** (Create). Create a product in Humand. Returns: id, name, cost, coverPicture, description, category, attachments. Required: name, cost, coverPicture.
- **Update a Humand product by ID** (Update). Edit a Humand product by id. Returns the updated product object including its id. Required: id.
- **Delete a Humand product by ID** (Delete). Delete a Humand product by id. Returns an empty 204 response on success. Required: id.
- **List all Humand users** (List). List Humand users with support for searching and pagination. Returns: id, employeeInternalId, status.
- **Create a Humand user** (Create). Create user in Humand. Returns: id, createdAt, updatedAt, deleted, status, segmentation, relationships, fields. Required: password, employeeInternalId, firstName, lastName.
- **Humand users upsert** (Upsert). Upsert user in Humand. Returns: id, createdAt, updatedAt, deleted, status, segmentation, relationships, fields. Required: password, employeeInternalId, firstName, lastName.
- **Humand users get me** (Get). Get user profile in Humand. Returns: id, createdAt, updatedAt, deleted, status, segmentation, relationships, fields. Get the basic information of the logged user.
- **Humand users upsert alt** (Upsert). Upsert a user in Humand — update an existing user or create a new one if it does not exist. Returns the created or updated user object. Relationships use merge-by-type semantics: sending BOSS entries (or []) updates or clears org-chart bosses and reviewer; sending only REVIEWER entries leaves existing bosses untouched. Set employeeInternalId to null to remove that relationship type. A user cannot…
- **Humand users deactivate** (Deactivate). Deactivate a Humand user by their employee internal id. Returns an empty 204 response on success. Required: employee_internal_id.
- **Humand users reactivate** (Reactivate). Reactivate a deactivated Humand user by their employee internal id. Returns an empty 204 response on success. Required: employee_internal_id.
- **Humand users reset password** (Action). Reset the password for a Humand user identified by their internal employee id. Returns an empty 204 response on success. Required: employee_internal_id.
- **Humand users add segmentations** (Add). Add segmentations to a Humand user by employee internal id. Returns the updated user object including employeeInternalId, status, and segmentations. Required: employee_internal_id, segmentations.
- **Get single Humand user by ID** (Get). Get a single Humand user by employee internal id. Returns the full User object including employeeInternalId, relationships, and segmentations. Required: id.
- **Update a Humand user by ID** (Update). Partially update user in Humand. Returns: id, createdAt, updatedAt, deleted, status, segmentation, relationships, fields. Update an existing user.
- **Delete a Humand user by ID** (Delete). Delete a Humand user by id. Returns an empty 204 response on success. Required: id.
- **Humand users delete alt** (Delete). Delete a Humand user by employee internal id using the POST-based delete endpoint. Returns an empty 204 response on success. Required: employee_internal_id.
- **Humand users update profile fields** (Update). Update user profile fields in Humand. Returns: id, createdAt, updatedAt, deleted, status, segmentation, relationships, fields. Required: employee_internal_id.
- **Humand users update profile picture** (Update). Upload a profile picture for a Humand user identified by their employee internal id. The request body is multipart form data containing the image file. Returns an empty 201 response on success. Required: employee_internal_id.
- **Humand users bulk update** (Update). Update segmentations for a Humand user by employee internal id. Removes previous segmentations belonging to the specified groups and adds the requested segmentations. Returns the updated user object including employeeInternalId. Required: employee_internal_id.
- **Create a Humand document** (Create). Add document for user in Humand. Returns: id, name, source, createdAt, signatureStatus, signatureCoordinates, extension, folderId. Required: employee_internal_id, file. Adds a document whose owner is employeeInternalId.
- **Create a Humand post** (Create). Create post in Humand. Returns: id, body, updatedAt, createdAt, poll, commentCount, attachments, user. Creates a new post given the params.
- **List all Humand segmentations** (List). Get segmentations in Humand. Returns: id, name, items, isEditable, visibility, position. Get all segmentations with items.
- **Humand segmentations create group** (Create). Create a new segmentation group in Humand. Returns the created group including its name, items, and visibility.
- **Humand segmentations add items to group** (Add). Add items to a segmentation group in Humand by group name. Returns the updated segmentation group object including its name, items, and visibility. Required: group_name.
- **Humand segmentations list users** (List). Get users of segmentation items in Humand. Returns: items. Required: segmentationItemIds. Get users of segmentation items.
- **Humand segmentations bulk update** (Update). Update segmentation group in Humand. Returns: id, name, items, isEditable, visibility, position, sharedId. Required: group_name, name, itemNames. Update a segmentation group.
- **Humand files generate signed URL** (Generate). Generate a signed url in Humand. Returns: url, creationUrl. Required: type, fileName, contentType.
- **Humand files generate signed URL temporal** (Generate). Generate a signed url for a temporal file upload in Humand. Returns: bucketUrl, key, policy, Content-Type, x-amz-algorithm, x-amz-date, x-amz-signature. Required: type, fileName, contentType.
- **Create a Humand file** (Create). Create file in Humand. Returns: id, name, type, source, createdAt, updatedAt, uploader, shared. Required: file. Creates a file.
- **Humand files create folder** (Create). Create a folder in Humand. Returns the created folder object including its id and name. Required: name.
- **Delete a Humand file by ID** (Delete). Delete a file in Humand by id. Returns an empty 204 response on success. Required: id.
- **Update a Humand file by ID** (Update). Update a file in Humand by id. Returns an empty 202 Accepted response on success. Required: id.
- **List all Humand acknowledgements** (List). List acknowledgements in Humand. Returns: id, body, points, acknowledger, acknowledged, category, updatedAt, createdAt. List acknowledgements with pagination and sorting.
- **Create a Humand acknowledgement** (Create). Create an acknowledgement in Humand. Returns the created acknowledgement including its id, category, and created_at.
- **Humand acknowledgements adjust points** (Action). Adjust a user's acknowledgement points in Humand. Returns an empty 204 response on success.
- **Create a Humand article** (Create). Create a new article in Humand. Returns: id.
- **Update a Humand article by ID** (Update). Update an existing article in Humand by id. Returns: id. Required: id.
- **Delete a Humand article by ID** (Delete). Delete an article in Humand by id. Returns an empty 204 response on success. Required: id.
- **Humand forms get answers** (Get). Get all answers submitted for a Humand form, including user answers. Returns a paginated list of form answer records with id, created_at, and answers. Required: form_id.
- **Humand time off list balances** (List). List time off balances for employees in Humand. Returns: id.
- **Humand time off list balances by cycle** (List). List time off balances grouped by accrual cycle for employees in Humand. Returns: id.
- **Humand time off list requests** (List). List time off requests submitted by employees in Humand. Returns: id.
- **Humand time off correct balances** (Action). Manually correct or overwrite time off balances for a specific policy type in Humand. Required: policy_type_id.
- **Humand time off update request dates** (Update). Update the dates of an existing time off request in Humand. Returns the updated time off request including its id, state, and dates. Required: request_id.
- **Humand time off bulk create requests** (Create). Bulk-create time off requests for a specific policy in Humand. Returns a job accepted response for tracking the asynchronous bulk creation via the Get Bulk Time Off Requests Creation Job endpoint. Required: policy_id.
- **Humand time off get bulk request job** (Get). Get the status of a bulk time off requests creation job in Humand by bulk_id. Returns: bulk_id. Required: bulk_id.
- **Humand time off bulk update** (Update). Update Time Off Request State in Humand. Returns no content on success. Required: request_id. Update the state of a Time Off Request.
- **Humand groups create post** (Create). Create a post in a Humand group. Returns the created group post object. Required: group_id.
- **Humand time tracking list day summaries** (List). List time tracking day summaries in Humand. Returns a paginated collection of per-day summary records, each containing date, hours (worked, expected, and categorized), time off, holiday, and time slot information.
- **Humand time tracking list entries** (List). List time tracking entries in Humand. Returns a paginated collection of time tracking entries including entry details, site, and location information.
- **Humand time tracking clock in** (Action). Clock in an employee in Humand to start a new time tracking entry. Returns the created time tracking entry object.
- **Humand time tracking clock out** (Action). Clock out of an active time tracking entry in Humand, ending the employee's current work session. Returns the updated time tracking entry object.
- **Humand time tracking create paired entries** (Create). Create paired time-tracking entries (clock-in and clock-out together) in Humand. Returns the created paired entries. Required: a request body containing the paired entry inputs to create.
- **Humand shifts bulk create** (Create). Bulk create or update shifts for multiple employees in Humand. Accepts a list of employee shift assignments, each with per-day entries specifying the shift to assign. Returns a bulk process result indicating the outcome for each assignment.
- **Humand shifts get calendar** (Get). Get the shift calendar in Humand, returning a paginated list of assigned shifts for employees. Returns a paginated list of assigned shift entries, each containing shift assignment details.
- **Humand shifts get planning** (Get). Get the shift planning calendar in Humand, returning paginated planning day records (PublicApiPlanningDay). Each day entry contains scheduled shift and time-slot information for employees. Results are returned via the `data` field as a paginated list (PaginatedPlanningDayList).
- **Humand shifts list templates** (List). Get shift templates in Humand. Returns: count, page, totalPages, limit, items. Required: page, limit. Returns a paginated list of shift templates for the community.
- **Humand work schedules bulk create assignments** (Create). Bulk assign work schedules to employees in Humand. Returns a bulk result summarizing the processed assignments. Requires a request body containing the list of work schedule assignments to create.
- **List all Humand job positions** (List). List job positions in Humand. Returns: id.
- **Humand job positions bulk create** (Create). Bulk create job positions in Humand by submitting an array of position records in a single request. Returns the created job positions including id, name, and externalReference. Required: an array of job position items in the request body.
- **Get single Humand job position by ID** (Get). Get a single Humand job position by its id. Returns the job position object including its id. Required: id.
- **Update a Humand job position by ID** (Update). Update a job position in Humand by id. Returns the updated job position object including its id. Required: id.
- **Delete a Humand job position by ID** (Delete). Delete a Humand job position by id. Returns an empty 204 response on success. Required: id.
- **Humand job positions list members** (List). List members of a specific Humand job position. Returns a paginated list of job position members, each including employeeInternalId and member details. Required: job_position_id.
- **Humand job positions add members** (Add). Add members to a job position in Humand. Returns an empty 204 response on success. Required: job_position_id.
- **Humand job positions remove members** (Delete). Remove members from a job position in Humand. Returns an empty 204 response on success. Required: job_position_id.
- **Humand job positions bulk update** (Update). Update user job position in Humand. Returns no content on success. Required: member_id. Update a user's job position assignment.
- **List all Humand departments** (List). List departments in Humand. Returns: id, name, createdAt, updatedAt.
- **Humand departments bulk create** (Create). Bulk create multiple departments in Humand in a single request by submitting an array of department definitions. Returns the created department objects including id, name, created_at, and updated_at.
- **Get single Humand department by ID** (Get). Get a single department by id in Humand. Returns the department object including its id. Required: id.
- **Update a Humand department by ID** (Update). Update an existing department in Humand. Returns: id. Required: id.
- **Delete a Humand department by ID** (Delete). Delete a Humand department by id. Returns an empty 204 response on success. Required: id.
- **Humand departments list members** (List). List members of a specific Humand department by department id. Returns: employeeInternalId. Required: department_id.
- **Humand departments add members** (Add). Add members to a department in Humand by specifying the target department and the members to add. Required: department_id.
- **Humand departments remove members** (Delete). Remove members from a Humand department. Returns an empty 204 response on success. Required: department_id.
- **Humand departments bulk update** (Update). Update a user's department assignment in Humand by member id. Returns the updated department member record including employeeInternalId and departmentId. Required: member_id.
- **Humand service management list tasks** (List). List tasks for a Humand service item. Returns: id, created_at, updated_at. Required: sid.
- **Create a Humand course** (Create). Create a course in Humand. Returns the created course object including its id, with modules, tasks, and form configuration. Required body fields depend on the course structure being created.
- **Humand courses generate user courses report** (Generate). Generate a user course tasks report in Humand. Returns a UserCourseReport object containing user course and task progress data.
- **Humand courses get users progress** (Get). Get users' progress for a specific course in Humand. Returns a list of users with their course progress information. Required: course_id.
- **Create a Humand learning session** (Create). Create a learning session in Humand. Returns the created learning session object including its id, type, status, createdAt, and updatedAt. Required: type.
- **Update a Humand learning session by ID** (Update). Update a learning session in Humand by id. Returns the updated learning session object. Required: id.
- **Humand learning sessions upload cover picture** (Upload). Upload a cover picture for a learning session in Humand. Accepts a multipart form-data request containing the image file to be used as the session's cover picture.
- **List all Humand chats** (List). List chats in Humand. Returns: id, type, createdAt. These chat endpoints are deprecated; use the Marty API instead.
- **Humand chats list messages** (List). List messages for a Humand chat. Returns: id, type, createdAt. Required: chat_id. These chat endpoints are deprecated; use the Marty API instead.
- **Humand chats create message** (Create). Create a chat message in a specific Humand chat. Chat endpoints are deprecated; the Marty API should be used instead. Returns the created message object including its id. Required: chat_id.
- **Humand chats create one to one** (Create). Create a one-to-one chat in Humand between two specified users. Returns: id, type, createdAt. Required: user, otherUser. Chat endpoints are deprecated; use the new Marty API instead.
- **Humand chats mark read** (Action). Mark all messages in a Humand chat as read by chat_id. This endpoint is deprecated; use the Marty API instead. Returns an empty 204 response on success. Required: chat_id.
- **Humand knowledge libraries bulk upsert** (Upsert). Bulk upsert knowledge libraries in Humand by submitting an array of knowledge library items to create or update. Returns the resulting knowledge library records including their id and attributes. Required: body (array of knowledge library items).
- **List all Humand knowledge libraries** (List). List root knowledge libraries in Humand. Returns: id, attributes.
- **Get single Humand knowledge library by ID** (Get). Get a single knowledge library by its id in Humand. Returns the knowledge library detail object including id, created_at, and updated_at. Required: id.
- **Humand knowledge libraries get tree** (Get). Get the descendant tree of a knowledge library in Humand. Returns the tree structure of the knowledge library and its nested descendants. Required: knowledge_library_id.
- **Humand API keys rotate** (Rotate). Rotate the current Humand API key used for authentication, replacing it with a new key. No request body or parameters required.
- **Humand API keys revoke** (Revoke). Revoke the current Humand API key, permanently invalidating it. Returns an empty 204 response on success.
- **Humand API keys get allowed ips** (Get). Get the IP allowlist for the current Humand API key. Returns: ips.
- **Humand API keys delete allowed ips** (Delete). Remove the IP allowlist for the current API key in Humand. Returns an empty 204 response on success.
- **Humand API keys bulk update** (Update). Update the IP allowlist for the current API key in Humand. Returns the updated IP allowlist configuration for the current API key. No caller-supplied path or query parameters are required; the operation targets the API key used for authentication.
- **List all Humand profile fields** (List). List all profile field definitions in the Humand instance. Returns a collection of ProfileField objects.
- **Create a Humand profile field** (Create). Create profile field in Humand. Returns: uuid, name, type, visibility, enabled, editableByUser, position, options. Required: name, type, enabled, visibility, editableByUser.
- **Humand profile fields bulk create** (Create). Bulk create multiple profile fields in Humand in a single request by submitting an array of profile field definitions. Returns the created profile field records including their id, name, and type. Required: a JSON array body of profile field definition objects.
- **Create a Humand goal** (Create). Create the same goal for multiple users in Humand. Returns the created goal object including its id and goal-specific attributes. The request body corresponds to the Humand CreateGoal schema; individual field definitions are not enumerated in the discovered source — consult the Humand API docs for the full field breakdown.
- **Delete a Humand goal by ID** (Delete). Delete a goal in Humand by id. Returns an empty 204 response on success. Required: id.
- **Update a Humand goal by ID** (Update). Update a goal in Humand by id. Returns the updated goal object including its id. Required: id.
- **Humand goals create progress** (Create). Create progress for a goal in Humand by submitting progress data for the specified goal. Returns the created goal progress record. Required: goal_id.