switchboard
Uses Cloudflare Access for human sign-in and email allowlisting, and supports Cloudflare Tunnel for securely exposing the remote MCP endpoint.
Sends ntfy notifications when a coding-agent turn ends, the agent needs user input, or the session fails, when no client is already waiting.
Sends Telegram notifications when a coding-agent turn ends, the agent needs user input, or the session fails, when no client is already waiting.
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
switchboard
An MCP server that is a control plane for coding-agent sessions. Start, steer, answer and resume Claude Code or any Agent Client Protocol agent (OpenCode, Codex, Gemini CLI, …) from any MCP client — including claude.ai, on your phone, by voice.
You talk to Claude. Claude hands the work to a real coding agent on your own machine, relays the agent's questions back to you, and you get a ping when it's done.

What makes it different
Real back-and-forth. When the agent asks a question (
AskUserQuestion) or needs approval, the session goes towaitingand the question comes back through MCP as structured data. Claude answers from context or asks you. Nothing else we found could answer an agent's questions remotely.Built for flaky, short-lived calls. Every tool returns within
max_wait(25 s by default); long work is followed withwaitand a cursor. Hang up mid-build and nothing is lost.Any agent. Claude Code is driven through the official Agent SDK; every other agent through ACP. Adding one is a config entry.
Legit remote auth. A full OAuth 2.1 server (PKCE, CIMD + DCR, RFC 9728 / 8414 / 8707) of its own, so claude.ai connects as a normal custom connector. Human sign-in is delegated to Cloudflare Access (or run it locally with no auth over stdio).
Sessions survive. State lives in SQLite; idle sessions park and resume with their context; a restart doesn't lose anything but the in-flight turn.
Related MCP server: claude-voice-bridge
Tools
Tool | What it does |
| configured agents and workspaces |
| new session on a task; returns within ~10 s with its state |
| follow-up in a session (resumes parked ones) |
| progress since a cursor: activity, a pending question, or the reply |
| answer a question or approval in the user's words (“blue”, “2”, “allow”) |
| everything, one line each |
| interrupt the turn or close the session |
The server's MCP instructions tell the client it is pairing with a live agent: relay questions, keep the user posted, don't go silent in voice.
Quick start (local, Claude Code or Claude Desktop)
git clone https://github.com/jeffclimbsbikes/switchboard && cd switchboard
npm ci && npm run build
mkdir -p ~/.config/switchboard && cp switchboard.example.toml ~/.config/switchboard/config.toml
$EDITOR ~/.config/switchboard/config.toml # set a workspace
node dist/cli.js check
claude mcp add switchboard -- node "$PWD/dist/cli.js" stdioNode 22.13+ is required. switchboard check confirms the agent executables
and workspaces exist.
Remote: claude.ai as the client
Run switchboard serve behind HTTPS and add https://<host>/mcp as a custom
connector in claude.ai (Settings → Connectors). The recommended setup is a
Cloudflare Tunnel with two Access applications:
Host / path | Access policy | Why |
| allow your email (optionally + WARP) | the only human step; switchboard verifies the Access JWT |
| bypass | claude.ai's servers call |
Then set [auth] login = "cloudflare-access" with your team, the AUD tag of
the /authorize application, and the allowed emails. See
docs/design for the full flow and diagrams.
switchboard grants lists connected clients; --revoke signs them all out.
Notifications (Telegram, ntfy, or any command) fire when a turn ends, the agent needs you, or it fails — but only if no client is already waiting.
Security model
switchboard runs coding agents with whatever permissions you configure; with
bypassPermissions anyone who can call it can run code as that user. So:
remote access always goes through OAuth with an email allowlist, auth = "none" and "dev" refuse to listen beyond loopback, tokens are stored hashed
and refresh tokens rotate with reuse detection. Run it as a user whose blast
radius you accept.
Development
npm run check # biome + tsc + vitest (no network, no secrets)
SWITCHBOARD_LIVE=1 npx vitest run test/live # real claude (haiku) + opencode handshakeEvery outside dependency has a stand-in in test/fixtures: a fake claude
CLI speaking its stream-json control protocol, a fake ACP agent, a local JWKS
for Cloudflare Access. One driver contract suite
(test/contract/driver-contract.ts) runs against every driver.
License
MIT
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Lets Claude, Cursor or any MCP client build voice agents and place real phone calls.
Shared memory MCP server for Claude Code, Codex, Gemini CLI and Cursor. Cited, editable.
Talk to your public-facing AI from any MCP client — Claude, ChatGPT, Cursor, Cline, Windsurf.
Real-time chat for AI agents. Claude Code, Cursor, Cline and Codex join channels over MCP.
Related MCP Servers
- AlicenseAqualityDmaintenanceWraps Claude Code as tools for MCP clients, enabling autonomous coding tasks via a 4-tool lifecycle with session management, async polling, and permission controls.457 npm21MIT
- FlicenseNot gradedqualityDmaintenanceExposes headless Claude Code as a remote MCP server with a voice client, enabling hands-free task execution and session management via OpenAI's Realtime API.-
- AlicenseAqualityBmaintenanceMCP server that lets you drive Claude Code sessions hands-free by voice from any MCP client, enabling remote models to send prompts, monitor progress, and get results read back.71MIT
- AlicenseNot gradedqualityBmaintenanceEnables voice assistants to start, monitor, message, and approve local Claude Code sessions on your computer, including sessions already open in a terminal. It exposes session management, recaps, approvals, and history search as MCP tools.7GPL 3.0