zhowe-designs avatar

Relay Mcp

zhowe-designs/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 tools

Public 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.


View the full README on GitHub

Details

Repository
github.com/zhowe-designs/relay-mcp
Registry
MCP registry, active

More from zhowe-designs