How to integrate Serper MCP with Hermes

Connect Hermes to Serper MCP. Get top google results for ai regulation, extract main content from example.com article, and more using natural language, with authentication handled for you.

Serper logoSerper
Api Key

Serper is a search API that returns Google search results, place data, autocomplete, and webpage extraction. It provides structured, up-to-date web and place information for programmatic use.

11 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 Serper 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 Serper with

What is Composio Connect?

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

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

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

5. Done!

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

The Serper MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your Serper account. It provides structured and secure access so your agent can perform Serper operations on your behalf.

Way Forward

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

Batch Search the Web

Run 1-10 independent first-page Google web searches in one native Serper request.

Get Search Suggestions

Return Google autocomplete suggestions for a partial search query without running a full search.

List Locations

Find canonical Serper location names and country codes for localizing search requests; this lookup consumes no search credits.

List Place Reviews

Return paginated Google reviews for one place identified by Place ID, feature ID, or CID, with optional sorting and topic filtering.

Scrape Webpage

Ask Serper to fetch one webpage and return extracted text, metadata, and optionally markdown, links, images, and videos.

Search Images

Search Google Images and return one page of source pages, full image URLs, thumbnails, dimensions, and positions.

Search Maps

Search Google Maps by text, Place ID, or CID, optionally constrained to a viewport, and return one page of rich place identifiers and contact details.

Search News

Search recent Google News coverage and return one page of article titles, links, sources, publication times, snippets, and images when available.

Search Scholar

Search Google Scholar and return one page of academic publications with citation counts, publication metadata, snippets, and PDF links when available.

Search Shopping

Search Google Shopping and return one page of products, prices, merchants, offers, ratings, images, and product IDs.

Search the Web

Search Google web results and return one page of organic links plus available answer, knowledge, question, related-search, and top-story sections.

FAQ

Frequently asked questions

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

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

Start with Serper.It takes 30 seconds.

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

Start building