SIGN UPLOG IN
X (Twitter)LinkedInGitHubDiscordYouTube

How to integrate Lever MCP with Hermes

Connect Hermes to Lever MCP. List all open job postings, get candidate details by email, and more using natural language, with authentication handled for you.

Get started for freeGet a demo
Lever logoLever
Api KeyOauth2

Lever is an applicant tracking system that blends sourcing, CRM, and analytics for recruiting. It helps companies scale hiring with collaborative workflows and actionable insights.

64 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 Lever 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 Lever with

Claude CodeClaude CoworkOpenAI Agents SDKClaude Agent SDKCodexOpenClawAtomic AgentGoogle ADKLangChainVercel AI SDKMastra AILlamaIndexCrewAIPydantic AIAutoGen

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 Lever 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 Lever

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

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

5. Done!

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

The Lever MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your Lever account. It provides structured and secure access to your recruiting pipeline, so your agent can perform actions like managing candidates, scheduling interviews, updating requisitions, tracking offers, and listing hiring stages on your behalf.

  • End-to-end candidate management: Let your agent add, update, or tag candidates in your hiring process seamlessly.
  • Automated interview scheduling: Have the agent create, modify, or cancel interviews and retrieve interview details to streamline the process.
  • Job posting and requisition updates: Direct your agent to list job postings, update existing requisitions, or close filled roles instantly.
  • Offer and feedback tracking: Enable your agent to list offers, track acceptance rates, and collect structured feedback from interviewers.
  • Recruiting analytics and reporting: Ask the agent to list pipeline opportunities, recruitment sources, and candidate tags, helping you make data-driven hiring decisions.

Way Forward

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

Add Opportunity Links

Tool to add links to a contact associated with an opportunity.

Add Opportunity Sources

Tool to add sources to an opportunity.

Add Opportunity Tags

Tool to add tags to an opportunity.

Create Form Submission

Tool to create a completed profile form submission for a candidate's opportunity profile.

Create Form Template

Tool to create a profile form template for an account.

Create Interview

Tool to create an interview on an externally-managed panel in Lever.

Create Note

Tool to create a note on an opportunity profile or add a threaded comment to an existing note.

Create Opportunity

Tool to create a new candidate opportunity in Lever.

Create Panel

Tool to create a new interview panel for an opportunity.

Create Requisition

Tool to create a new requisition in Lever for tracking hiring needs.

Create Requisition Field

Tool to create a custom requisition field schema for use across requisitions.

Create Requisition Field Option

Add new options to a Lever dropdown requisition field without replacing its existing choices.

Upload File

Upload a file temporarily to Lever for use in posting applications.

Create User

Tool to create a new user in the Lever system.

Deactivate User

Tool to deactivate a user in the Lever system.

Delete Form Template

Tool to delete a profile form template from account.

Delete Interview

Delete an interview from an opportunity's externally managed panel on behalf of a user.

Delete Note

Tool to delete a note on an opportunity.

Delete Panel

Tool to delete a panel from an opportunity.

Delete Requisition

Delete a requisition from a Lever account by its ID.

Delete Requisition Field

Delete a requisition field from the account.

Delete Requisition Field Option

Tool to remove specific options from a dropdown requisition field.

Download File

Tool to download a file associated with an opportunity.

Get File Metadata

Tool to retrieve metadata for a single file on an opportunity.

Get Form

Tool to retrieve a specific profile form for an opportunity.

Get Form Template

Tool to retrieve a single form template by unique identifier.

Get Interview

Tool to retrieve a single interview for an opportunity.

Get Note

Tool to retrieve a single note for an opportunity.

Get Opportunity

Tool to retrieve detailed information about a single opportunity.

Get Panel

Tool to retrieve a single interview panel for an opportunity.

Get Requisition

Retrieve a single requisition by ID, including hiring status and headcount.

Get Requisition Field

Tool to retrieve detailed information about a single custom requisition field by ID.

Get Stage

Tool to retrieve detailed information about a single stage by its UUID.

Get User

Tool to retrieve detailed information about a single user by their UUID.

List Opportunity Files

Tool to list all files on an opportunity.

List Forms

Tool to list all profile forms for an opportunity.

List Form Templates

Tool to list all active form templates.

List Interviews

List a page of interviews for an opportunity, with pagination controls for additional results.

List Notes

List notes on a Lever opportunity profile using its opportunity ID.

List Offers

Tool to list offers for an opportunity.

List Opportunities

List a page of hiring pipeline opportunities with optional filters for contact, posting, stage, tags, time ranges, and other criteria.

List Panels

Tool to list all interview panels for an opportunity.

List Postings

List job postings with optional filters for state, team, department, location, commitment, level, tag, or update timestamp.

List Referrals

Tool to list all referrals for an opportunity.

List Requisition Fields

List requisition field schemas in a Lever account, with optional filtering by field type.

List Requisitions

Tool to list all requisitions with filtering and pagination.

List Opportunity Resumes

List resume records for a specified Lever opportunity, including available file metadata and parsed resume data.

List Sources

Tool to list all recruitment sources in your Lever account.

List Stages

Tool to retrieve all pipeline stages in your Lever account.

List Tags

Tool to list all tags in your Lever account.

List Users

Tool to retrieve all active users in your Lever account with optional filters.

Reactivate User

Tool to reactivate a previously deactivated user in the Lever system.

Remove Contact Links by Opportunity

Tool to remove links from a contact associated with an opportunity.

Remove Opportunity Sources

Tool to remove sources from an opportunity.

Remove Opportunity Tags

Tool to remove tags from an opportunity.

Update Form Template

Tool to update an existing profile form template.

Update Interview

Update an interview on an externally managed panel.

Update Note

Update an API-created note on an opportunity profile.

Update Panel

Update an externally managed interview panel for an opportunity, including its interviews and other panel details.

Update Requisition

Update an existing requisition's details, such as name, headcount and status.

Update Requisition Field

Tool to update an existing requisition field in Lever.

Update Requisition Field Option

Update the display text of one or more existing options in a Lever dropdown requisition field.

Update User

Tool to update an existing user in the Lever system.

Upload File to Opportunity

Tool to upload a file permanently to an opportunity.

FRAMEWORKS

How to build Lever MCP Agent with another framework

Claude Code logo

Claude Code

Use Lever MCP with Claude Code

Claude Cowork logo

Claude Cowork

Use Lever MCP with Claude Cowork

OpenAI Agents SDK logo

OpenAI Agents SDK

Use Lever MCP with OpenAI Agents SDK

Claude Agent SDK logo

Claude Agent SDK

Use Lever MCP with Claude Agent SDK

Codex logo

Codex

Use Lever MCP with Codex

OpenClaw logo

OpenClaw

Use Lever MCP with OpenClaw

Atomic Agent logo

Atomic Agent

Use Lever MCP with Atomic Agent

Google ADK logo

Google ADK

Use Lever MCP with Google ADK

LangChain logo

LangChain

Use Lever MCP with LangChain

Vercel AI SDK logo

Vercel AI SDK

Use Lever MCP with Vercel AI SDK

Mastra AI logo

Mastra AI

Use Lever MCP with Mastra AI

LlamaIndex logo

LlamaIndex

Use Lever MCP with LlamaIndex

CrewAI logo

CrewAI

Use Lever MCP with CrewAI

Pydantic AI logo

Pydantic AI

Use Lever MCP with Pydantic AI

AutoGen logo

AutoGen

Use Lever MCP with AutoGen

FAQ

Frequently asked questions

With a standalone Lever MCP server, the agents and LLMs can only access a fixed set of Lever tools tied to that server. However, with the Composio Tool Router, agents can dynamically load tools from Lever 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 Lever tools.

Yes, absolutely. You can configure which Lever 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 Lever data and credentials are handled as safely as possible.

Start with Lever.It takes 30 seconds.

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

Start building