Herald

Name: Herald
Author: btouchard

by btouchardversion 1.0.0i★ –iRuns in the cloud

Registry nameio.github.btouchard/herald

Install

Overview

Description from the maker (original English)

Stop copy-pasting between Claude Chat and Claude Code.

PopNx MCP’s three pillars

These three are never merged into one score: opinions, measurements and popularity are different things.

User voiceiNo reviews yetReviews open together with accounts in a later step
Our basic checksi1 of 1 passedChecked from public information; code not scanned yet
UsageiNot measured yet★ –

What you can do with it

We have not written a plain-language summary for this one yet. Below are the facts we read from the registry.

Connection: Runs in the cloud
Transport: Streamable HTTP
Category: Chat & email

Install

Pick the AI app you use, then copy the settings.

Before you install

Basic checks: 1 of 1 passed
Runs on the maker’s server: what you ask it goes through their server.
The registry lists no key to fill in.

You need

Runs in the cloudNothing to install; it connects over the internet

Which app do you use?

ClaudeClaude CodeCursorVS CodeChatGPT

Pick your app above. We remember it, so next time the button says “Install in …”.

Works in Claude on the web, desktop and mobile:

Open Settings → Connectors
Press Add custom connector
Paste the address below and press Add
If it asks you to sign in, sign in with the maker

https://your-herald-instance.example.com/mcp

Run this in your terminal

claude mcp add --transport http herald https://your-herald-instance.example.com/mcp

Open in Cursor

Or copy the settings yourself

Paste into .cursor/mcp.json in your project, or ~/.cursor/mcp.json

{
  "mcpServers": {
    "herald": {
      "url": "https://your-herald-instance.example.com/mcp"
    }
  }
}

Your browser asks to open the app, then the app shows the settings and asks you to confirm. Key values are left empty for you to fill in.

Open in VS Code

Or copy the settings yourself

Paste into .vscode/mcp.json in your project

{
  "servers": {
    "herald": {
      "type": "http",
      "url": "https://your-herald-instance.example.com/mcp"
    }
  }
}

Your browser asks to open the app, then the app shows the settings and asks you to confirm. Key values are left empty for you to fill in.

ChatGPT connects only to servers on the internet:

Open ChatGPT on the web → Settings → Connectors (Apps)
Press Create or Add (some plans need Developer mode under Advanced first)
Paste the address below, give it a name and save
If it asks you to sign in, sign in with the maker

https://your-herald-instance.example.com/mcp

Menu names can differ slightly by plan and over time.

Your choice stays on this device in a cookie; no account needed.

These settings are generated from the maker’s registry entry. If the README says otherwise, follow the README.

What it can do

We have not read this server’s tool list yet; we check endpoints in rotation.

Basic checksi

We check information anyone can see; we have not read the code. Checks that do not apply are left out of the count. · Checked Nov 7, 2026

✓ Pass
Maker matches the repo
The registry name was verified with the GitHub account btouchard, which owns the repo
… Not checked yet
Still maintained
We have not read this repo from GitHub yet
… Not checked yet
Has a licence
We have not read this repo from GitHub yet
… Not checked yet
Endpoint responds
Not checked yet; we check endpoints in rotation
… Not checked yet
Sign-in with OAuth
Not checked yet; we check endpoints in rotation
… Not checked yet
No hidden instructions in tool descriptions
Not checked yet; we read the tool list when we check the endpoint

Compared with others in Chat & emaili

More stars than 0% of the other 1774 servers in this category
Published to the registry more recently than 3% of the other 1774 servers in this category
Basic checks equal to or better than 100% of the other 1774 servers in this category

Compared with every active server in this category in the registry. Stars count only when the publisher owns the repo.

Common questions

Is Herald safe?

It passed 1 of 1 applicable basic checks. We have not read the code. Before adding a key or token, see what access the server asks for and use a key with only the permissions you need.

What keys or codes does it need?

The registry does not list a required key, though some servers ask you to sign in on first use.

Does it run on my computer or in the cloud?

It runs in the maker’s cloud. Connect over the internet with nothing to install, but what you send passes through the maker’s servers.

Is it still maintained?

The GitHub repo last changed –, and the latest version (1.0.0) reached the registry 9 months ago.

Which apps can use it?

Apps that support MCP, such as Claude Desktop, Claude Code, Cursor and VS Code. It connects by URL, so apps that accept remote MCP servers work too, such as ChatGPT in developer mode.

What can I use instead?

In the same category: Vexa, emailmd, MCP WhatsApp Cloud

Alternatives

Servers in the same category from other makers, sorted by stars.

Reading a card:★ GitHub starsiThree pillars: reviews · checks · usageiUpdated = latest version published to the registryi

Vexa

by Vexa-ai

Meeting bot and transcripts for Google Meet, Teams and Zoom. Live or after, speakers labelled.

Runs in the cloud★ 2,949Apache-2.0Updated 2 months ago

Install

emailmd

by anypost

Render markdown into email-safe HTML, lint drafts for deliverability problems, and preview emails.

Computer or cloud★ 1,385MITUpdated 31 days ago

Install

MCP WhatsApp Cloud

by codespar

MCP server for WhatsApp Cloud API (Meta) — messages, media, and templates via Graph API

Runs on your computer★ 277MITUpdated 5 months ago

Install

README from the maker

Open the README

Copied from the maker’s repo as written. PopNx MCP has not reviewed or endorsed it. HTML, images and scripts are removed. Links lead off this site.

Herald

Code from your phone. Seriously.

The self-hosted MCP bridge between Claude Chat and Claude Code.

Documentation · Quick Start · How It Works · Features · Security · Roadmap

🇫🇷 Version française

You're on the couch. On your phone. You open Claude Chat and type:

*"Refactor the auth middleware in my-api to use JWT instead of session cookies. Run the tests."*

Four minutes later, it's done. Branch created, code refactored, tests passing, changes committed. Your workstation did all the work. You never opened your laptop.

That's Herald.

The Problem

Claude Chat and Claude Code are two brilliant tools that live in completely separate worlds.

	Claude Chat	Claude Code
Where	Browser, phone, anywhere	Your terminal
What	Conversations, analysis, thinking	Reads, writes, and ships actual code
Gap	Can't touch your codebase	Can't leave your desk

You've been copy-pasting between them. Or worse — you've been waiting until you're back at your desk. That's over.

The Solution

Herald is a self-hosted MCP server that bridges Claude Chat to Claude Code using Anthropic's official Custom Connectors protocol. One Go binary. Zero hacks.

  You (phone/tablet/browser)

│ │ "Add rate limiting to the API" ▼ Claude Chat ──── MCP over HTTPS ────► Herald (your workstation) │ ▼ Claude Code ├── reads your codebase ├── writes the code ├── runs the tests └── commits to a branch

You (terminal) │ │ Claude Code calls herald_push ▼ Claude Code ──── MCP ────► Herald ────► Claude Chat picks it up └── session context, summary, files modified, git branch

The bridge is bidirectional. Claude Chat dispatches tasks to Claude Code, and Claude Code can push session context back to Herald for remote monitoring and continuation from another device.

Your code never leaves your machine. Herald just orchestrates.

How It Works

You (Claude Chat)          Herald                     Claude Code

───────────────── ────── ─────────── "Refactor auth..." ──► start_task → creates branch → spawns Claude Code ──► reads codebase refactors code runs tests commits changes ◄── task_id: herald-a1b2c3d4

"How's it going?" ──► check_task ◄── ✅ Completed (4m 12s) 4 files changed (+127/-23)

"Show me the diff" ──► get_diff ◄── auth/middleware.go +func ValidateJWT(...) -func CheckSession(...)

Three tools. That's the core loop. Start, check, get results — all from wherever you are.

Reverse flow: Claude Code → Herald

Working in your terminal and want to continue from your phone? Claude Code pushes its session to Herald:

You (terminal)             Claude Code                Herald

────────────── ─────────── ────── "Push this to Herald" ──► herald_push → session_id, summary, files, branch ──► linked task created 🔗 visible in list_tasks

You (phone, later) Claude Chat Herald ────────────────── ─────────── ────── "What sessions are list_tasks waiting for me?" ──► (status: linked) ──► 🔗 herald-a1b2c3d4 my-api / feat/auth

"Resume that session" ──► start_task (session_id) ──► picks up where you left off

Features

Core

Native MCP bridge — Uses Anthropic's official Custom Connectors protocol. Not a hack, not a wrapper, not a proxy.
Async task execution — Start tasks, check progress, get results. Claude Code runs in the background while you do other things.
Git branch isolation — Each task runs on its own branch. Your main branch stays untouched.
Session resumption — Multi-turn Claude Code conversations. Pick up where you left off.
Bidirectional bridge — Claude Code can push session context to Herald via herald_push for remote monitoring and continuation from another device.

Multi-Project

Multiple projects — Configure as many projects as you need, each with its own settings.
Per-project tool restrictions — Control exactly which tools Claude Code can use. Full sandboxing per project.

Operations

MCP push notifications — Herald pushes task updates directly to Claude Chat via MCP server notifications. No polling needed.
SQLite persistence — Tasks survive server restarts. Full history, fully searchable.

Engineering

Single binary — One Go executable, ~15MB. No Docker, no runtime, no node_modules.
Zero CGO — Pure Go. Cross-compiles to Linux, macOS, Windows, ARM.
6 dependencies — chi, mcp-go, modernc/sqlite, uuid, yaml, testify. That's the entire dependency tree.

Quick Start

Prerequisites: Claude Code CLI installed, HTTPS via ngrok (built-in) or a domain with reverse proxy.

1. Install

curl -fsSL https://raw.githubusercontent.com/btouchard/herald/main/install.sh | sh

Or build from source (requires Go 1.26+)

git clone https://github.com/btouchard/herald.git

cd herald && make build

Binary is in ./bin/herald

</details>

2. Configure

mkdir -p ~/.config/herald

cp configs/herald.example.yaml ~/.config/herald/herald.yaml

Edit with your domain and projects (see below)

3. Run

herald serve

Client secret is auto-generated on first start and displayed in the console

Edit ~/.config/herald/herald.yaml with your domain and projects:

server:

host: "127.0.0.1" port: 8420 public_url: "https://herald.yourdomain.com"

auth: client_id: "herald-claude-chat"

projects: my-api: path: "/home/you/projects/my-api" description: "Main backend API" default: true allowed_tools:

"Read"
"Write"
"Edit"
"Bash(git *)"
"Bash(go *)"
"Bash(make *)" git: auto_branch: true branch_prefix: "herald/"

Then connect from Claude Chat:

Claude Chat → Settings → Custom Connectors
Add connector: https://herald.yourdomain.com/mcp
Authenticate via OAuth
Done — Claude Chat now has 10 new tools to control your workstation

Quick Start with ngrok (No Reverse Proxy Needed)

Don't have a domain or reverse proxy? Use ngrok to expose Herald instantly over HTTPS:

1. Get ngrok auth token

2. Enable tunnel in config

Edit ~/.config/herald/herald.yaml:

tunnel:

enabled: true provider: "ngrok" authtoken: "2abc..." # or set HERALD_NGROK_AUTHTOKEN env var

domain: "my-herald.ngrok-free.app" # optional: fixed domain (paid plans)

3. Run Herald

herald serve

Tunnel URL appears in the banner:

Tunnel: https://abc123.ngrok-free.app (ngrok)

Connect from Claude Chat using the ngrok URL shown in the banner. That's it — no Traefik, Caddy, or DNS setup required.

Note: The ngrok tunnel is optional. If you already have a reverse proxy (Traefik/Caddy), leave tunnel.enabled: false and use your domain as usual.

Full configuration reference

server:

host: "127.0.0.1" # Always localhost — reverse proxy handles external port: 8420 public_url: "https://herald.yourdomain.com" log_level: "info" # debug, info, warn, error log_file: "" # Optional file path for log output

auth: client_id: "herald-claude-chat"

client_secret is auto-generated — override with HERALD_CLIENT_SECRET env var if needed

access_token_ttl: 1h refresh_token_ttl: 720h # 30 days redirect_uris:

"https://claude.ai/oauth/callback"
"https://claude.ai/api/oauth/callback"
"https://claude.ai/api/mcp/auth_callback"

database: path: "~/.config/herald/herald.db" retention_days: 90

execution: claude_path: "claude" model: "claude-sonnet-4-5-20250929" # Default model for tasks default_timeout: 30m max_timeout: 2h work_dir: "~/.config/herald/work" max_concurrent: 3 max_prompt_size: 102400 # 100KB max_output_size: 1048576 # 1MB env: CLAUDE_CODE_ENTRYPOINT: "herald" CLAUDE_CODE_DISABLE_AUTO_UPDATE: "1"

projects: my-api: path: "/home/you/projects/my-api" description: "Main backend API" default: true allowed_tools:

"Read"
"Write"
"Edit"
"Bash(git *)"
"Bash(go *)"
"Bash(make *)" max_concurrent_tasks: 1 git: auto_branch: true auto_stash: true auto_commit: true branch_prefix: "herald/"

tunnel: enabled: false # Set to true to enable ngrok tunnel provider: "ngrok" authtoken: "" # or set HERALD_NGROK_AUTHTOKEN env var

domain: "" # optional: fixed domain (paid ngrok plans)

rate_limit: requests_per_minute: 200 burst: 100

MCP Tools

Herald exposes 10 tools that Claude Chat discovers automatically via the MCP protocol:

Tool	What it does
`start_task`	Launch a Claude Code task. Returns an ID immediately. Supports priority, timeout, session resumption, and Git branch options.
`check_task`	Check status and progress. Optionally include recent output.
`get_result`	Get the full result of a completed task (`summary`, `full`, or `json`).
`list_tasks`	List tasks with filters — status, project, time range.
`cancel_task`	Cancel a running or queued task. Optionally revert Git changes.
`get_diff`	Git diff for a task's branch or uncommitted changes.
`list_projects`	List configured projects with Git status.
`read_file`	Read a file from a project (path-safe — cannot escape project root).
`herald_push`	Push a Claude Code session to Herald for remote monitoring and continuation from another device.
`get_logs`	View logs and activity history.

Security

Herald expos

Only the beginning is shown; read the rest in the repo

Herald

Overview

PopNx MCP’s three pillars

What you can do with it

Install

Before you install

What it can do

Basic checksi

Maker matches the repo

Still maintained

Has a licence

Endpoint responds

Sign-in with OAuth

No hidden instructions in tool descriptions

Compared with others in Chat & emaili

Common questions

Alternatives

Vexa

emailmd

MCP WhatsApp Cloud

README from the maker

The Problem

The Solution

How It Works

Reverse flow: Claude Code → Herald

Features

Core

Multi-Project

Operations

Engineering

Quick Start

Binary is in ./bin/herald

Edit with your domain and projects (see below)

Client secret is auto-generated on first start and displayed in the console

Quick Start with ngrok (No Reverse Proxy Needed)

domain: "my-herald.ngrok-free.app" # optional: fixed domain (paid plans)

Tunnel URL appears in the banner:

Tunnel: https://abc123.ngrok-free.app (ngrok)

client_secret is auto-generated — override with HERALD_CLIENT_SECRET env var if needed

domain: "" # optional: fixed domain (paid ngrok plans)

MCP Tools

Security