How to integrate Composio search MCP with Hermes

Trusted by
AWS
Glean
Zoom
Airtable
GET STARTED FOR FREEGET A DEMO

30 min · no commitment · see it on your stack

Composio search logo
Hermes logo
divider

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 Composio search 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 Composio search with

What is Composio Connect?

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

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

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

5. Done!

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

The Composio search MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to the entire Composio Search suite. It provides structured and secure access to powerful web, travel, shopping, news, academic, and financial search tools, so your agent can perform actions like searching the web, finding events, locating places, pulling news, and fetching academic research on your behalf.

  • Comprehensive web and news search: Instantly ask your agent to fetch up-to-date web pages, breaking news, or current events using Google, DuckDuckGo, or news-specific search APIs.
  • Travel and local discovery: Let your agent find nearby hotels, flights, events, or map locations using Google Maps and events search for seamless travel planning and local exploration.
  • E-commerce and product lookup: Have your agent search for products, deals, and reviews across major retailers like Amazon and Walmart to help you shop smarter and faster.
  • Financial and market data retrieval: Direct your agent to pull real-time stock information, financial news, and market trends with just a query—no manual research needed.
  • Academic and scholarly research: Empower your agent to find relevant academic papers, citations, and scholarly articles using Google Scholar and Exa Answer for research-heavy tasks.

Supported Tools & Triggers

Tools
Amazon Product SearchSearch Amazon for products across different country marketplaces.
Composio DuckDuckGo SearchThe DuckDuckGoSearch class utilizes the Composio DuckDuckGo Search API to perform searches, focusing on web information and details.
Composio Google Events SearchSearch for upcoming events, concerts, festivals, conferences, and other activities.
Composio SimilarlinksPerform a search to find similar links and retrieve a list of relevant results.
Fetch URL ContentFetch and extract clean, readable page text (markdown) from public web pages (HTML content) using the Exa API.
Composio Finance SearchGet real-time stock prices, market data, financial news, and company information with historical analysis.
Flight SearchSearch for flights with comprehensive pricing, schedule, and airline information.
Composio Google Maps SearchPerforms a location-specific search via the Composio Google Maps Search API, returning results under `results.
Groq Chat CompletionExecute fast LLM inference using Groq's optimized hardware and API.
Hotel SearchSearch for hotels and vacation rentals with comprehensive filtering and pricing.
Composio Image SearchThe ImageSearch class performs an image search using the Composio Image Search API, targeting image metadata and URLs (not binary data) via Google Images.
Composio News SearchSearch for the latest news articles and current events with smart filtering.
NPPES NPI Registry LookupLookup US healthcare provider details from the CMS NPI Registry (NPPES) using an NPI number or search filters.
Composio Scholar SearchScholar API scrapes Google Scholar search results via SERP API, returning academic papers and scholarly articles.
Composio SEC EDGAR Filings SearchRetrieve authoritative SEC EDGAR filing metadata (10-K/10-Q/8-K etc.
Composio Shopping SearchSearch for products with advanced price filtering, location targeting, and deal discovery.
Composio LLM SearchThe Composio LLM Search class serves as a gateway to the Composio LLM Search API, allowing users to perform searches across a broad range of content with multiple filtering options.
Composio Trends SearchDiscover trending topics, search patterns, and popularity data.
TripAdvisor Travel SearchSearch TripAdvisor for travel recommendations and itinerary planning without authentication (unlike TRIPADVISOR_CONTENT_API_SEARCH_LOCATIONS and other TripAdvisor tools requiring an active connection).
Vercel AI Gateway ChatExecute LLM inference through Vercel AI Gateway's unified API.
Walmart Product SearchSearch Walmart for products with price filtering.
Composio Web SearchPerform a web search using the Exa API.

Way Forward

With Composio search 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.

How to build Composio search MCP Agent with another framework

OpenAI Agents SDK logo

OpenAI Agents SDK

Use Composio search MCP with OpenAI Agents SDK

Claude Agent SDK logo

Claude Agent SDK

Use Composio search MCP with Claude Agent SDK

Claude Code logo

Claude Code

Use Composio search MCP with Claude Code

Claude Cowork logo

Claude Cowork

Use Composio search MCP with Claude Cowork

Codex logo

Codex

Use Composio search MCP with Codex

OpenClaw logo

OpenClaw

Use Composio search MCP with OpenClaw

CLI logo

CLI

Use Composio search MCP with CLI

Google ADK logo

Google ADK

Use Composio search MCP with Google ADK

LangChain logo

LangChain

Use Composio search MCP with LangChain

Vercel AI SDK logo

Vercel AI SDK

Use Composio search MCP with Vercel AI SDK

Mastra AI logo

Mastra AI

Use Composio search MCP with Mastra AI

LlamaIndex logo

LlamaIndex

Use Composio search MCP with LlamaIndex

CrewAI logo

CrewAI

Use Composio search MCP with CrewAI

FAQ

What are the differences in Tool Router MCP and Composio search MCP?

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

Can I use Tool Router MCP with Hermes?

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 Composio search tools.

Can I manage the permissions and scopes for Composio search while using Tool Router?

Yes, absolutely. You can configure which Composio search 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.

How safe is my data with Composio Tool Router?

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 Composio search data and credentials are handled as safely as possible.

Used by agents from

Context
Letta
glean
HubSpot
Agent.ai
Altera
DataStax
Entelligence
Rolai
Context
Letta
glean
HubSpot
Agent.ai
Altera
DataStax
Entelligence
Rolai
Context
Letta
glean
HubSpot
Agent.ai
Altera
DataStax
Entelligence
Rolai

Never worry about agent reliability

We handle tool reliability, observability, and security so you never have to second-guess an agent action.

Get started for freeGet a demo↗