# Hermes Action Bridge

This MCP server sends requests from coding agents to Hermes Agent for planning, browser work, scheduled jobs, messaging, and other actions.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 7
- Author: TheBlueHouse75
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/TheBlueHouse75/hermes-action-bridge
- Updated: 2026-09-29
- HTML: https://affpapa.org/en/nevibecode/mcp/hermes-action-bridge

## What it does

Hermes Action Bridge connects Claude Code, Codex, and other MCP clients to Hermes Agent. An agent can hand off research, browser workflows, scheduled jobs, messages, or Hermes skills instead of rebuilding those integrations in the coding session. YAML settings and CLI flags control the behavior without project-specific assumptions.

One-shot requests use `hermes-action run` with `plan`, `draft`, `execute`, or `request-approval` modes. The bridge supports presets, context-file injection, context limits, timeouts, and `dry-run` inspection. Its default safety policy turns `execute` into an approval request unless a preset changes that trust setting.

Node.js 20 or newer is required, along with Hermes Agent available as `hermes` or through a custom command path. MCP execution needs an interactive form, so non-interactive clients stop before execution; planning, drafting, dry runs, and direct CLI workflows remain available there.

## Requirements
- Needs: Node.js (commands run via npx)

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add hermes-action-bridge -- npx -y hermes-action-bridge
```

### Codex

**Platform CLI**
```bash
codex mcp add hermes-action-bridge -- npx -y hermes-action-bridge
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "hermes-action-bridge": {
            "command": "npx",
            "args": [
                "-y",
                "hermes-action-bridge"
            ]
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "hermes-action-bridge": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "hermes-action-bridge"
            ]
        }
    }
}
```

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add hermes-action-bridge npx -y hermes-action-bridge
```

## When to use it
- hand off an agent request to Hermes Agent
- run a browser workflow outside the coding session
- inspect the command and prompt before execution
- prepare an action for interactive approval
- send repository context from a file

## Example prompts
- Ask Hermes to inspect this repository and propose the next concrete action.
- Prepare a message-sending action and wait for my approval.
- Run a dry check and show what will be sent to Hermes.

## Similar
- [hermes-agent-skill-authoring](https://affpapa.org/en/nevibecode/skills/hermes-agent-skill-authoring.md) — skill · 523 installs
- [hermes-atlas-mcp](https://affpapa.org/en/nevibecode/mcp/hermes-atlas-mcp.md) — MCP server · ★ 12
- [hermes-tweet](https://affpapa.org/en/nevibecode/skills/hermes-tweet.md) — skill · 2600 installs
- [next-best-action](https://affpapa.org/en/nevibecode/skills/next-best-action.md) — skill · 680 installs
- [experiment-bridge](https://affpapa.org/en/nevibecode/skills/experiment-bridge.md) — skill · 497 installs
- [Agent Droid Bridge](https://affpapa.org/en/nevibecode/mcp/agent-droid-bridge.md) — MCP server · ★ 22

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md