zulipmcp
Run AI agents in Zulip as @mentionable bots — or wire into any MCP client. Also works as a Python library.
Quickstart
Install the package:
uv add zulipmcp --git https://github.com/windborne/zulipmcp.gitAdd a
.zuliprcfile to your project root with your Zulip bot credentials. See Add a bot or integration for instructions on making a bot. The bot type must be "generic."Add the MCP server to your
.mcp.json:{ "mcpServers": { "zulip": { "command": "uv", "args": ["run", "python", "-m", "zulipmcp.mcp"] } } }Restart your MCP client. The Zulip tools should now be available.
Requirements
- Python >=3.10, managed with uv
- A
.zuliprcfile for Zulip API auth (see Quickstart) - For listener mode: the selected backend CLI installed and authenticated (
claudeby default,codexwith--backend codex, oropencodewith--backend opencode)
Entry Points
| Entry Point | Description |
|---|---|
uv run python -m zulipmcp.mcp |
MCP server for Claude Code, Codex, and other MCP clients |
uv run python -m zulipmcp.mcp --transport sse |
MCP server over SSE (for remote/web clients) |
uv run python -m zulipmcp.listener |
Listener: watches for @mentions, spawns agent sessions |
