Zulip MCP Server

An MCP server that wraps the Zulip REST API, exposing it as tools over SSE transport. Built with TypeScript and the official MCP SDK.

Available Tools

Tool	Description
get_messages	Fetch messages from Zulip. Supports narrow filters (by stream, topic, sender), anchoring, and pagination via num_before/num_after.
get_message	Fetch a single message by its ID.
get_streams	List channels (streams) visible to the authenticated user.
get_topics	List topics in a channel by its ID.
get_drafts	Retrieve all drafts for the authenticated user.
create_drafts	Create one or more message drafts (stream or private).
edit_draft	Edit an existing draft by ID (type, recipient, topic, content).
delete_draft	Delete a draft by ID.
send_notification	Send a direct message to the configured notification user (ZULIP_NOTIFICATION_USER).

Setup

Prerequisites

• Node.js 22+ or Docker

Configuration

Copy the example env file and fill in your Zulip credentials:

cp .env.example .env

You'll need:

• ZULIP_URL — your Zulip server URL (e.g. https://your-org.zulipchat.com)
• ZULIP_EMAIL — the bot's email address
• ZULIP_API_KEY — the bot's API key (see below)
• ZULIP_NOTIFICATION_USER — email of the user to receive notifications via send_notification

Getting your Zulip API key

1. Log in to your Zulip organization
2. Go to Personal settings > Account & privacy
3. Scroll down to the API key section
4. Click Manage your API key and enter your password to reveal it

Alternatively, if you're using a bot account:

1. Go to Organization settings > Bots
2. Create a new bot or select an existing one
3. The API key is shown on the bot's card — click to copy it

See the Zulip API keys documentation for more details.

Run with Docker (recommended)

docker compose up -d

Run locally

npm install
npm run build
npm start

The server listens on http://localhost:3000/sse.

Claude Code Integration

Add this to your .mcp.json:

{
  "mcpServers": {
    "zulip": {
      "url": "http://localhost:3000/sse"
    }
  }
}