How to integrate Navan MCP with Atomic Agent

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

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

Atomic Agent is an open-source AI agent that runs on your machine and supports local models through llama.cpp. Connect it to 1,700+ apps through Composio, including Navan.

This guide uses Atomic Agent's built-in Composio integration. You need Atomic Agent v0.5.6 or later, your own Composio API key, and a Navan account. See the Atomic Agent documentation for installation instructions.

Also integrate Navan with

How Atomic Agent connects to Navan

Atomic Agent connects to Composio's Tool Router over Streamable HTTP MCP. It discovers the tools needed for your request, and Composio handles account authentication.

Execution and account-connection tools follow Atomic Agent's configured approval policy. Review any approval prompt before allowing an action on your connected account.

Connect Navan to Atomic Agent

  1. Sign up or sign in to the Composio dashboard. Copy your API key.
  2. In Atomic Agent, open the Integrations tab and select Composio. Select API key, press e, paste the key, and press Enter. The tools become available immediately, without a restart.
  3. Ask Atomic Agent to do something in Navan. It searches Composio for the right tool.
  4. On first use, open the sign-in link returned in the chat. Connect your Navan account, then return to Atomic Agent to continue.

Headless setup

Add the following line to ~/.atomic-agent/.env, replacing YOUR_COMPOSIO_API_KEY with your key. Start Atomic Agent after saving the file.

bash
COMPOSIO_API_KEY=YOUR_COMPOSIO_API_KEY

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.

Use Navan from Atomic Agent

With your account connected, ask Atomic Agent to work with Navan in natural language. You can connect more apps through the same Composio integration as you need them.

Visit the Atomic Agent website or inspect the Atomic Agent source code.

Troubleshooting

Why is my API key rejected?

Copy the key directly from the Composio dashboard. Atomic Agent requires ASCII characters because it sends the key in an HTTP header. Remove any extra characters introduced when copying.

Why are Composio tools unavailable after saving a key?

Check that you use Atomic Agent v0.5.6 or later and that Composio is enabled in your configuration. A "composio": { "enabled": false } setting disables the integration while keeping the saved key on disk.

Does Composio have a free plan?

The Hobby plan includes 100,000 tool calls per month. Composio-managed OAuth apps have a lower included allowance. See Composio pricing for the current limits that apply to your connection.

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.

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. Atomic Agent 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