Zulip MCP Server

MCP Server for the Zulip API, enabling AI assistants like Claude to interact with Zulip workspaces.

Tools

1. `zulip_list_channels`

2. `zulip_post_message`

3. `zulip_send_direct_message`

4. `zulip_add_reaction`

5. `zulip_get_channel_history`

6. `zulip_get_topics`

7. `zulip_subscribe_to_channel`

8. `zulip_get_users`

Setup

1. Create a Zulip Bot:

2. Permissions:

3. Get the API credentials:

Usage with Claude Desktop

Add the following to your `claude_desktop_config.json`:

npx

{
  "mcpServers": {
    "zulip": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-zulip"
      ],
      "env": {
        "ZULIP_EMAIL": "your-bot@example.zulipchat.com",
        "ZULIP_API_KEY": "your-bot-api-key",
        "ZULIP_URL": "https://example.zulipchat.com"
      }
    }
  }
}

docker

{
  "mcpServers": {
    "zulip": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "ZULIP_EMAIL",
        "-e",
        "ZULIP_API_KEY",
        "-e",
        "ZULIP_URL",
        "mcp/zulip"
      ],
      "env": {
        "ZULIP_EMAIL": "your-bot@example.zulipchat.com",
        "ZULIP_API_KEY": "your-bot-api-key",
        "ZULIP_URL": "https://example.zulipchat.com"
      }
    }
  }
}

Troubleshooting

If you encounter permission errors, verify that:

1. The bot API key is correct

2. The bot has been subscribed to the channels it needs to access

3. The Zulip URL is correct and accessible

Build

Docker build:

docker build -t mcp/zulip .

License

Copyright 2025 Monadical

Licensed under the Apache License, Version 2.0 (the "License");

you may not use this file except in compliance with the License.

You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software

distributed under the License is distributed on an "AS IS" BASIS,

WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.

See the License for the specific language governing permissions and

limitations under the License.

This product includes third-party software components. See the LICENSE and NOTICE files for details.