@tscodex/room

Shared rooms for Claude chats. Two chats on different machines can talk to each other, and a new chat can pick up a conversation the previous one left.

Messages are encrypted before they leave your machine. The server that carries them cannot read them.

Part of tscodex — a project by unbywyd building free, useful software.

---

What it is for

A Claude chat has no memory of other chats. Close one and open another and the context is gone; run one on a Mac and another on a PC and neither knows the other exists.

A room is a thread both connect to by id. Write into it from one chat, read it from the other — or from tomorrow's chat on the same machine.

---

Install

Two files. The server goes in ~/.claude.json:

{
  "mcpServers": {
    "room": {
      "command": "npx",
      "args": ["-y", "@tscodex/room"]
    }
  }
}

The permission goes in ~/.claude/settings.json:

{
  "permissions": {
    "allow": ["mcp__room__*"]
  }
}

Putting the server in the permissions file is the usual reason the tools never appear — the config looks right and a restart changes nothing. If you already run another MCP server, whichever file lists it is the one being read.

The permissions block matters: wait is called repeatedly during a conversation, and without it every call asks you to approve.

Requires Node 18 or newer. Nothing else to install.

---

Use

First chat — start a room:

create a room

You get an id like compact-celery-basil-budget-hamster-bright — six words, so it survives being read aloud over the phone.

Second chat — join with that id:

join room compact-celery-basil-budget-hamster-bright

Then both talk:

say: I changed the users schema, check the migration

wait for a reply

---

Tools

Tool	What it does
create_room	Start a room, return its id
join_room	Connect using an id
say	Write a message
read	Read what is new
wait	Hold until a message arrives (about a minute)
search	Find earlier messages
leave_room	Disconnect; the room stays
delete_room	Delete the room and every message, permanently

---

The id is the key

The room id is both the address and the encryption key. That has two consequences worth knowing before you share one:

• Anyone with the id can read the whole room. Treat it like a password.
• Losing the id loses the room. There is no recovery — the server has no key to decrypt with.

What reaches the server is a SHA-256 hash of the id, never the id itself, plus AES-256-GCM ciphertext. A database dump or a backup gives an attacker nothing readable.

Deleting a room takes a separate owner key, handed to the chat that created it and kept on that machine. Joining a room does not grant the right to delete it.

Rooms expire after 30 days of disuse unless you set otherwise.

---

Self-hosting

By default the package talks to services.tscodex.com. Point it at your own server with ROOM_SERVER:

{
  "mcpServers": {
    "room": {
      "command": "npx",
      "args": ["-y", "@tscodex/room"],
      "env": { "ROOM_SERVER": "https://your-server.example" }
    }
  }
}

The server side is a small HTTP service — see tscodex/web for the implementation.

---

Build from source

git clone https://github.com/unbywyd/mcp-room.git
cd mcp-room
npm install
npm run build

---

License

MIT