SIGN UPLOG IN
X (Twitter)LinkedInGitHubDiscordYouTube

HiBob MCP server for AI agents and assistants

Securely connect your AI agents and chatbots (Claude, ChatGPT, Cursor, etc) with HiBob MCP or direct API to manage employee data, review attendance, track time off, and support workforce planning through natural language.

Get started for freeGet a demo
HiBob logoHiBob
Api Key

HiBob is a human resources platform for managing people data, time off, attendance, and workforce planning. It gives HR teams one place to organize employee information and daily people operations.

208 Tools

Try HiBob now

Type what you want done — sign in and watch it run live in the Tool Router playground.

TOOL ROUTER PLAYGROUND
HiBob
Try asking
TOOLS

Supported Tools

Every HiBob action and event your agent gets out of the box.

Archive Project

Archive an attendance project.

Archive Project Task

Archive a project task.

Archive skills

Bulk-archive API-origin skills by source and externalId locator.

Archive training content (bulk)

Mark one or more LMS training content items as archived.

Bulk create attendance entries

Create one or more duration or start-end attendance entries.

Bulk update attendance entries for an employee

Update one or more attendance entries for a specific employee.

Cancel Position

Immediately cancel one workforce-planning position.

Cancel time off request

Cancel an employee's time off request.

Clock in (create entry)

Create an attendance entry by clocking in an employee.

Clock out

Record clock-out for an employee with an open clock-in.

Mark a task as complete

Marks a task as complete.

Create company employee

This endpoint allows you to create a new employee in the system.

Create new custom table entry

Create an entry in an employee's custom table from column-value pairs.

Create a new bank account entry for a given employee

Create a new bank account entry for a given employee.

Create a deduction entry for an employee

Creates a new deduction table entry for the employee.

Create a dependent entry for an employee

Creates a new dependent entry for the employee.

Creates a new employment entry for a given employee

Creates a new employment entry for a given employee.

Create an entitlement entry for an employee

Creates a new entitlement table entry for the employee.

Creates a new equity grant for a given employee

Creates a new equity grant for a given employee.

Create a new field

Create a new field.

Create a right to work entry for an employee

Creates a new right to work entry for the employee.

Creates a new salary entry for a given employee

Creates a new salary entry for a given employee.

Creates a new training records for a given employee

Create a new training record in the Training table.

Creates a new variable payment for a given employee

Creates a new variable pay entry for the employee.

Create a new work entry for a given employee

Create a new work entry for a given employee.

Create goals

Creates up to 25 goals in HiBob.

Create integration

Create an LMS provider integration in Bob.

Create key results

Creates up to 25 key results for an existing goal.

Add a new item to an existing list

Add a new item to an existing list.

Create Position

Create workforce-planning positions with their required opening and optional budget.

Create Position Budget

Create a budget for a workforce-planning position.

Create Position Opening

Create one or more openings for a workforce-planning position.

Create Project(s)

Create one or more attendance projects.

Create Project Task(s)

Create one or more attendance project tasks.

Create skills

Bulk-create API-origin skills with per-item results.

Create time off balance adjustment

Add a manual balance or time-used adjustment for an employee.

Create time off reason codes

Create reason codes for a configured time off policy type.

Create time off request

Submit a time off request for an employee using one documented duration shape.

Create training content (bulk insert)

Create up to 500 training content items for an LMS integration.

Delete an attendance entry

Permanently delete an attendance entry by ID.

Delete a Document from a Confidential Folder

Delete a document from an employee's confidential folder.

Delete a Document from a Custom Folder

Delete a document from an employee's custom folder.

Delete custom table entry

Delete custom table entry.

Deletes a bank account entry from a given employee's bank accounts table

Deletes a bank account entry from a given employee's bank accounts table.

Delete a deduction entry for an employee

Deletes a deduction entry for the given employee.

Delete a dependent entry for an employee

Deletes a dependent entry for the given employee.

Deletes an employment entry from a given employee's employment history

Deletes an employment entry from a given employee's employment history.

Delete an entitlement entry for an employee

Deletes an entitlement entry for the given employee.

Deletes an equity grant for an employee

Deletes an equity grant for an employee.

Delete an existing field

Delete an existing field.

Delete a right to work entry for an employee

Deletes a right to work entry for the given employee.

Deletes a salary entry from the employee's list

Deletes a salary entry from the employee's list.

Deletes any training records for an employee

Deletes any training records for an employee.

Deletes a variable payment record for an employee

Deletes a variable pay entry for the given employee.

Deletes a work entry from a given employee's work history

Deletes a work entry from a given employee's work history.

Delete goal

Permanently deletes a goal by ID.

Delete key result

Permanently deletes a key result from a goal.

Delete LMS integration

Delete an LMS provider integration from Bob.

Delete an item from an existing list

Delete an item from an existing list.

Delete Position Opening

Delete an opening from a workforce-planning position.

Delete a Document from a Shared Folder

Delete a document from an employee's shared folder.

Download the report by ID

Returns a report data file in the specified format.

Download a report by the report name

Downloads a report generated by the asynchronous report endpoint.

Read avatar URL for an employee email

Returns the employee's avatar image URL without fetching the image.

Read avatar URL for an employee ID

Returns the employee's avatar image URL without fetching the image.

Read metadata for specific custom table

Read metadata for specific custom table.

Get document folders metadata

List Bob document folders and their identifiers.

Get employee time off balance

Retrieve an employee's balance for a policy type at a point in time.

Get employer metadata

Returns the field catalog for the `employer` object — the set of fields a client can read, with their types, validations, and status.

Get goal cycle metadata

Returns metadata describing the fields available on goal cycles.

Get goals metadata

Returns metadata describing the fields available on goals.

Get goal type metadata

Returns metadata describing the fields available on goal types.

Get job ad

Returns details of a job ad promoted on the Bob careers page.

Get job family group metadata

Returns metadata describing job-family-group fields.

Get job family metadata

Returns metadata describing job-family fields.

Get job profiles metadata

Returns metadata describing job-profile fields.

Get job role metadata

Returns metadata describing job-role fields.

Get key results metadata

Returns metadata describing the fields available on key results.

Get a specific company list by name

Get a specific company list by name.

Read company employee fields by employee ID

Single-employee read endpoint (not bulk search): returns field data for one employee identified by backend ID or email in the path in a single response.

Get Position Budget Metadata

Get the field metadata for workforce-planning position budgets.

Get Position Metadata

Get the field metadata for workforce-planning positions.

Get Position Opening Metadata

Get the field metadata for workforce-planning position openings.

Get Project Client Metadata

Get metadata describing available project client fields.

Get Project Metadata

Get metadata describing available attendance project fields.

Get Project Task Metadata

Get metadata describing available project task fields.

Get time off policy details

Retrieve details of a named time off policy.

Get time off policy type

Retrieve a configured time off policy type.

Get time off request

Retrieve one employee time off request by ID.

Get work location metadata

Returns the field catalog for the `workLocation` object — the set of fields a client can read, with their types, validations, and status.

Import attendance data

Import employee clock-in and clock-out events.

Invite an employee with a welcome wizard ID

Invite an employee to HiBob using an onboarding welcome wizard.

List company job profiles

Searches company job profiles and returns one page of matching profiles.

Get all company lists

Get all company lists.

Read company reports

Returns a list of all company reports with their details.

Read all entries of the given custom table

Read all entries of the given custom table.

Read metadata of custom tables defined

Read metadata of custom tables defined.

List employee's bank accounts

Returns a list of the bank accounts table entries for a given employee.

List deduction entries for a list of employees

Returns deduction table entries for all employees or a specific list of employees.

List dependents for a list of employees

Returns dependent entries for all employees or a specific list of employees.

Download list of documents of an employee

Return an employee's documents with downloadable file references.

List employee's employment history

Returns a list of employment history entries for a given employee.

List employment history for a list of employees

Returns a list of historical employment entries from the employment table for all employees or a specific list of employees.

List entitlement entries for a list of employees

Returns entitlement table entries for all employees or a specific list of employees.

List equity grants for a list of employees

Returns equity table entries for all employees or a specific list of employees.

List the employee's equity grants

Returns a list of equity grants for a given employee.

Get all employee fields

This endpoint retrieves only metadata about the employee fields and includes all employee fields.

List employee's lifecycle status history

Returns a list of historical lifecycle entries from the lifecycle table for an employee.

List the lifecycle history for a list of employees

Returns a list of historical lifecycle entries from the lifecycle table for all employees or a specific list of employees.

Read the public profile section of all active employees

Returns a predefined list of fields for all active employees the service user can access.

List right to work entries for a list of employees

Returns right to work entries for all employees or a specific list of employees.

List payroll history (salaries) for a list of employees

Returns a list of historical salary entries from the payroll table for all employees or a specific list of employees.

List employee's salary history

Returns a list of historical salary entries from the salary table in the payroll section for an employee.

Read tasks of a specific employee

Returns tasks for a specific employee, optionally filtered by status.

List the employee's training records

Returns a list of training entries from the employee's Training table, for a given employee.

List employee's variable payments

Returns a list of variable payments for a given employee.

List variable pay entries for a list of employees

Returns variable pay table entries for all employees or a specific list of employees.

List employee's work history

Returns a list of historical work entries from the work table for an employee.

List work history for a list of employees

Returns a list of historical work entries from the work table for all employees or a specific list of employees.

List job families

Returns one page of job families from the company job catalog.

List job family groups

Returns one page of job-family groups from the company job catalog.

List job roles

Returns one page of job roles from the company job catalog.

Get a summary of all onboarding wizards

List onboarding welcome wizards and their IDs for inviting employees.

List open tasks

Returns up to 5,000 open company tasks ordered by task ID.

Read payroll tables history

List legacy payroll-table history, optionally filtered by department and inactive employees; this provider endpoint is planned for deprecation.

List people out of office

List people with time off requests in an inclusive date range.

List people out today

List people who are out on a selected date.

List proficiency levels

Lists the company's proficiency levels referenced by skill create and update operations.

List time off policy names

List policy names belonging to a time off policy type.

List time off policy types

List configured time off policy type names.

List time off reason codes

List request reason codes configured for a policy type.

List time off request changes

List time off requests created, canceled, deleted, or pending since a point in time.

Restore Project

Restore an archived attendance project.

Restore Project Task

Restore an archived project task.

Revoke access to Bob for an employee

Revoke an employee's access to HiBob without deleting the employee record.

Schedule Position Cancellation

Cancel multiple positions immediately or on a specified date.

Search for actual payments

This endpoint allows you to search for actual payments based on various filters.

Search application form answers

Searches application form answer records using filters and returns one page of results.

Search applications

Searches applications using filters and returns one page of results.

Fetch attendance entries

Retrieve one page of attendance entries for employees and dates.

Fetch attendance summaries

Retrieve one page of attendance summaries by employee and date range.

Search calendar events

Search holiday and company-closure calendar events for an inclusive date range.

Search candidate educations

Searches candidate education records and returns one page.

Search candidate experiences

Searches candidate work experience records and returns one page.

Search candidate languages

Searches candidate language records and returns one page.

Search candidate professional association memberships

Searches candidate professional association membership records and returns one page.

Search candidate qualifications and licenses

Searches candidate qualification and license records and returns one page.

Search candidates

Searches candidates using filters and returns one page of results.

Search candidate skills

Searches candidate skill records and returns one page.

Search candidate volunteer experiences

Searches candidate volunteer experience records and returns one page.

Fetch daily attendance breakdown

Retrieve one page of daily attendance breakdown data for employees.

Search employee calendars

Resolve holiday calendars for employees and return one page of results.

Search employers

Searches employers in the caller's company.

Search evaluations

Searches evaluation records and returns one page.

Search evaluation scorecard templates

Searches evaluation scorecard templates and returns one page.

Search goal cycles

Searches goal cycles and returns one page of matching records.

Search goals

Searches goals and returns one page of matching records.

Search goal types

Searches goal types and returns one page of matching records.

Search interviews

Searches interview records and returns one page.

Search job ads

Returns active job ads promoted on the Bob career page.

Search job openings

Searches job openings using filters and returns one page.

Search key results

Searches key results for a goal and returns one page.

Search offers

Searches offer records and returns one page.

Search for employees

Search employee fields for many employees in one call.

Search Position Budgets

Return one page of workforce-planning position budgets.

Search Position Openings

Return one page of workforce-planning position openings.

Search Positions

Search workforce-planning positions using documented field filters.

Search Project Clients

Search project clients and return one page of results.

Search Projects

Search attendance projects and return one page of results.

Search Project Tasks

Search attendance project tasks and return one page of results.

Search skills

Searches API-origin skills with field projection, filters, and one-page cursor pagination.

Search work locations

Searches the work locations of a single employer, identified by the path parameter `{employerId}`.

Set or update an employee's start date

Set or change an employee's employment start date, with an optional reason.

Get the report download URL for polling

Asynchronously generates a report.

Submit xAPI statement

Submit one xAPI statement to record learner progress for a course.

Terminate company employee

This changes the employee’s status to Terminated according to specified termination date.

Update company employee

This endpoint allows you to update specific fields in an employee's record in Bob.

Update custom table entry

Update an employee's custom-table entry from column-value pairs.

Upload employee's avatar by image url

Upload an employee's Avatar by providing a URL to the image to upload.

Update a bank account entry in the employee's bank accounts table

This endpoint updates an entry in the employee’s Bank accounts table.

Update a deduction entry for an employee

Updates an existing deduction entry for the given employee.

Update a dependent entry for an employee

Updates an existing dependent entry for the given employee.

Update an employee's email address

Change an employee's email address.

Update an employment entry from a given employee's employment history

This endpoint updates an entry in the employee’s employment history table.

Update an entitlement entry for an employee

Updates an existing entitlement entry for the given employee.

Updates an equity grant for an employee

This endpoint updates an entry in the employee’s equity table.

Update an existing field

Update an existing field.

Update a right to work entry for an employee

Updates an existing right to work entry for the given employee.

Update a variable payment for an employee

Updates an existing variable pay entry for the given employee.

Update a work entry in the employee's work history table

This endpoint updates an entry in the employee’s work history table.

Update goal

Updates details of an existing goal.

Update goal status

Updates the status of an existing goal and optionally records a comment.

Update key results details

Updates details of one or more key results on a goal.

Update key results progress

Records progress values and optional check-in notes for key results.

Update an existing item from a list

Update an existing item from a list.

Update Position

Update the mutable fields of one workforce-planning position.

Update Position Budget

Update a budget attached to a workforce-planning position.

Update Position Opening

Update an opening attached to a workforce-planning position.

Update Project

Update an attendance project's fields and employee audience.

Update Project Task

Update the name and billable state of a project task.

Update skills

Bulk-update API-origin skills resolved by source and externalId locator.

Update training content (bulk patch)

Update one or more training content items for an LMS integration.

Upload File to a Confidential Folder

Upload a file directly into an employee's confidential folder.

Upload file from a URL to a Confidential Folder

Upload a document from a URL into an employee's confidential folder.

Upload File to a Custom Folder

Upload a file directly into an employee's custom folder.

Upload File from a URL to a Custom Folder

Upload a document from a URL into an employee's custom folder.

Upload file to a Shared Folder

Upload a file directly into an employee's shared folder.

Upload file from a URL to a Shared Folder

Upload a document from a URL into an employee's shared folder.

SETUP GUIDE

Connect HiBob MCP Tool with your Agent

1

Install Composio

typescript
npm install @composio/core ai @ai-sdk/mcp @ai-sdk/openai
Install the Composio SDK and your agent framework
2

Create a session with MCP enabled

typescript
import { Composio } from "@composio/core";

const composio = new Composio();
const { mcp } = await composio.create("your-user-id", {
  toolkits: ["hibob"],
  mcp: true,
});
Create a session scoped to HiBob and read its MCP URL and headers
3

Connect your agent to the MCP server

typescript
import { createMCPClient } from "@ai-sdk/mcp";
import { openai } from "@ai-sdk/openai";
import { generateText, stepCountIs } from "ai";

const client = await createMCPClient({
  transport: { type: "http", url: mcp.url, headers: mcp.headers },
});

const { text } = await generateText({
  model: openai("gpt-5.6-sol"),
  tools: await client.tools(),
  prompt: "List all employees in HiBob and group them by department.",
  stopWhen: stepCountIs(10),
});

console.log(text);
await client.close();
Pass the session's MCP URL and headers to your agent and run a HiBob request
SETUP GUIDE

Connect HiBob API Tool with your Agent

1

Install Composio

typescript
npm install @composio/core @composio/openai openai
Install the Composio SDK, the OpenAI provider, and the OpenAI SDK
2

Create a Composio session

typescript
import OpenAI from "openai";
import { Composio } from "@composio/core";
import { OpenAIResponsesProvider } from "@composio/openai";

const composio = new Composio({ provider: new OpenAIResponsesProvider() });
const client = new OpenAI();

const session = await composio.create("your-user-id", { toolkits: ["hibob"] });
const tools = await session.tools();
Initialize Composio with the OpenAI Responses provider and create a session scoped to HiBob
3

Run HiBob tools with your agent

typescript
let response = await client.responses.create({
  model: "gpt-5.6-sol",
  tools,
  input: [{ role: "user", content: "List all employees in HiBob and group them by department." }],
});

while (response.output.some((o) => o.type === "function_call")) {
  const outputs = await composio.provider.handleToolCalls(session, response.output);
  response = await client.responses.create({
    model: "gpt-5.6-sol",
    tools,
    previous_response_id: response.id,
    input: outputs,
  });
}

console.log(response.output_text);
Send a request, execute the HiBob tool calls through the session, and print the final answer

Why Use Composio?

AI Native HiBob Integration

  • Supports both HiBob MCP and direct API based integrations
  • Structured, LLM-friendly schemas for reliable tool execution
  • Rich coverage for reading, writing, and querying employee, attendance, and time off data

Secure API Key Auth

  • Connect HiBob with your own API key credentials
  • Keep credentials out of prompts, application code, and agent conversations
  • Manage access centrally and rotate keys without changing agent workflows

Agent Optimized Design

  • Tools are tuned using real error and success rates to improve reliability over time
  • Clear schemas help agents choose the right HiBob action and provide the required fields
  • Comprehensive execution logs show what ran, when, and on whose behalf

Enterprise Grade Security

  • Fine-grained RBAC helps control which agents and users can access HiBob
  • Scoped, least privilege access protects employee and workforce data
  • Full audit trails support HR reviews, security checks, and compliance workflows
FRAMEWORKS

Use HiBob with any AI Agent Framework

Choose a Framework you want to connect HiBob with

ChatGPT logo

ChatGPT

Use HiBob MCP with ChatGPT

Claude Cowork logo

Claude Cowork

Use HiBob MCP with Claude Cowork

Hermes logo

Hermes

Use HiBob MCP with Hermes

Atomic Agent logo

Atomic Agent

Use HiBob MCP with Atomic Agent

Rolling this out across your team?

Give your team centralized access control across every framework with Composio’s MCP Gateway.

EXPLORE MCP GATEWAY
FAQ

Frequently asked questions

Yes, HiBob requires you to configure your own API key credentials. Once set up, Composio handles secure credential storage and API request handling for you.

Yes! Composio's Tool Router enables agents to use multiple toolkits. Learn more.

Yes. Composio is SOC 2 Type II compliant and is built to keep your HiBob connection and credentials secure. OAuth tokens and API keys are encrypted, and sensitive customer data is protected at rest and in transit.

Composio also undergoes independent security testing and continuously monitors its systems for security threats. You can review the latest reports and policies in the Composio Trust Center.

Composio maintains and updates all toolkit integrations automatically, so your agents always work with the latest API versions.

Create the key in your HiBob account settings, then paste it once on Composio's connection page. Composio stores it encrypted and uses it only for the HiBob actions your agent runs. Nobody else in your workspace can read it, and you can revoke it inside HiBob at any time.

When you connect a HiBob account through Composio, every action runs under that account, so anything the agent creates, sends, or changes shows up in HiBob as done by you. Keep an approval step in your prompt for actions with side effects, such as sending or deleting, and have the agent draft first.

Whatever the credentials you connect allow inside HiBob. If HiBob lets you scope a key to specific permissions, create a scoped one so the agent can only do what you intend. You can revoke the key inside HiBob at any time.

Yes. Composio supports multiple connected accounts for the same app, and that works in Claude, ChatGPT, or any other assistant you connect through Composio. Give each HiBob connection a name such as work or personal, and the assistant uses the one you mention in the request. Each account keeps its own credentials and nothing is merged.

The connection stops working the moment HiBob rejects the old key. Create a new key in HiBob and reconnect the account from the Composio dashboard or by asking your agent to reconnect HiBob. Nothing else changes.

Composio's free Hobby plan includes 100,000 tool calls per month with no credit card, which covers most personal HiBob use. Paid plans add higher limits and team features. Your HiBob plan and its API limits still apply as usual.

Built-in connectors usually give one AI access to a limited set of apps. Many people use Composio because it lets their AI connect to more apps than it normally supports, or connect to multiple accounts for the same app (e.g. connect Claude to multiple HiBob accounts).

With Composio, you connect HiBob once and then use it across different AI assistants without setting it up separately in each one. Connect your apps to Composio once, then connect Composio to whichever AI you use, whether that's Claude, ChatGPT, Hermes, or your own custom assistant.

Start with HiBob.It takes 30 seconds.

Managed auth, hosted MCP servers, and every HiBob tool your agent needs.Free to start.

Start building