fbpx

Hermes Agent n8n Integration: How to Connect Them (Webhooks + MCP)

WANT TO BOOST YOUR SEO TRAFFIC, RANK #1 & Get More CUSTOMERS?

Get free, instant access to our SEO video course, 120 SEO Tips, ChatGPT SEO Course, 999+ make money online ideas and get a 30 minute SEO consultation!

Just Click The Button Below To Get FREE, Instant Access!

A Hermes Agent n8n integration gives you the best of both tools: n8n for fixed, reliable workflows and Hermes for the thinking. There are two ways to connect them. Webhooks let n8n send jobs to Hermes. An MCP bridge lets Hermes look at, start and fix your n8n workflows. Below I’ll show you both setups step by step and when to use each. (Still choosing between them? Read my Hermes vs n8n comparison.)

Key takeaways

  • n8n → Hermes: Hermes webhooks on port 8644 with an HMAC secret.
  • Hermes → n8n: the community hermes-n8n-mcp bridge with 11 tools.
  • Rule of thumb: webhooks for triggers, MCP for running n8n.
  • Treat workflow activation as a production change.
  • Want this set up with you? Join the AI Profit Boardroom.

Two ways to connect Hermes and n8n

Webhooks MCP bridge
Direction n8n sends jobs to Hermes Hermes controls n8n
Good for “When X happens, ask Hermes to think about it” “Hermes, why did my workflow fail?”
Official? Yes, built into Hermes Community project
Needs Hermes gateway + secret n8n API key + Python 3.10+

Many people use both: n8n catches the event, Hermes does the smart part, and Hermes can also check on n8n when things break.

Method 1: trigger Hermes from n8n with webhooks

From the Hermes webhooks guide:

Step 1. Turn on webhooks in ~/.hermes/.env:

WEBHOOK_ENABLED=true
WEBHOOK_PORT=8644
WEBHOOK_SECRET=your-global-secret

Step 2. Start the gateway and check it’s up:

hermes gateway
curl http://localhost:8644/health

Step 3. Create a route for n8n:

hermes webhook subscribe n8n-leads --prompt "Score this lead and draft a reply" --description "New leads from n8n"

Step 4. In n8n, add an HTTP Request node that POSTs your data to:

http://your-server:8644/webhooks/n8n-leads

Sign the request with your secret. Hermes’s generic scheme uses the X-Webhook-Signature-V2 and X-Webhook-Timestamp headers. Use hermes webhook list, test and remove to manage routes.

Hermes can send its answer wherever you like, such as Telegram, Slack or email, using the route’s deliver setting.

Want help connecting Hermes Agent to your business workflows? Inside the AI Profit Boardroom you get the Agent OS — Hermes, OpenClaw, OpenCode, Claude and Codex in one place — plus step-by-step Hermes training and four live coaching calls a week.

Want a plan for your business first? Get your Backlink Gameplan.

Join the AI Profit Boardroom →Get Your Backlink Gameplan →

Method 2: let Hermes run n8n with the MCP bridge

The community hermes-n8n-mcp project gives Hermes 11 n8n tools:

  • health, list_workflows, get_workflow, find_workflows
  • list_executions, get_execution, recent_failures
  • export_workflow, activate_workflow, deactivate_workflow
  • container_logs (for Docker setups)

Step 1. Create an n8n API key (n8n’s API docs show how). n8n usually runs at http://127.0.0.1:5678.

Step 2. Put your settings in ~/.config/n8n-mcp/env:

N8N_BASE_URL=http://127.0.0.1:5678
N8N_API_KEY=your-n8n-api-key

Optional: N8N_MCP_TIMEOUT, N8N_CONTAINER_NAME and N8N_MCP_ALLOW_DOCKER_LOGS.

Step 3. Add the server under mcp_servers in ~/.hermes/config.yaml (see the Hermes MCP guide), then run /reload-mcp in Hermes.

Now ask: “Show me workflows that failed today and tell me why.”

Hermes + n8n workflow ideas

  • Lead scoring: a form fills in n8n, Hermes scores it and drafts the reply.
  • Support triage: n8n catches new tickets, Hermes sorts and answers the easy ones.
  • Content: n8n watches an RSS feed, Hermes writes the summary post.
  • Ops watchdog: Hermes checks recent_failures every morning and tells you what broke.

Stay safe with Hermes and n8n

  • Always set a WEBHOOK_SECRET, and never use the insecure no-auth mode outside testing.
  • Keep port 8644 private, or put it behind a tunnel.
  • The MCP project warns to treat activate and deactivate “like loaded weapons”. Turning a workflow on is a production change, so ask Hermes to confirm first.
  • Give the n8n API key only to the Hermes profile that needs it.

Want this set up for you instead of doing it yourself? Get your Backlink Gameplan →

Get Your Backlink Gameplan →

Common errors and fixes

Problem Fix
n8n gets a 401 from Hermes The signature doesn’t match. Check the secret and headers
Connection refused on 8644 Make sure hermes gateway is running and WEBHOOK_ENABLED=true
Hermes can’t see n8n tools Run /reload-mcp and check N8N_BASE_URL and N8N_API_KEY
container_logs is empty Set N8N_CONTAINER_NAME and N8N_MCP_ALLOW_DOCKER_LOGS

My verdict on the Hermes Agent n8n integration

Don’t pick one. Let n8n handle the fixed steps and let Hermes handle the thinking. Start with one webhook route, then add the MCP bridge when you want Hermes to keep an eye on your workflows. That’s the simplest way to set up a Hermes Agent n8n integration.

About Julian Goldie

I’m Julian Goldie — founder of Goldie Agency and the AI Profit Boardroom. I test new AI agents almost every day for 432K+ YouTube subscribers and run Hermes, OpenClaw, OpenCode, Claude and Codex side by side in my own Agent OS. Get your Backlink Gameplan or join the AI Profit Boardroom.

FAQ: hermes agent n8n integration

Can Hermes Agent connect to n8n?

Yes. Use Hermes webhooks so n8n can trigger Hermes, or the community hermes-n8n-mcp bridge so Hermes can control n8n.

What port do Hermes webhooks use?

Port 8644 by default, set with WEBHOOK_PORT.

How does n8n call Hermes?

With an HTTP Request node that POSTs to http://your-server:8644/webhooks/your-route, signed with your webhook secret.

What can Hermes do in n8n through MCP?

List and inspect workflows, check executions and failures, export workflows, turn workflows on or off, and read container logs.

Is hermes-n8n-mcp official?

No. It’s a community project on GitHub, not made by Nous Research.

Should I use Hermes or n8n?

Both. n8n is great for fixed workflows, and Hermes adds reasoning. See the Hermes vs n8n comparison.

Ready to put Hermes to work in your business? Join the AI Profit Boardroom for the Agent OS, setup training and daily updates.

Or get your Backlink Gameplan and we’ll map out your setup.

Starting from zero? Get the free AI course and community.

Join the AI Profit Boardroom →Get Your Backlink Gameplan →Get the FREE AI Course + Community →

Related reading

Last updated November 2026. This page is a living guide to hermes agent n8n integration — the facts here move fast and it is updated as they do.

Picture of Julian Goldie

Julian Goldie

Hey, I'm Julian Goldie! I'm an SEO link builder and founder of Goldie Agency. My mission is to help website owners like you grow your business with SEO!

Leave a Comment

WANT TO BOOST YOUR SEO TRAFFIC, RANK #1 & GET MORE CUSTOMERS?

Get free, instant access to our SEO video course, 120 SEO Tips, ChatGPT SEO Course, 999+ make money online ideas and get a 30 minute SEO consultation!

Just Click The Button Below To Get FREE, Instant Access!