Provides tools to interact with Zulip, enabling AI agents to send and search messages, manage streams and topics, handle direct messages, and manage reactions and message flags.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@Zulip MCP Server Search for messages about the Q4 roadmap in the 'planning' stream"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
An MCP (Model Context Protocol) server for Zulip, enabling AI agents (Claude, etc.) to read and interact with Zulip streams, messages, and direct messages.
Send & manage messages — stream messages, direct messages, edit, delete
Search messages — by stream, topic, sender, keyword, or unread status (is:unread)
Read direct messages — list all DMs or fetch a conversation with a specific user
Stream management — subscribe, unsubscribe, create streams, list topics
Reactions & flags — add/remove emoji reactions, mark messages read, update flags
Resources — read-only access to streams, subscriptions, users, presence, and DMs
Related MCP server: Zulip MCP Server
Tool | Description |
| Send a message to a stream/topic |
| Send a DM to one or more users |
| Retrieve DMs (all or with a specific user) |
| Edit a message or move it to another topic |
| Delete a message |
| Fetch a single message by ID |
| Search messages by stream, topic, sender, keyword, or unread status |
| Subscribe to a stream (creates it if needed) |
| Unsubscribe from a stream |
| Create a new stream |
| List subscribed or all public streams |
| List topics in a stream |
| List all users in the organization |
| Add an emoji reaction to a message |
| Remove an emoji reaction |
| Bulk-update message flags |
| Mark messages as read |
URI | Description |
| All streams |
| Current user's subscriptions |
| Topics in a stream |
| Messages in a stream topic |
| All users |
| Authenticated user's profile |
| Recent direct messages |
| DM conversation with a specific user |
| Specific user's profile |
| User presence/status |
Log in to your Zulip organization
Go to Settings → Your account → API key
Copy your email and API key
cp .env.example .envEdit .env:
ZULIP_USERNAME=yourbot@your-org.zulipchat.com
ZULIP_API_KEY=your_api_key_here
ZULIP_REALM=https://your-org.zulipchat.comnpm install
npm run buildAdd to your claude_desktop_config.json:
{
"mcpServers": {
"zulip": {
"command": "node",
"args": ["/path/to/zulip-mcp/dist/index.js"],
"env": {
"ZULIP_USERNAME": "yourbot@your-org.zulipchat.com",
"ZULIP_API_KEY": "your_api_key_here",
"ZULIP_REALM": "https://your-org.zulipchat.com"
}
}
}
}Or if installed globally via npm:
{
"mcpServers": {
"zulip": {
"command": "zulip-mcp",
"env": {
"ZULIP_USERNAME": "yourbot@your-org.zulipchat.com",
"ZULIP_API_KEY": "your_api_key_here",
"ZULIP_REALM": "https://your-org.zulipchat.com"
}
}
}
}Variable | Required | Default | Description |
| Yes | — | Bot/user email address |
| Yes | — | Zulip API key |
| Yes | — | Zulip server URL (e.g. |
| No |
| HTTP request timeout in milliseconds |
| No |
| Max retries on transient errors |
npm run dev # run with tsx (no build step)
npm run build # compile TypeScript to dist/MIT
This server cannot be deployed
Messaging tools for AI agents: send messages, manage chats, groups and channels.
Give your AI agents the tools to build, manage, and run automation workflows.
Git-backed platform for skills, tools, and context for AI agents
A comprehensive Model Context Protocol (MCP) server that enables AI assistants to interact with yo…
