SIGN UPLOG IN
X (Twitter)LinkedInGitHubDiscordYouTube

How to integrate Navan MCP with Hermes

Connect Hermes to Navan MCP. List recent business travel transactions, review unusual employee expense activity, and more using natural language, with authentication handled for you.

Get started for freeGet a demo
Navan logoNavan
S2s Oauth2

Navan is a business travel and expense platform with APIs for travel, transactions, users, and audits. It helps companies centralize travel operations, spending data, and policy controls.

26 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 Navan 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 Navan with

ChatGPTClaude CoworkAtomic Agent

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

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

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

5. Done!

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

The Navan MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your Navan account. It provides structured and secure access to business travel, booking, expense, transaction, user, receipt, audit, and custom-field data, so your agent can review travel and expenses, retrieve receipts, update transactions, import trips, and inspect company activity on your behalf.

  • Travel and booking management: Have your agent review company bookings with trip, status, type, and time filters, or import an external trip with its flight, hotel, rail, car, or black-car bookings.
  • Expense and transaction tracking: Let the agent find card, manual, connect, repayment, adjustment, fee, rebate, dispute, and statement payment records, then update supported accounting, HR, and custom-field values.
  • Receipt retrieval: Direct your agent to find transaction receipts and retrieve receipt, electronic-receipt, or missing-receipt affidavit links for expense records.
  • Employee and company data: Instruct your agent to look up Expense users and TMC users, review custom-field definitions, and check the status of custom-field option changes.
  • Audit and transaction activity: Have your agent review company audit events and inspect the activity history for individual transactions.

Way Forward

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

Download Transaction Receipt

Download a transaction receipt, electronic receipt, or missing-receipt affidavit.

Get Custom Field

Get one company Navan Expense custom-field definition by its provider field name.

Get Custom Field Job

Get the current status, operation counts, timestamps, and up to 50 errors for an asynchronous Navan custom-field option job.

Get Expense User

Get one eligible-company Navan Expense user by ID.

Get Transaction

Get one Navan Expense transaction by its ID for an ad-hoc lookup.

Get Transaction Receipt Links

Return seven-day presigned receipt, electronic-receipt, and affidavit URLs for one Navan Expense transaction.

Import Trip

Import an external trip and any supplied flight, hotel, rail, car, or black-car bookings into Navan.

List Adjustments

Return one cursor page of credit and debit adjustments for a documented date search and optional filters.

List Audit Logs

Return one cursor page of ERP and accounting-settings audit events for eligible companies within a required RFC3339 window of at most 31 days.

List Bookings

Return one page of company booking rows filtered by booking, trip, status, type, or epoch-second time ranges, optionally including transactions.

List Card Transactions

Return one cursor page of Navan card transactions for a documented date search and optional transaction filters.

List Connect Transactions

Return one cursor page of external card-integration transactions.

List Custom Fields

List all Navan Expense custom-field definitions for the company.

List Daily Rebates

Return one cursor page of daily rebates for a required documented date search and optional transaction filters.

List Disputes

Return one cursor page of Navan disputes, including provisional credits and reversals for EUR and GBP, for a required documented date search and optional transaction filters.

List Expense Users

Return one cursor page of company Expense users filtered by text, enabled state, guest state, or administrator role.

List Fees

Return one cursor page of direct-reimbursement, foreign-exchange, and platform fees.

List Manual Transactions

Return one cursor page of manual expenses, reimbursements, and payroll transactions.

List Repayments

Return one cursor page of user repayments for a required documented date search and optional transaction filters.

List Statement Payments

Return one cursor page of statement payments and statement payment refunds for a required documented date search.

List TMC Users

Return one documented page of TMC company users.

List Transaction Activities

Return one cursor page of activity history for a single Navan Expense transaction, newest first.

List Transaction Receipts

Return one cursor page of receipt links for selected Navan transaction families and a documented date search.

List Transactions

Return one cursor page across selected Navan transaction families, or fetch a batch using repeated transaction IDs.

Submit Custom Field Option Operations

Submit 1 to 5,000 CREATE, UPDATE, UPSERT, or DELETE operations for one Navan custom field as an asynchronous job.

Update Transactions

Update supported ERP, accounting, HR, and custom-field values for 1 to 100 Navan transactions.

FRAMEWORKS

How to build Navan MCP Agent with another framework

ChatGPT logo

ChatGPT

Use Navan MCP with ChatGPT

Claude Cowork logo

Claude Cowork

Use Navan MCP with Claude Cowork

Atomic Agent logo

Atomic Agent

Use Navan MCP with Atomic Agent

FAQ

Frequently asked questions

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

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

Start with Navan.It takes 30 seconds.

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

Start building