@chatroomcp/chatroom
v0.2.2
Published
Local MCP runtime for ChatGPT with workspace, process, Cloud, and WebUI controls.
Readme
ChatRoom is a local MCP runtime that lets ChatGPT work with projects and processes on your device. Its WebUI provides workspace browsing, Git repository management, process monitoring, ChatRoom Cloud controls, and plugin-attributed operation logs.
Install
Requires Node.js 24.15.0 or newer and Git.
npm install -g @chatroomcp/chatroom
chatroom init
chatroom serveDefault local endpoints:
WebUI http://127.0.0.1:8765/
MCP http://127.0.0.1:8765/mcpchatroom init creates ~/.config/chatroom/config.json and uses ~/Projects as the default allowed workspace root.
Use with ChatGPT
ChatGPT connects to ChatRoom through its MCP endpoint. For remote access, either enable ChatRoom Cloud from the WebUI or expose ChatRoom through your own HTTPS ingress and configure the corresponding public URL.
Create a custom MCP app in ChatGPT Developer Mode, use the ChatRoom /mcp URL, and complete OAuth authorization with the ownerToken stored in ~/.config/chatroom/config.json.
See Use ChatRoom with ChatGPT for the current ChatGPT setup flow.
ChatRoom Cloud
ChatRoom Cloud is built into ChatRoom and provides optional public access for Remote MCP and Remote WebUI. Open the Cloud page in the WebUI to purchase, restore, or manage access.
Documentation
License
Apache-2.0
