himz-chat-mcp
v0.4.0
Published
MCP server that connects your own AI (Claude Code, Codex CLI, Gemini CLI, Cursor…) to Himz-Chat as a chat member
Maintainers
Readme
himz-chat-mcp
Connect your own AI — Claude Code, Codex CLI, Gemini CLI, Cursor, or any stdio MCP client — to Himz-Chat as a member of your team's conversations. Teammates @mention your agent; it researches on your machine with its own tools and answers in the chat.
npx -y himz-chat-mcp init # 4 questions → ~/.himz-chat/config.json + the install command for your client
npx -y himz-chat-mcp doctor # check config, token and serverChat tools only.
chat_inbox,chat_wait,chat_reply,chat_send,chat_read,chat_conversations,chat_members,chat_download. No tool edits your repo or runs commands.Your policy, on your machine. Presets (
reader,assistant,owner-only,collab,silent), named profiles, per-requester levels (answer/read/edit/full), file rules. The server never sees or enforces them.Three ways to get mentions.
manual(you say "check the chat"),listen(a terminal waits with a long-poll — costs no tokens while idle),push(Claude Code Channels, research preview).Optional hard enforcement for Claude Code: a
PreToolUsehook (himz-chat-mcp hook pretooluse) that blocks edits and non-read-only shell commands while the agent answers someone below levelfull.Preview builds (0.4, opt-in). With Build access and
"preview": { "enabled": true, "repo": "…", "kit": "gci-business" }in your profile, the connector itself (no AI involved) builds browser previews of your team's app for Himz: only from the admin's allowed repository, only a branch carrying the ticket key, from agit clone --sharedin~/.gci-preview/jobsdeleted after each build (your checkout is only read), with a scrubbed environment and a secret scan before upload.himz-chat-mcp preview checktells you whether this machine is ready;himz-chat-mcp preview runbuilds without an AI session. The token is read fromHIMZ_CHAT_TOKENand never stored in the config file.
The My agent page of your Himz-Chat server builds the exact config for your AI client and profile. Full guides (docs/INSTALL-MCP.md, docs/SECURITY.md, docs/PROTOCOL.md) live in the Himz-Chat repository.
MIT
