Zulip Chat

by akougkas

Not rated yet

GitHub Website

Communication

About

An MCP server for integrating with the Zulip team chat platform.

Explore

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

Download and install Highlight from highlightai.com/download
Navigate to the plugins tab and select "Add Custom Plugin"
Configure the plugin with the settings below

Plugin Name Zulip Chat

Command (node, npx, python, etc.)

Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
Enable "Start Automatically" if you want the plugin to start when Highlight launches

Setting up with Cursor

Open Cursor's settings
Navigate to the MCP section
Click "Add new Global MCP server"
Copy and paste the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "zulip chat": {
            "server": {
                "command": "uvx",
                "args": [
                    "zulipchat-mcp"
                ],
                "env": {
                    "ZULIP_EMAIL": "",
                    "ZULIP_API_KEY": "",
                    "ZULIP_SITE": ""
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "zulip chat": {
            "server": {
                "command": "uvx",
                "args": [
                    "zulipchat-mcp"
                ],
                "env": {
                    "ZULIP_EMAIL": "",
                    "ZULIP_API_KEY": "",
                    "ZULIP_SITE": ""
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "zulip chat": {
            "server": {
                "command": "uvx",
                "args": [
                    "zulipchat-mcp"
                ],
                "env": {
                    "ZULIP_EMAIL": "",
                    "ZULIP_API_KEY": "",
                    "ZULIP_SITE": ""
                }
            }
        }
    }
}

Setting up with Claude Desktop

Open Claude Desktop's settings
Go to the Integrations tab
Click "Add MCP Server"
Use the configuration below based on your operating system

Note: Make sure Claude Desktop is running before attempting to connect.

JSON

{
    "mcpServers": {
        "zulip chat": {
            "server": {
                "command": "uvx",
                "args": [
                    "zulipchat-mcp"
                ],
                "env": {
                    "ZULIP_EMAIL": "",
                    "ZULIP_API_KEY": "",
                    "ZULIP_SITE": ""
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "zulip chat": {
            "server": {
                "command": "uvx",
                "args": [
                    "zulipchat-mcp"
                ],
                "env": {
                    "ZULIP_EMAIL": "",
                    "ZULIP_API_KEY": "",
                    "ZULIP_SITE": ""
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "zulip chat": {
            "server": {
                "command": "uvx",
                "args": [
                    "zulipchat-mcp"
                ],
                "env": {
                    "ZULIP_EMAIL": "",
                    "ZULIP_API_KEY": "",
                    "ZULIP_SITE": ""
                }
            }
        }
    }
}

Setting up with Windsurf

Open Windsurf's preferences
Go to the Integrations section
Click "Add MCP Integration"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "zulip chat": {
            "server": {
                "command": "uvx",
                "args": [
                    "zulipchat-mcp"
                ],
                "env": {
                    "ZULIP_EMAIL": "",
                    "ZULIP_API_KEY": "",
                    "ZULIP_SITE": ""
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "zulip chat": {
            "server": {
                "command": "uvx",
                "args": [
                    "zulipchat-mcp"
                ],
                "env": {
                    "ZULIP_EMAIL": "",
                    "ZULIP_API_KEY": "",
                    "ZULIP_SITE": ""
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "zulip chat": {
            "server": {
                "command": "uvx",
                "args": [
                    "zulipchat-mcp"
                ],
                "env": {
                    "ZULIP_EMAIL": "",
                    "ZULIP_API_KEY": "",
                    "ZULIP_SITE": ""
                }
            }
        }
    }
}

Setting up with Cline

Open Cline's settings
Navigate to the Integrations section
Click "Add MCP Server"
Copy and paste the configuration below based on your operating system

Note: Make sure to restart Cline after adding the configuration.

JSON

{
    "mcpServers": {
        "zulip chat": {
            "server": {
                "command": "uvx",
                "args": [
                    "zulipchat-mcp"
                ],
                "env": {
                    "ZULIP_EMAIL": "",
                    "ZULIP_API_KEY": "",
                    "ZULIP_SITE": ""
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "zulip chat": {
            "server": {
                "command": "uvx",
                "args": [
                    "zulipchat-mcp"
                ],
                "env": {
                    "ZULIP_EMAIL": "",
                    "ZULIP_API_KEY": "",
                    "ZULIP_SITE": ""
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "zulip chat": {
            "server": {
                "command": "uvx",
                "args": [
                    "zulipchat-mcp"
                ],
                "env": {
                    "ZULIP_EMAIL": "",
                    "ZULIP_API_KEY": "",
                    "ZULIP_SITE": ""
                }
            }
        }
    }
}

Setting up with Goose

Open Goose's preferences
Go to the Integrations tab
Select "MCP Servers"
Click "Add New Server"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "zulip chat": {
            "server": {
                "command": "uvx",
                "args": [
                    "zulipchat-mcp"
                ],
                "env": {
                    "ZULIP_EMAIL": "",
                    "ZULIP_API_KEY": "",
                    "ZULIP_SITE": ""
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "zulip chat": {
            "server": {
                "command": "uvx",
                "args": [
                    "zulipchat-mcp"
                ],
                "env": {
                    "ZULIP_EMAIL": "",
                    "ZULIP_API_KEY": "",
                    "ZULIP_SITE": ""
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "zulip chat": {
            "server": {
                "command": "uvx",
                "args": [
                    "zulipchat-mcp"
                ],
                "env": {
                    "ZULIP_EMAIL": "",
                    "ZULIP_API_KEY": "",
                    "ZULIP_SITE": ""
                }
            }
        }
    }
}

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "zulip chat": {
            "server": {
                "command": "uvx",
                "args": [
                    "zulipchat-mcp"
                ],
                "env": {
                    "ZULIP_EMAIL": "",
                    "ZULIP_API_KEY": "",
                    "ZULIP_SITE": ""
                }
            }
        }
    }
}

McpServers

{
    "server": {
        "command": "uvx",
        "args": [
            "zulipchat-mcp"
        ],
        "env": {
            "ZULIP_EMAIL": "",
            "ZULIP_API_KEY": "",
            "ZULIP_SITE": ""
        }
    }
}

Transport

"stdio"

Package

"zulipchat-mcp"

Registry

"pypi"

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

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

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.

uvx --from zulipchat-mcp zulipchat-mcp-setup

ZulipChat MCP bridges any MCP-compatible AI assistant (Claude Code, Gemini CLI, Cursor, Windsurf, etc.) to your Zulip workspace. The assistant can:

- Send and read messages— stream messages, DMs, replies, reactions
- Search conversation history— full-text search with filters for sender, stream, time range
- Resolve people by name— "message Jaime" just works, no hunting for formal emails
- Switch identities— post as yourself or as a bot, in the same session
- Monitor activity— search recent messages, get stream info, check who's online
- Bind sessions to Zulip topics— give long-running agent sessions a stable control topic
- Request approvals in-topic— owner replies withapprove/denyin the session topic

v0.6.0 introduced a deliberate split:20 core toolsby default,60 toolswhen you need more.

Why 20 instead of 60? Fewer tools means faster tool selection, lower token overhead, and less confusion for the AI. Most tasks — sending messages, searching, reacting, and binding an agent session to Zulip — only need the core set.

Need scheduled messages, event queues, file uploads, analytics, or advanced search?

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

ZULIPCHAT_EXTENDED_TOOLS=1 uvx zulipchat-mcp --zulip-config-file ~/.zuliprc

Extended mode adds:toggle_reaction,cross_post_message,advanced_search,construct_narrow,get_scheduled_messages,manage_scheduled_message,get_drafts,create_draft,edit_draft,delete_draft,register_events,get_events,listen_events,upload_file,manage_files,get_daily_summary,manage_user_mute,get_user,get_presence,get_user_groups, and more.

Full per-client setup guide:docs/integrations/README.md

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

claude mcp add zulipchat -- uvx zulipchat-mcp \ --zulip-config-file ~/.zuliprc \ --zulip-bot-config-file ~/.zuliprc-bot

Optional Claude hook bridge for lifecycle and approval routing:

uvx zulipchat-mcp-hook \ --zulip-config-file ~/.zuliprc \ --zulip-bot-config-file ~/.zuliprc-bot

Optional Claude package export for project-local hooks, skills, and subagents:

uvx zulipchat-mcp-integrate export \ --client claude-code \ --mode standalone \ --output-dir . \ --zulip-config-file ~/.zuliprc \ --zulip-bot-config-file ~/.zuliprc-bot

Add to~/.gemini/settings.jsonundermcpServers:

{ "zulipchat": { "command": "uvx", "args": ["zulipchat-mcp", "--zulip-config-file", "/path/to/.zuliprc"] } }

No reviews yet — be the first

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.

About

Explore

Setting up with Highlight

Claude Desktop / Cursor

McpServers

Transport

Package

Registry

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

More like this

Slack

Inbox Zero

Production-ready MCP integrations for AI applications

whatsapp-mcp