How to integrate Zelt MCP with Hermes

Connect Hermes to Zelt MCP. List active employees in zelt, review employee documents in zelt, and more using natural language, with authentication handled for you.

Zelt logoZelt
Oauth2

Zelt is a people operations platform for HR, payroll, benefits, devices, and workforce data. It brings employee operations into one secure, organized workspace.

163 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 Zelt 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.

For exact tool slugs and parameter tables, see the tool catalog in the Composio docs.

Also integrate Zelt with

What is Composio Connect?

Composio Connect is a consumer offering that lets anyone plug 1,700+ 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 Zelt 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 Zelt

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

4. Done. You're all set with a new Zelt 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 Zelt or request any Zelt-related task. It will prompt you to authenticate and authorize access.

5. Done!

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

The Zelt MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your Zelt account. It provides structured and secure access to workforce records and people operations, so your agent can create users, organize departments and roles, manage absences and attendance, and set up HR tasks and documents on your behalf.

  • Workforce and organization setup: Have your agent create users, departments, company entities, sites, job levels, job positions, and work schedules in Zelt.
  • Absence and attendance management: Let the agent create absence policies, record absences, import attendance entries, and create attendance jobs.
  • Employee records and benefits: Direct your agent to add user addresses, contracts, compensation, equity, family members, benefits, health insurance, pensions, bank accounts, tax information, roles, and ID checks.
  • HR documents and equipment: Instruct your agent to create company documents and add devices for workforce administration.
  • Requests, goals, and task planning: Have your agent create request templates, submit requests, set goals, create tasks, and add task checklists.

Way Forward

With Zelt 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 Zelt action and event your agent gets out of the box.

Bulk Import Attendance

Bulk import attendance entries (max 100 per request).

Create Absence

Create a new absence.

Create Absence Policy

Create a new absence policy.

Create Attendance Job

Create a new attendance job.

Create Benefit

Create a new benefit.

Create Company Entity

Create a new company entity (legal entity).

Create Department

Create a new department.

Create Device

Create a new device.

Create Documents

Create one or multiple documents for company.

Create Goal

Create a new goal.

Create Health Insurance Policy

Creates the company health insurance policy.

Create Job Level

Create a new job level.

Create Job Position

Create a new job position.

Create Request

Submits a new request on behalf of the calling user against the given request template.

Create Request Template

Create a new request template.

Create Site

Create a new site.

Create Task

Create a new task.

Create Task Checklist

Create a new task checklist.

Create User

Create a new user.

Create User Address

Create a new user address record.

Create User Bank Account

Create a new user bank account record.

Create User Benefit

Enrol a user into a benefit.

Create User Compensation

Create a new user compensation record.

Create User Contract

Create a new user contract record.

Create User Equity

Create a new user equity grant.

Create User Family Member

Add a new user family member.

Create User Health Insurance

Enrol a user into a health insurance policy.

Create User ID Checks

Initiates an id check for the user for each given package id.

Create User Pension

Enrol a user into a pension scheme.

Create User Role

Create a new user role record.

Create User Tax Information

Create a new user tax information record.

Create Work Schedule

Create a new work schedule.

Delete Absence

Delete an absence by id.

Delete Absence Policy

Delete an absence policy by id.

Delete Attendance Entry

Delete an attendance entry by id.

Delete Attendance Job

Delete an attendance job by id.

Delete Benefit

Delete a benefit by id.

Delete Company Entity

Delete a company entity (legal entity) by id.

Delete Department

Delete a department by id.

Delete Document

Delete a document by id.

Delete Goal

Delete a goal by id.

Delete Health Insurance Policy

Delete a health insurance policy by id.

Delete Job Level

Delete a job level by id.

Delete Job Position

Delete a job position by id.

Delete Request

Delete a submitted request.

Delete Request Template

Deletes the template.

Delete Site

Delete a site by id.

Delete Task

Delete a task by id.

Delete Task Checklist

Deletes the checklist.

Delete User Address

Delete a user address record.

Delete User Bank Account

Delete a user bank account record.

Delete User Benefit

Unenrol a user from a benefit.

Delete User Compensation

Delete user compensation record.

Delete User Contract

Delete a user contract record.

Delete User Equity

Delete a user equity grant.

Delete User Family Member

Delete a user family member.

Delete User Health Insurance

End a user's health-insurance coverage on the specified end date.

Delete User Pension

Delete a user pension record.

Delete User Role

Delete user role record.

Delete Work Schedule

Delete a work schedule by id.

Get Absence

Get an absence by id.

Get Absence Policy

Get an absence policy by id.

Get Attendance Entry

Get an attendance entry by id.

Get Attendance Job

Get an attendance job by id.

Get Benefit

Get a benefit by id.

Get Benefit Payment

Use status to only return the payment if it matches the given status.

Get Company Entity

Get a company entity (legal entity) by id.

Get Current User Address

Get current user address by user id.

Get Current User Bank Account

Get current user bank account by user id.

Get Current User Compensation

Get currently effective compensation details.

Get Current User Contract

Get current user contract by user id.

Get Current User Event

Get currently effective user event.

Get Current User Role

Get currently effective user role.

Get Current User Tax Information

Get currently effective tax information by user id.

Get Device

Get a device by id.

Get Document

Get a document by id.

Get Health Insurance Policy

Get a health insurance policy by id.

Get Request

Get a submitted request by id.

Get Request Template

Get a request template by id.

Get Task

Get a task by id.

Get Task Checklist

Get a task checklist by id.

Get User Bank Account

Get a user bank account by id.

Get User Basics

Get user basic details.

Get User Benefit

Get a user benefit record by id.

Get User Compensation

Returns the compensation payload for a user; Zelt does not publish its response fields.

Get User Equity

Get a user equity grant by id.

Get User Family Member

Get a user family member by id.

Get User Health Insurance

Get a user health insurance record by policy id.

Get User ID Check

Get an id check by id.

Get User Pension

Get a user pension record by id.

Get User Personal

Get user personal info.

Get User Role

Get user role details.

Get User Tax Information

Get user tax information by user id.

Get User Tax Information Record

Get a user tax information record by id.

Get Work Schedule

Get a work schedule by id.

List Absence Policies

Returns a paginated list of absence policies for the company.

List Absences

Returns a paginated list of absences.

List Attendance Entries

Returns a paginated list of attendance entries for the company.

List Attendance Jobs

Returns a paginated list of attendance jobs for the company.

List Benefit Payments

Returns a paginated list of benefit payments for the company.

List Benefits

Returns a paginated list of benefits for the company.

List Company Entities

Returns a paginated list of company entities for the company.

List Departments

List all departments for company.

List Devices

Returns a paginated list of devices for the company.

List Document Types

List all document types for company.

List Goal Key Results

Returns a paginated list of key results for a goal.

List Goals

Returns a paginated list of company-level goals.

List Health Insurance Policies

Returns a paginated list containing the company health insurance policy, if one exists.

List Job Levels

List all job levels.

List Job Positions

List all job positions.

List Permission Group Members

List all permission groups with members for the company.

List Requests

Returns a paginated list of submitted requests for the company.

List Request Templates

Returns a paginated list of request templates for the company.

List Sites

List all sites for company.

List Task Checklists

Returns a paginated list of task checklists for the company.

List Tasks

Returns a paginated list of tasks for the company.

List User Addresses

Get user addresses by user id.

List User Bank Accounts

Get user bank accounts by user id.

List User Benefits

Returns a paginated list of currently effective benefit records for a user.

List User Contracts

Returns the contracts payload for a user; Zelt does not publish its response fields.

List User Equity

Returns a paginated list of equity grants for a user.

List User Events

Get user events by user id.

List User Family Members

Returns a paginated list of family members for a user.

List User Health Insurance

Returns a paginated list of health insurance records for a user.

List User ID Checks

Returns a paginated list of id checks for a user.

List User Pension

Returns a paginated list containing the user's current pension record, if one exists.

List Users

List all users for company.

List Work Schedules

Returns a paginated list of work schedules for the company.

Rehire User

Rehire a user.

Update Absence

Update an absence by id.

Update Absence Policy

Updates the general settings of an absence policy.

Update Attendance Entry

Update an attendance entry by id.

Update Attendance Job

Update an attendance job by id.

Update Benefit

Update a benefit by id.

Update Benefit Payment

Updates an existing benefit payment record.

Update Company Entity

Update a company entity (legal entity) by id.

Update Department

Update a department by id.

Update Device

Update a device by id.

Update Document

Update a document by id.

Update Goal

Update a goal by id.

Update Health Insurance Policy

Update a health insurance policy by id.

Update Job Level

Update a job level by id.

Update Job Position

Update a job position by id.

Update Request

Approves or rejects a pending request.

Update Request Template

Update a request template by id.

Update Site

Update a site by id.

Update Task

Update a task by id.

Update Task Checklist

Update a task checklist by id.

Update User Address

Update a user address record.

Update User Bank Account

Update a user bank account record.

Update User Basics

Update user basic details.

Update User Benefit

Update a user benefit record.

Update User Compensation

Update user compensation record.

Update User Contract

Update a user contract record.

Update User Equity

Update a user equity grant.

Update User Event

Update a user event by id.

Update User Family Member

Update a user family member.

Update User Health Insurance

Update a user health insurance record.

Update User Pension

Update a user pension record.

Update User Personal

Update user personal info.

Update User Role

Update user role record.

Update User Tax Information Record

Update a user tax information record.

Update Work Schedule

Update a work schedule by id.

FAQ

Frequently asked questions

Start with Zelt.It takes 30 seconds.

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

Start building