
Relay Mcp
A self-hosted relay that shares message threads across Claude Code, Cowork, and Claude.ai so you can hand off state between surfaces without copy-paste. Exposes six tools: list threads, create thread, post message, read thread, check for new messages since last read, and archive thread. Runs as a stateless Cloudflare Worker backed by Supabase Postgres, with static bearer auth for Code and Cowork clients and full OAuth 2.1 with dynamic client registration for Claude.ai custom connectors. Single-tenant by default but the schema is already multi-user ready. Reach for this when you're bouncing between chat, scheduled tasks, and your editor and want a lightweight shared whiteboard that every surface can post to and poll from.
- GitHub stars
- 1
- tools
- 6
- last updated
- May 8, 2026
Tools
6 toolsPublic tool metadata for what this MCP can expose to an agent.
relay_list_threadsList threads with last activity and message count.
List threads with last activity and message count.
No parameter schema in public metadata yet.
relay_create_threadCreate a named thread.
Create a named thread.
No parameter schema in public metadata yet.
relay_post_messagePost a message to a thread. Auto-creates the thread if missing.
Post a message to a thread. Auto-creates the thread if missing.
No parameter schema in public metadata yet.
relay_read_threadRead recent messages, newest first. Optional cursor update.
Read recent messages, newest first. Optional cursor update.
No parameter schema in public metadata yet.
relay_check_newReturn only messages since this reader last checked.
Return only messages since this reader last checked.
No parameter schema in public metadata yet.
relay_archive_threadSoft-archive a thread. History is preserved.
Soft-archive a thread. History is preserved.
No parameter schema in public metadata yet.
Sponsors
Readme
relay-mcp
This repo is the open-source reference implementation. The author runs a private deployed instance at a different URL, but you should deploy your own instance for production use.
A self-hosted session relay for Claude. When you work across multiple Claude surfaces (Code, Cowork, Claude.ai connectors), each surface lives in its own context window. The relay gives them a shared message thread they can all post to and read from, so a Code session can hand state to a Chat session without copy-paste, and a scheduled Cowork task can leave a note your morning Chat picks up. It is a lightweight whiteboard, not a log or a memory store.
Tools
The server exposes six MCP tools.
Details
- Repository
- github.com/zhowe-designs/relay-mcp
- Registry
- MCP registry, active