# How to integrate Composio search MCP with Hermes

```json
{
  "title": "How to integrate Composio search MCP with Hermes",
  "toolkit": "Composio search",
  "toolkit_slug": "composio_search",
  "framework": "Hermes",
  "framework_slug": "hermes-agent",
  "url": "https://composio.dev/toolkits/composio_search/framework/hermes-agent",
  "markdown_url": "https://composio.dev/toolkits/composio_search/framework/hermes-agent.md",
  "updated_at": "2026-05-06T08:07:02.083Z"
}
```

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

- [OpenAI Agents SDK](https://composio.dev/toolkits/composio_search/framework/open-ai-agents-sdk)
- [Claude Agent SDK](https://composio.dev/toolkits/composio_search/framework/claude-agents-sdk)
- [Claude Code](https://composio.dev/toolkits/composio_search/framework/claude-code)
- [Claude Cowork](https://composio.dev/toolkits/composio_search/framework/claude-cowork)
- [Codex](https://composio.dev/toolkits/composio_search/framework/codex)
- [OpenClaw](https://composio.dev/toolkits/composio_search/framework/openclaw)
- [CLI](https://composio.dev/toolkits/composio_search/framework/cli)
- [Google ADK](https://composio.dev/toolkits/composio_search/framework/google-adk)
- [LangChain](https://composio.dev/toolkits/composio_search/framework/langchain)
- [Vercel AI SDK](https://composio.dev/toolkits/composio_search/framework/ai-sdk)
- [Mastra AI](https://composio.dev/toolkits/composio_search/framework/mastra-ai)
- [LlamaIndex](https://composio.dev/toolkits/composio_search/framework/llama-index)
- [CrewAI](https://composio.dev/toolkits/composio_search/framework/crew-ai)

## TL;DR

### 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.

## Connect Composio search to Hermes

### 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
```

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

| Tool slug | Name | Description |
|---|---|---|
| `COMPOSIO_SEARCH_DUCK_DUCK_GO_SEARCH` | Composio DuckDuckGo Search | The duckduckgosearch class utilizes the composio duckduckgo search api to perform searches, focusing on web information and details. it leverages the duckduckgo search engine via the composio duckduckgo search api to retrieve relevant web data based on the provided query. |
| `COMPOSIO_SEARCH_EVENT_SEARCH` | Composio Google Events Search | The eventsearch class enables scraping of google events search queries. it conducts an event search using the composio events search api, retrieving information on events such as concerts, festivals, and other activities based on the provided query. |
| `COMPOSIO_SEARCH_EXA_ANSWER` | Exa Answer | Get answers with citations using the exa api. |
| `COMPOSIO_SEARCH_EXA_SIMILARLINK` | Composio Similarlinks | Perform a search to find similar links and retrieve a list of relevant results. the search can optionally return contents. |
| `COMPOSIO_SEARCH_FINANCE_SEARCH` | Composio Finance Search | The financesearch class utilizes the composio finance search api to conduct financial searches, focusing on financial data and stock information. it leverages the google finance search engine via the composio finance search api to retrieve pertinent financial details based on the provided query. |
| `COMPOSIO_SEARCH_GOOGLE_MAPS_SEARCH` | Composio Google Maps Search | The googlemapssearch class performs a location-specific search using the composio goolge maps search api. this class extends the functionality of the base action class to specifically target locations related to the given query. by utilizing the google maps search engine through the composio goolge maps search api, it fetches the most relevant location data based on the input query. the `googlemapssearch` class is particularly useful for applications that need to retrieve and display location information about a specific area. it leverages the powerful search capabilities of google's maps search engine, ensuring that the returned results are accurate and relevant. |
| `COMPOSIO_SEARCH_IMAGE_SEARCH` | Composio Image Search | The imagesearch class performs an image search using the composio image search api, to target image data and information. it uses the google images search engine through the composio image search api to fetch relevant image information based on the input query. |
| `COMPOSIO_SEARCH_NEWS_SEARCH` | Composio News Search | The newssearch class performs a news-specific search using the composio news search api. this class extends the functionality of the base action class to specifically target news articles related to the given query. by utilizing the google news search engine through the composio news search api, it fetches the most relevant news articles based on the input query. the `newssearch` class is particularly useful for applications that need to retrieve and display the latest news articles about a specific topic. it leverages the powerful search capabilities of google's news search engine, ensuring that the returned results are current and relevant. |
| `COMPOSIO_SEARCH_SCHOLAR_SEARCH` | Composio Scholar Search | Scholar api allows you to scrape results from a google scholar search query. the scholarsearch class performs an academic search using the composio scholar search api, academic papers and scholarly articles. it uses the google scholar search engine through the serp api to fetch relevant academic information based on the input query. |
| `COMPOSIO_SEARCH_SEARCH` | Composio Google Search | Perform a google search using the composio google search api. |
| `COMPOSIO_SEARCH_SHOPPING_SEARCH` | Composio Shopping Search | The shoppingsearch class performs a product search using the composio shopping search api.it specifically target shopping results related to the given query. by utilizing the google shopping search engine through the composio shopping search api, it fetches the most relevant product listings based on the input query. the `shoppingsearch` class is particularly useful for applications that need to retrieve and display the latest product listings and shopping results for a specific item. it leverages the powerful search capabilities of google's shopping search engine, ensuring that the returned results are current and relevant. |
| `COMPOSIO_SEARCH_TAVILY_SEARCH` | Composio LLM Search | The 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. it accommodates complex queries, including both keyword and phrase searches, with additional parameters to fine-tune the search results. this class enables a tailored search experience by allowing users to specify the search depth, include images and direct answers, apply domain-specific filters, and control the number of results returned. it is designed to meet various search requirements, from quick lookups to in-depth research. |
| `COMPOSIO_SEARCH_TRENDS_SEARCH` | Composio Trends Search | The trendssearch class performs a trend search using the google trends search api, to target trend data and information. it uses the google trends search engine through the google trends search api to fetch relevant trend information based on the input query. |

## Supported Triggers

None listed.

## Creating MCP Server - Stand-alone vs Composio SDK

The Composio search MCP server provides comprehensive access to Composio search operations through Composio. Once connected, Hermes can perform all major Composio search actions on your behalf using natural language commands.

## Complete Code

None listed.

## Conclusion

### 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](https://discord.com/invite/composio) or check out the [Docs](https://docs.composio.dev?utm_source=toolkits&utm_medium=framework_template&utm_campaign=hermes&utm_content=docs) for deeper configuration options.

## How to build Composio search MCP Agent with another framework

- [OpenAI Agents SDK](https://composio.dev/toolkits/composio_search/framework/open-ai-agents-sdk)
- [Claude Agent SDK](https://composio.dev/toolkits/composio_search/framework/claude-agents-sdk)
- [Claude Code](https://composio.dev/toolkits/composio_search/framework/claude-code)
- [Claude Cowork](https://composio.dev/toolkits/composio_search/framework/claude-cowork)
- [Codex](https://composio.dev/toolkits/composio_search/framework/codex)
- [OpenClaw](https://composio.dev/toolkits/composio_search/framework/openclaw)
- [CLI](https://composio.dev/toolkits/composio_search/framework/cli)
- [Google ADK](https://composio.dev/toolkits/composio_search/framework/google-adk)
- [LangChain](https://composio.dev/toolkits/composio_search/framework/langchain)
- [Vercel AI SDK](https://composio.dev/toolkits/composio_search/framework/ai-sdk)
- [Mastra AI](https://composio.dev/toolkits/composio_search/framework/mastra-ai)
- [LlamaIndex](https://composio.dev/toolkits/composio_search/framework/llama-index)
- [CrewAI](https://composio.dev/toolkits/composio_search/framework/crew-ai)

## Related Toolkits

- [Composio](https://composio.dev/toolkits/composio) - Composio is an integration platform that connects AI agents with hundreds of business tools. It streamlines authentication and lets you trigger actions across services—no custom code needed.
- [Perplexityai](https://composio.dev/toolkits/perplexityai) - Perplexityai delivers natural, conversational AI models for generating human-like text. Instantly get context-aware, high-quality responses for chat, search, or complex workflows.
- [Browser tool](https://composio.dev/toolkits/browser_tool) - Browser tool is a virtual browser integration that lets AI agents interact with the web programmatically. It enables automated browsing, scraping, and action-taking from any AI workflow.
- [Ai ml api](https://composio.dev/toolkits/ai_ml_api) - Ai ml api is a suite of AI/ML models for natural language and image tasks. It provides fast, scalable access to advanced AI capabilities for your apps and workflows.
- [Aivoov](https://composio.dev/toolkits/aivoov) - Aivoov is an AI-powered text-to-speech platform offering 1,000+ voices in over 150 languages. Instantly turn written content into natural, human-like audio for any application.
- [All images ai](https://composio.dev/toolkits/all_images_ai) - All-Images.ai is an AI-powered image generation and management platform. It helps you create, search, and organize images effortlessly with advanced AI capabilities.
- [Anthropic administrator](https://composio.dev/toolkits/anthropic_administrator) - Anthropic administrator is an API for managing Anthropic organizational resources like members, workspaces, and API keys. It helps you automate admin tasks and streamline resource management across your Anthropic organization.
- [Api labz](https://composio.dev/toolkits/api_labz) - Api labz is a platform offering a suite of AI-driven APIs and workflow tools. It helps developers automate tasks and build smarter, more efficient applications.
- [Apipie ai](https://composio.dev/toolkits/apipie_ai) - Apipie ai is an AI model aggregator offering a single API for accessing top AI models from multiple providers. It helps developers build cost-efficient, latency-optimized AI solutions without juggling multiple integrations.
- [Astica ai](https://composio.dev/toolkits/astica_ai) - Astica ai provides APIs for computer vision, NLP, and voice synthesis. Integrate advanced AI features into your app with a single API key.
- [Bigml](https://composio.dev/toolkits/bigml) - BigML is a machine learning platform that lets you build, train, and deploy predictive models from your data. Its intuitive interface and robust API make machine learning accessible and efficient.
- [Botbaba](https://composio.dev/toolkits/botbaba) - Botbaba is a platform for building, managing, and deploying conversational AI chatbots across messaging channels. It streamlines chatbot automation, making it easier to integrate AI into customer interactions.
- [Botpress](https://composio.dev/toolkits/botpress) - Botpress is an open-source platform for building, deploying, and managing chatbots. It helps teams automate conversations and deliver rich, interactive messaging experiences.
- [Chatbotkit](https://composio.dev/toolkits/chatbotkit) - Chatbotkit is a platform for building and managing AI-powered chatbots using robust APIs and SDKs. It lets you easily add conversational AI to your apps for better user engagement.
- [Cody](https://composio.dev/toolkits/cody) - Cody is an AI assistant built for businesses, trained on your company's knowledge and data. It delivers instant answers and insights, tailored for your team.
- [Context7 MCP](https://composio.dev/toolkits/context7_mcp) - Context7 MCP delivers live, version-specific code docs and examples right from the source. It helps developers and AI agents instantly retrieve authoritative programming info—no more out-of-date docs.
- [Customgpt](https://composio.dev/toolkits/customgpt) - CustomGPT.ai lets you build and deploy chatbots tailored to your own data and business needs. Get precise and context-aware AI conversations without writing code.
- [Datarobot](https://composio.dev/toolkits/datarobot) - Datarobot is a machine learning platform that automates model development, deployment, and monitoring. It empowers organizations to quickly gain predictive insights from large datasets.
- [Deepgram](https://composio.dev/toolkits/deepgram) - Deepgram is an AI-powered speech recognition platform for accurate audio transcription and understanding. It enables fast, scalable speech-to-text with advanced audio intelligence features.
- [DeepImage](https://composio.dev/toolkits/deepimage) - DeepImage is an AI-powered image enhancer and upscaler. Get higher-quality images with just a few clicks.

## Frequently Asked Questions

### 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.

---
[See all toolkits](https://composio.dev/toolkits) · [Composio docs](https://docs.composio.dev/llms.txt)