How to integrate Composio search MCP with Hermes

GET STARTED FOR FREE
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
Composio DuckDuckGo SearchThe duckduckgosearch class utilizes the composio duckduckgo search api to perform searches, focusing on web information and details.
Composio Google Events SearchThe eventsearch class enables scraping of google events search queries.
Exa AnswerGet answers with citations using the exa api.
Composio SimilarlinksPerform a search to find similar links and retrieve a list of relevant results.
Composio Finance SearchThe financesearch class utilizes the composio finance search api to conduct financial searches, focusing on financial data and stock information.
Composio Google Maps SearchThe googlemapssearch class performs a location-specific search using the composio goolge maps search api.
Composio Image SearchThe imagesearch class performs an image search using the composio image search api, to target image data and information.
Composio News SearchThe newssearch class performs a news-specific search using the composio news search api.
Composio Scholar SearchScholar api allows you to scrape results from a google scholar search query.
Composio Google SearchPerform a google search using the composio google search api.
Composio Shopping SearchThe shoppingsearch class performs a product search using the composio shopping search api.
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 SearchThe trendssearch class performs a trend search using the google trends search api, to target trend data and information.

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

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.

Book a call↗Get started for free