zulipchat-mcp

MCP.Pizza Chef: akougkas

This server connects your AI assistant to your Zulip Chat workspace, enabling it to send, read, search, and manage messages and conversations. It works with popular AI apps like Claude Desktop, Cursor, and VS Code, requiring only your Zulip API key file for setup. With it, you can interact with Zulip through natural language commands, get message summaries, add reactions, and even post as a bot. Setup involves a simple config snippet, no complex installs needed.

Communication
Other

Use This MCP server To

Send and read Zulip messages via my AI assistant Search Zulip conversations by sender, topic, or date Post messages as myself or a bot through AI Get summaries of recent Zulip activity Add reactions to messages using AI Monitor who is online in my Zulip streams Request approvals within Zulip topics via AI

README

ZulipChat MCP Server

Model Context Protocol server for Zulip Chat. Connect Claude Code, Gemini CLI, Codex, Cursor, Windsurf, VS Code Copilot, and other MCP clients to Zulip.

PyPI CI Publish Coverage Gate Downloads GitHub stars Python License MCP

Quick Start · Setup Wizard · Integrations · Two-Tier Tools · Contributing


Quick Start

uvx zulipchat-mcp --zulip-config-file ~/.zuliprc

That's it. Your AI assistant can now read and write Zulip messages.

Need a zuliprc? Zulip Settings > Personal > Account & privacy > API key — download the file, save it as ~/.zuliprc.

Interactive onboarding:

zulipchat-mcp FAQ

Can I use this to send and read messages in my Zulip workspace?
Yes — this server lets your AI assistant send, read, and manage messages directly in Zulip.
Can I search conversation history and find messages by sender or topic?
Yes — it supports full-text search with filters for sender, stream, and time range.
Which apps can I use this with?
It works with Claude Desktop, Cursor, VS Code, Windsurf, Gemini CLI, and other MCP-compatible clients.
Do I need a Zulip account or API key?
Yes — you need a Zulip API key file (zuliprc) from your Zulip account settings to connect.
How hard is it to set up?
Setup is copy-paste-config — you just add a small config snippet and provide your zuliprc file.
Can I post messages as a bot or switch identities?
Yes — you can switch between your user and bot identities in the same session.
Does it support advanced features like scheduled messages or file uploads?
Yes — by enabling extended tools, you get access to over 60 advanced features beyond the core 20.
Can I use this without installing anything complicated?
Yes — you can run it via simple commands using uvx and provide your Zulip config file.