How to integrate HiBob MCP with Hermes

Connect Hermes to HiBob MCP. List hibob employees by department, review pending hibob time off requests, and more using natural language, with authentication handled for you.

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

Introduction

Hermes is a 24/7 autonomous agent that lives on your computer or server — it remembers what it learns and evolves as your usage grows.

This guide explains the easiest and most robust way to connect your HiBob account to Hermes. You can do this through either Composio Connect CLI or Composio Connect MCP. For personal use we recommend the CLI, but you won't go wrong with MCP either.

Also integrate HiBob with

What is Composio Connect?

Composio Connect is a consumer offering that lets anyone plug 1,500+ applications directly into their agent harness — including Hermes. It can:

  • Search and load tools from relevant toolkits on-demand, reducing context usage.
  • Chain multiple tools to accomplish complex workflows via a remote workbench, without excessive back-and-forth with the LLM.
  • Manage app authentication end-to-end with zero manual overhead.

Integrating HiBob with Hermes

Using Composio Connect CLI

1. Install the Composio CLI

Run the install script directly, or paste https://composio.dev/hermes into your Hermes chat box to have it installed for you.

bash
curl -fsSL https://composio.dev/install | bash
Hermes authenticating with Composio

2. Authenticate

Once the CLI is installed, ask Hermes to authenticate with Composio.

3. Connect to HiBob

Ask your agent to connect to HiBob, or simply request any HiBob-related task. Hermes will prompt you to authenticate and authorize access.

4. Done. You're all set with a new HiBob connection.


Using Composio Connect MCP

1. Get your MCP URL and API Key

Go to dashboard.composio.dev and copy your Connect MCP URL and API key.

Copy MCP URL and API key from Composio dashboard

2. Open the Hermes config file

bash
nano ~/.hermes/config.yaml

3. Add the Composio Connect MCP server

bash
mcp_servers:
  composio:
    url: "https://connect.composio.dev/mcp"
    headers:
      x-consumer-api-key: "YOUR_COMPOSIO_API_KEY"
    connect_timeout: 60
    timeout: 180

Save with Ctrl + O, Enter, then exit with Ctrl + X.

4. Restart your Hermes agent

Once restarted, ask your agent to connect to HiBob or request any HiBob-related task. It will prompt you to authenticate and authorize access.

5. Done!

What is the HiBob MCP server, and what's possible with it?

The HiBob MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your HiBob account. It provides structured and secure access to employee records, attendance, time off, goals, training, projects, and workforce planning, so your agent can manage employee data, record attendance, submit time off requests, organize goals and training, and handle workforce planning tasks on your behalf.

  • Employee record management: Have your agent add employees and maintain details such as bank accounts, dependents, employment history, salary history, work history, training records, and other employee fields.
  • Attendance and project tracking: Let the agent clock employees in or out, create or update attendance entries, manage attendance projects and tasks, and mark tasks as complete.
  • Time off administration: Direct your agent to submit or cancel time off requests, adjust employee time off balances, and create time off reason codes.
  • Goals, skills, and training: Instruct your agent to create goals and key results, add or archive skills, and create or archive training content and employee training records.
  • Workforce planning: Have your agent create, budget, open, or cancel workforce planning positions, helping you manage planned hiring needs in HiBob.

Way Forward

With HiBob connected, Hermes can now act on your behalf whenever it detects a relevant task or you ask it to.

From here, you can extend Hermes further:

  • Connect more apps: Calendar, Slack, Notion, Linear, and hundreds of others are available through the same Composio Connect setup. Each new integration compounds what Hermes can do for you.
  • Build workflows across tools: Once multiple apps are connected, Hermes can chain actions together — turn an email into a calendar invite, a Slack message into a Linear ticket, or a meeting note into a follow-up draft.
  • Let it learn your patterns: The more you use Hermes, the better it gets at anticipating how you'd handle recurring tasks. Give it feedback on drafts and decisions, and it will adapt.

If you run into trouble or want to share what you've built, join the community or check out the Docs for deeper configuration options.

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.

FAQ

Frequently asked questions

With a standalone HiBob MCP server, the agents and LLMs can only access a fixed set of HiBob tools tied to that server. However, with the Composio Tool Router, agents can dynamically load tools from HiBob and many other apps based on the task at hand, all through a single MCP endpoint.

Yes, you can. Hermes fully supports MCP integration. You get structured tool calling, message history handling, and model orchestration while Tool Router takes care of discovering and serving the right HiBob tools.

Yes, absolutely. You can configure which HiBob scopes and actions are allowed when connecting your account to Composio. You can also bring your own OAuth credentials or API configuration so you keep full control over what the agent can do.

All sensitive data such as tokens, keys, and configuration is fully encrypted at rest and in transit. Composio is SOC 2 Type 2 compliant and follows strict security practices so your HiBob data and credentials are handled as safely as possible.

Start with HiBob.It takes 30 seconds.

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

Start building