zulip-mcp-server

avisekrath/zulip-mcp-server

3.3

If you are the rightful owner of zulip-mcp-server and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

The Zulip MCP Server is a Model Context Protocol server that provides AI assistants with programmatic access to Zulip's REST API, enabling interaction with Zulip workspaces.

The Zulip MCP Server is designed to bridge the gap between AI assistants and Zulip workspaces by exposing Zulip's REST API capabilities as tools for LLMs. This server allows AI systems to perform a variety of operations within a Zulip environment, such as sending messages, managing streams, and interacting with users. By leveraging the Model Context Protocol, the server ensures seamless integration with various MCP-compliant clients, enhancing productivity and communication within organizations. The server supports a wide range of features, including message operations, user management, and stream management, making it a versatile tool for automating and streamlining tasks in a Zulip workspace. With comprehensive error handling and support for markdown formatting, the Zulip MCP Server is a robust solution for integrating AI capabilities into your communication workflows.

Features

  • User Directory: Browse organization members with roles and status.
  • Stream Directory: Explore available streams and permissions.
  • Message Formatting Guide: Complete Zulip markdown syntax reference.
  • Organization Info: Server settings, policies, and custom emoji.
  • User Groups: Available groups for mentions and permissions.

Usages

usage with claude desktop env

{
  "mcpServers": {
    "zulip": {
      "command": "node",
      "args": ["/path/to/zulip-mcp-server/dist/server.js"],
      "env": {
        "ZULIP_URL": "https://your-organization.zulipchat.com",
        "ZULIP_EMAIL": "your-bot-email@yourcompany.com",
        "ZULIP_API_KEY": "your-api-key-here"
      }
    }
  }
}

usage with claude desktop env file

{
  "mcpServers": {
    "zulip": {
      "command": "node",
      "args": ["/path/to/zulip-mcp-server/dist/server.js"],
      "cwd": "/path/to/zulip-mcp-server"
    }
  }
}

usage with cursor

{
  "mcpServers": {
    "zulip": {
      "command": "node",
      "args": ["/path/to/zulip-mcp-server/dist/server.js"],
      "env": {
        "ZULIP_URL": "https://your-organization.zulipchat.com",
        "ZULIP_EMAIL": "your-bot-email@yourcompany.com",
        "ZULIP_API_KEY": "your-api-key-here"
      },
      "capabilities": {
        "tools": true,
        "resources": true
      }
    }
  }
}

usage with raycast

{
  "servers": {
    "zulip": {
      "name": "Zulip Integration",
      "description": "Send messages and interact with Zulip workspace",
      "command": "node",
      "args": ["/path/to/zulip-mcp-server/dist/server.js"],
      "env": {
        "ZULIP_URL": "https://your-organization.zulipchat.com",
        "ZULIP_EMAIL": "your-bot-email@yourcompany.com",
        "ZULIP_API_KEY": "your-api-key-here"
      },
      "icon": "💬",
      "categories": ["communication", "productivity"]
    }
  }
}

Tools

  1. search-users

    Find users by name/email before sending DMs.

  2. send-message

    Send to streams or direct messages.

  3. get-messages

    Retrieve with advanced filtering and search.

  4. upload-file

    Share files and images.

  5. edit-message

    Modify content or move topics.