SIGN UPLOG IN
X (Twitter)LinkedInGitHubDiscordYouTube

How to integrate BrainGraph MCP with Hermes

Connect Hermes to BrainGraph MCP. Search graph for onboarding process docs, summarize meeting recordings from last week, and more using natural language, with authentication handled for you.

Get started for freeGet a demo
BrainGraph logoBrainGraph
Api Key

BrainGraph builds a searchable knowledge graph from documents, recordings, web pages, and other source material. It provides structured, grounded knowledge to improve AI reasoning and retrieval.

10 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 BrainGraph 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 BrainGraph with

ChatGPTClaude CoworkAtomic Agent

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

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

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

5. Done!

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

The BrainGraph MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your BrainGraph account. It provides structured and secure access to your knowledge brains, source documents, and graph facts, so your agent can ingest content, track processing, search facts, resolve entities, and find recurring patterns on your behalf.

  • Content ingestion: Have your agent add public web pages, YouTube videos, audio recordings, document files, or plain text to your knowledge graph.
  • Document tracking and review: Let the agent list your documents, filter them by name, notes, brain, or failed status, and check their transcription, processing, and analysis progress.
  • Knowledge graph search: Instruct your agent to ask natural-language questions and retrieve relevant facts from all or selected knowledge brains.
  • Entity resolution: Direct your agent to match a person, organization, place, or other named entity to its canonical record in BrainGraph.
  • Relationship pattern discovery: Have your agent find recurring chains of relationships across your knowledge graph and focus on patterns that appear a chosen number of times.

Way Forward

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

Get Document Progress

Get the current transcription, processing, and analysis status for a BrainGraph document.

Ingest Web Page

Fetch readable content from a public web page and queue it for BrainGraph ingestion.

Ingest YouTube Video

Submit a YouTube video for metadata, transcript, and speaker processing; the result may only confirm that processing was queued.

List Brains

List the connected BrainGraph account's knowledge brains and identify the default brain for filtering or targeting other tools.

List Documents

List BrainGraph documents newest first, optionally filtering by filename or notes, failed ingestion status, and brain.

List Graph Patterns

Find recurring relationship-chain patterns in the connected BrainGraph knowledge graph, subject to a minimum occurrence count.

Resolve Entity

Resolve an entity name to a canonical BrainGraph record.

Search Brain

Search facts in the connected account's BrainGraph knowledge graph using a natural-language question, optionally restricted to selected brains.

Transcribe Audio

Upload an audio file or submit a direct public audio URL for diarized transcription and graph ingestion.

Upload Document

Upload a document file supplied by the caller or plain text and queue it for BrainGraph ingestion.

FRAMEWORKS

How to build BrainGraph MCP Agent with another framework

ChatGPT logo

ChatGPT

Use BrainGraph MCP with ChatGPT

Claude Cowork logo

Claude Cowork

Use BrainGraph MCP with Claude Cowork

Atomic Agent logo

Atomic Agent

Use BrainGraph MCP with Atomic Agent

FAQ

Frequently asked questions

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

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

Start with BrainGraph.It takes 30 seconds.

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

Start building