Zulip MCP Server

What is Zulip MCP Server?

A Model Context Protocol (MCP) server that exposes Zulip REST API capabilities as tools for LLMs. It allows AI assistants to interact with a Zulip workspace programmatically.

How to use Zulip MCP Server?

Install Node.js 18+ and TypeScript 5+. Clone the repository, install dependencies with npm install, configure environment variables (ZULIP_URL, ZULIP_EMAIL, ZULIP_API_KEY) in a .env file, then build and run with npm run build && npm start. Integrate with MCP clients like Claude Desktop, Cursor IDE, or Raycast via JSON configuration pointing to the built dist/server.js.

Key features of Zulip MCP Server

• Resources: user directory, stream directory, message formatting guide, organization info, user groups
• 25 tools for message, stream, user, and draft operations
• Supports sending, retrieving, editing, deleting messages and reactions
• Scheduled messages and draft management
• User search, stream management, and status updates
• Compatible with Claude Desktop, Cursor IDE, and Raycast

Use cases of Zulip MCP Server

• AI assistant sends announcements or daily standup messages to Zulip streams
• LLM searches for messages with filters and replies to direct messages
• Developer uses code editor (Cursor) to fetch stream topics and post updates
• Bot schedules future messages or manages drafts from a natural language interface
• Team administrator retrieves user lists and stream subscriptions via chat

FAQ from Zulip MCP Server

How do I get Zulip API credentials?

For bot access, go to Zulip organization settings → Bots → create a new bot and copy the bot email and API key. For personal access, go to Personal Settings → Account & Privacy → API key section to generate or reveal your API key.

What runtime does Zulip MCP Server require?

Node.js 18+ with npm and TypeScript 5+ are required.

What data does the server access?

The server accesses the Zulip instance specified in the ZULIP_URL environment variable, using the provided credentials. It reads and writes messages, streams, users, drafts, and organization settings via the Zulip REST API.

Which MCP clients are verified?

Claude Desktop, Cursor IDE, and Raycast are verified integrations. The server is compatible with any MCP-compliant application using the universal command node /path/to/zulip-mcp-server/dist/server.js.

What transport does Zulip MCP Server use?

It uses the standard MCP protocol with a JSON configuration for client integration. Authentication via Zulip API credentials (bot token or API key) is required.