windborne/zulipmcp

Overview

A Python tool that turns Zulip chat into an MCP server, letting AI agents join conversations as @mentionable bots. It also exposes Zulip channels to any MCP client for reading and writing messages.

Best for

Best for
Developers who want to add AI agents to Zulip or bridge Zulip with MCP-compatible tools

Use cases

• Deploy an AI agent that responds to @mentions in Zulip channels
• Connect an MCP client to monitor and post in Zulip streams
• Build a bot that reads Zulip messages and triggers external workflows

How to use

Install

uv add zulipmcp --git https://github.com/windborne/zulipmcp.git

Tools exposed

• ZULIP_RC_PATH
• ZULIP_MAX_MESSAGE_LENGTH
• TRIGGER_MESSAGE_ID
• SESSION_USER_EMAIL
• SESSION_STREAM
• SESSION_TOPIC
• BOT_ALLOWED_PRIVATE_STREAMS
• BOT_ALLOWED_WRITE_STREAMS
• ZULIPMCP_CACHE_DIR
• ZULIPMCP_LOG_DIR

Tested with

Claude Code, Codex, OpenCode

Example client config

{\n  "mcpServers": {\n    "zulip": {\n      "command": "uv",\n      "args": ["run", "python", "-m", "zulipmcp.mcp"]\n    }\n  }\n}

Notes

A Python tool that turns Zulip chat into an MCP server, letting AI agents join conversations as @mentionable bots. It also exposes Zulip channels to any MCP client for reading and writing messages.

9 stars on GitHub. Last updated 2026-06-01. Licensed MIT.

Use cases

• Deploy an AI agent that responds to @mentions in Zulip channels
• Connect an MCP client to monitor and post in Zulip streams
• Build a bot that reads Zulip messages and triggers external workflows

Pros

• Tight integration with Zulip’s real-time messaging API
• Works as both a standalone bot and a generic MCP server
• Lightweight Python implementation with minimal dependencies

Cons

• Requires a running Zulip server or account to use
• Limited to Zulip’s message and stream model
• Small community and limited documentation beyond the repo

Indexed from awesome-mcp-servers-punkpeye and enriched against its public facts.