This guide shows you how to set up a Hermes Agent n8n integration both ways. First, Hermes connects to n8n's official MCP server, so the agent can see and run your workflows. Second, n8n calls Hermes through a webhook, so a workflow can hand a job to your agent. You can do both in under 20 minutes.
📺 Watch: N8N VS Agentic Operating Systems!
🔥 Get the Agent OS as a free bonus: AI Profit Boardroom members get the full Agent OS zip, prompt libraries, daily tutorials and weekly live coaching calls. → Get inside
All the steps come from the official Hermes Agent docs from Nous Research and n8n's own MCP guide, checked on 19 November 2026. Still deciding which tool to use at all? Read our Hermes vs n8n comparison first, then come back here to connect them.
Hermes Agent n8n Integration: The Two Directions
| Direction | How it works | Use it when |
|---|---|---|
| Hermes calls n8n | The n8n-official MCP catalog entry connects Hermes to your n8n instance | You want to ask Hermes to find, run or edit a workflow |
| n8n calls Hermes | An n8n HTTP Request node posts to a Hermes webhook route | You want a workflow to hand a thinking job to your agent |
Most people want both. n8n catches the trigger (a new form lead, a new row in a sheet), Hermes does the hard part (research, write, decide), and the result goes back out.
Important: The Old n8n Bridge Is Retired
If you followed an older tutorial, it may tell you to install a third-party n8n bridge. The Hermes docs say that bridge is no longer available from the catalog. Existing installs keep working as custom MCP servers, but you can't reinstall it. New setups should use the n8n-official entry below. It connects straight to n8n Cloud or a self-hosted n8n over HTTP with browser sign-in. No local bridge and no n8n API key are needed.
📺 Watch: Hermes Agent OS Can Automate EVERYTHING?! 🤯
Part 1: Connect Hermes to n8n (MCP)
Step 1: Turn on MCP in n8n
Ask an n8n owner or admin to enable Settings > Instance-level MCP. Without this, Hermes has nothing to connect to.
Step 2: Copy the Server URL
Open Connect in n8n and copy the full Server URL. It ends in /mcp-server/http. Don't copy the normal editor URL by mistake. Older n8n versions show the endpoint directly on the MCP settings page.
Step 3: Install the catalog entry
hermes mcp install n8n-official
Paste the Server URL when Hermes asks for it.
Step 4: Sign in
A browser window opens for OAuth. Approve it. If that doesn't happen, run:
hermes mcp login n8n-official
You can also click Authorize on the server in the Hermes Desktop app or dashboard.
Step 5: Pick your tools and reload
hermes mcp configure n8n-official
Tick the tools you want Hermes to use. Then start a new session, or type /reload-mcp in your current one.
Two things to know. The machine running Hermes must be able to reach your n8n URL. And n8n, not Hermes, controls which workflows are exposed and what each tool can do. Some tools change or run workflows, so only switch on what you need.
Want our ready-made agent workflows instead of building from scratch? Inside the AI Profit Boardroom you get the full Agent OS, plus weekly live calls where we build automations like this with members.
📺 Watch: Stop Finding Leads Manually! Use Hermes Agent
Part 2: Let n8n Trigger Hermes (Webhooks)
Hermes has a built-in webhook adapter. Any service that can send an HTTP request, n8n included, can start a Hermes run.
Step 1: Turn on webhooks
Run the setup wizard:
hermes gateway setup
Or add these lines to ~/.hermes/.env:
WEBHOOK_ENABLED=true
WEBHOOK_PORT=8644
WEBHOOK_SECRET=your-global-secret
Port 8644 is the default.
Step 2: Check it is running
curl http://localhost:8644/health
Step 3: Create a route
Each job gets its own route. You can define routes in config.yaml, or create one with a command:
hermes webhook subscribe n8n-leads
New routes made this way use the "generic" signature scheme. Routes can include a prompt template and a delivery target, such as Telegram or Slack, so the answer lands where you want it.
Step 4: Point n8n at the route
In n8n, add an HTTP Request node at the step where you want Hermes to take over. Send a POST to:
http://your-server:8644/webhooks/n8n-leads
The generic scheme checks an X-Webhook-Signature-V2 header and an X-Webhook-Timestamp header, signed with your route's secret. Follow the signing steps in the Hermes webhooks docs so your requests are accepted. Unsigned or wrongly signed calls are refused, which is what you want.
Step 5: Keep it private
If n8n runs in the cloud and Hermes runs at home, don't open the port to the whole internet. Use a tunnel or a reverse proxy with HTTPS. Never share the webhook secret.
Three Workflows to Build First
1. Lead research
n8n catches a new form lead. It posts the lead to Hermes. Hermes researches the company and writes a short brief. The brief goes to your Slack or Telegram.
2. Content drafts
n8n watches a sheet of topics. Each new row goes to Hermes, which drafts a post. n8n saves the draft back to the sheet for you to check.
3. Ask Hermes to run a workflow
With the MCP connection live, message Hermes: "run my weekly report workflow and tell me what it found." Hermes calls the n8n tool and replies with the result.
Hermes or n8n: Who Should Do What?
- Give n8n the fixed steps: triggers, moving data between apps, retries and schedules you want to see on a canvas.
- Give Hermes the judgement: reading, writing, deciding and anything that changes each time.
- Keep humans on anything that sends money, emails clients or deletes data. Add a review step.
For a side-by-side look at both tools, see our Hermes vs n8n guide. If you want help choosing a model for the Hermes side, we test models on real jobs on Goldie Bench.
Common Problems
- Hermes can't see n8n tools. Check Instance-level MCP is on, the URL ends in /mcp-server/http, and you ran /reload-mcp or opened a new session.
- OAuth keeps failing. Run
hermes mcp login n8n-officialagain and finish the browser step. - n8n gets a 404 from Hermes. The route name is wrong, or the signature headers don't match the route's scheme.
- Nothing happens at all. Run the health check. If it fails, the gateway isn't running or webhooks are off.
That is the full Hermes Agent n8n integration: MCP for Hermes-to-n8n, webhooks for n8n-to-Hermes. Build one small workflow first and grow from there. For the templates and live help, join the AI Profit Boardroom.
FAQ
Is there an official Hermes Agent n8n integration?
Yes. The Hermes MCP catalog has an n8n-official entry that connects to n8n's official MCP server with browser OAuth. The older third-party n8n bridge is retired.
Do I need an n8n API key?
Not for the n8n-official MCP entry. It uses browser sign-in instead. An owner or admin must turn on Instance-level MCP in n8n first.
Can n8n start a Hermes Agent task?
Yes. Turn on Hermes webhooks, create a route, and send a signed POST from an n8n HTTP Request node to http://your-server:8644/webhooks/your-route.
Does this work with self-hosted n8n?
Yes. The n8n-official entry works with n8n Cloud and self-hosted n8n, as long as the machine running Hermes can reach the Server URL.
Should I replace n8n with Hermes?
Not usually. n8n is great for fixed steps you can see on a canvas, and Hermes is great at the thinking in between. Most teams get the best results using both together.











