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

Related MCP server: mcp_sdk_eyra_accelerator

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"
    }
  }
}