btouchard avatar

Herald

btouchard/herald

Herald bridges Claude Chat and Claude Code through a self-hosted Go server that lets you dispatch coding tasks from your phone and pick them up later at your desk. It exposes MCP tools like start_task, check_task, and get_diff so you can tell Claude Chat to refactor code, run tests, and commit changes while Claude Code does the work on your local machine. Each task runs on its own git branch, sessions persist across restarts in SQLite, and Claude Code can push context back to Herald with herald_push for bidirectional workflows. Reach for this when you want to kick off real code changes from anywhere without copy-pasting between two Claude interfaces or waiting to get back to your terminal.

GitHub stars
43
tools
10
transport
HTTP
last updated
Feb 14, 2026

Tools

10 tools

Public tool metadata for what this MCP can expose to an agent.

start_taskLaunch a Claude Code task. Returns an ID immediately. Supports priority, timeout, session resumption, and Git branch options.

Launch a Claude Code task. Returns an ID immediately. Supports priority, timeout, session resumption, and Git branch options.

No parameter schema in public metadata yet.

check_taskCheck status and progress. Optionally include recent output.

Check status and progress. Optionally include recent output.

No parameter schema in public metadata yet.

get_resultGet the full result of a completed task (summary, full, or json).

Get the full result of a completed task (summary, full, or json).

No parameter schema in public metadata yet.

list_tasksList tasks with filters — status, project, time range.

List tasks with filters — status, project, time range.

No parameter schema in public metadata yet.

cancel_taskCancel a running or queued task. Optionally revert Git changes.

Cancel a running or queued task. Optionally revert Git changes.

No parameter schema in public metadata yet.

get_diffGit diff for a task's branch or uncommitted changes.

Git diff for a task's branch or uncommitted changes.

No parameter schema in public metadata yet.

list_projectsList configured projects with Git status.

List configured projects with Git status.

No parameter schema in public metadata yet.

read_fileRead a file from a project (path-safe — cannot escape project root).

Read a file from a project (path-safe — cannot escape project root).

No parameter schema in public metadata yet.

herald_pushPush a Claude Code session to Herald for remote monitoring and continuation from another device.

Push a Claude Code session to Herald for remote monitoring and continuation from another device.

No parameter schema in public metadata yet.

get_logsView logs and activity history.

View logs and activity history.

No parameter schema in public metadata yet.

Sponsors

Readme

Herald

Code from your phone. Seriously.
The self-hosted MCP bridge between Claude Chat and Claude Code.

Go 1.26+ AGPL-3.0 License GitHub Stars

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:


View the full README on GitHub

Details

Repository
github.com/btouchard/herald
Category
Communication & Messaging
Transport
HTTP
Registry
MCP registry, active

Related Communication & Messaging MCP servers

View all
1upinar avatarContrastAPIupinar/contrastapi55 tools, 7 Resources, Sigma rules, email SPF/DMARC, MITRE, CVE/KEV, risk_score. No key.36stars
2w1ne avatarkernelCADw1ne/kernelcad-webCAD in ChatGPT and Claude: editable parts, STEP/STL/drawings, in-chat 3D, automatic checks.0stars
3houtini-ai avatarGeminihoutini-ai/gemini-mcpModel Context Protocol server for Google Gemini AI with chat, research, and grounding34stars
4s2thend avatarCursor Historys2thend/cursor-history-mcpMCP server for browsing, searching, exporting, and backing up your Cursor AI chat history33stars
5arikusi avatarDeepseekarikusi/deepseek-mcp-serverMCP server for DeepSeek AI with chat, reasoning, sessions, function calling, and cost tracking26stars
6jmedure avatarTalkbackjmedure/talkback-mcpChat with your Ableton session in real-time.24stars