### Install ZulipMCP and link the Zulip platform plugin Source: https://github.com/zulip/zulipmcp/blob/main/hermes_plugin/zulip/README.md Clones ZulipMCP, installs it into the Hermes virtual environment, links the plugin into the Hermes plugins directory, and enables the platform plugin. ```bash git clone https://github.com/windborne/zulipmcp.git ~/zulipmcp ~/.local/bin/uv pip install \ --python ~/.hermes/hermes-agent/venv/bin/python \ -e ~/zulipmcp mkdir -p ~/.hermes/plugins/platforms ln -s ~/zulipmcp/hermes_plugin/zulip \ ~/.hermes/plugins/platforms/zulip hermes plugins enable zulip-platform ``` -------------------------------- ### Install zulipmcp with uv Source: https://github.com/zulip/zulipmcp/blob/main/README.md Adds the zulipmcp package from the GitHub repository as a dependency using uv. ```bash uv add zulipmcp --git https://github.com/windborne/zulipmcp.git ``` -------------------------------- ### Minimal listener launch Source: https://github.com/zulip/zulipmcp/blob/main/README.md Starts the listener with default settings, using ./.zuliprc, ./.mcp.json (if present), and the bundled default prompt. ```bash uv run python -m zulipmcp.listener ``` -------------------------------- ### Verify Hermes Zulip gateway Source: https://github.com/zulip/zulipmcp/blob/main/hermes_plugin/zulip/README.md Lists plugins, tests the Zulip MCP server, checks gateway status, and runs the gateway. For a background service, run `hermes gateway install` once and `hermes gateway restart` after configuration changes. ```bash hermes plugins list hermes mcp test zulip hermes gateway status hermes gateway run ``` -------------------------------- ### Launch Codex agent directly with zulipmcp.launch_agent Source: https://github.com/zulip/zulipmcp/blob/main/README.md Use this bash command to start one Codex session directly from an existing coordinator. The agent uses its configured zulip MCP server to initialize the target topic, reply there, and wait for follow-ups. It does not watch Zulip or spawn on mentions. ```bash python -m zulipmcp.launch_agent \ --backend codex \ --agent-command /path/to/codex \ --stream engineering \ --topic "large coding task" \ --working-dir /path/to/project ``` -------------------------------- ### Import zulipmcp and use get_messages, send_message, configure Source: https://github.com/zulip/zulipmcp/blob/main/README.md Use this Python snippet to interact with Zulip programmatically. It fetches and formats recent messages, sends a message, and configures MCP hooks before starting the server. The configure call sets a message prefix and a session-end callback. ```python import zulipmcp # Fetch and format recent messages messages = zulipmcp.get_messages(hours_back=24, channels=["engineering"]) print(zulipmcp.format_messages(messages)) # Send a message zulipmcp.send_message("engineering", "general", "Hello from Python!") # Configure MCP hooks before starting the server zulipmcp.configure( message_prefix=lambda: "[bot] ", on_session_end=lambda session: print(f"Session ended in #{session.stream}"), ) ``` -------------------------------- ### Launch Claude Code agent directly with zulipmcp.launch_agent Source: https://github.com/zulip/zulipmcp/blob/main/README.md Use this bash command to start one Claude Code session directly from an existing coordinator. The agent uses its configured zulip MCP server to initialize the target topic, reply there, and wait for follow-ups. It does not watch Zulip or spawn on mentions. ```bash python -m zulipmcp.launch_agent \ --backend claude \ --agent-command /path/to/claude \ --stream engineering \ --topic "large coding task" \ --working-dir /path/to/project ``` -------------------------------- ### Recommended: OpenCode with any provider (Qwen, Llama, Gemini, etc.) Source: https://github.com/zulip/zulipmcp/blob/main/README.md Launches the listener with OpenCode backend and a specific model in provider/model format. ```bash uv run python -m zulipmcp.listener --backend opencode \ --opencode-model anthropic/claude-sonnet-4-5 ``` -------------------------------- ### OpenCode with Ollama Qwen model Source: https://github.com/zulip/zulipmcp/blob/main/README.md Launches the listener with OpenCode backend and an Ollama-hosted Qwen model. ```bash uv run python -m zulipmcp.listener --backend opencode \ --opencode-model ollama/qwen3:235b ``` -------------------------------- ### Recommended: Codex with GPT-5.5 and medium reasoning Source: https://github.com/zulip/zulipmcp/blob/main/README.md Launches the listener with Codex backend, specifying model and reasoning effort. ```bash uv run python -m zulipmcp.listener --backend codex -- \ --model gpt-5.5 \ -c 'model_reasoning_effort="medium"' ``` -------------------------------- ### Full listener launch with overrides Source: https://github.com/zulip/zulipmcp/blob/main/README.md Launches the listener with custom MCP config, system prompt, and log directory. ```bash uv run python -m zulipmcp.listener \ --mcp-config .mcp.json \ --system-prompt agent.md \ --log-dir ./logs ``` -------------------------------- ### Recommended: Claude Code with Opus 4.6 Source: https://github.com/zulip/zulipmcp/blob/main/README.md Launches the listener with Claude Code backend and the claude-opus-4-6 model. ```bash uv run python -m zulipmcp.listener -- --model claude-opus-4-6 ``` -------------------------------- ### Pass additional backend-specific flags after -- Source: https://github.com/zulip/zulipmcp/blob/main/README.md Shows how to forward extra flags to the backend after the -- separator. ```bash uv run python -m zulipmcp.listener -- --strict-mcp-config --effort medium ``` ```bash uv run python -m zulipmcp.listener --backend codex -- -c 'model_verbosity="low"' ``` ```bash uv run python -m zulipmcp.listener --backend opencode -- --verbose ``` -------------------------------- ### Configure MCP server in .mcp.json Source: https://github.com/zulip/zulipmcp/blob/main/README.md Defines the zulip MCP server configuration for MCP clients, using uv to run the zulipmcp module. ```json { "mcpServers": { "zulip": { "command": "uv", "args": ["run", "python", "-m", "zulipmcp.mcp"] } } } ``` -------------------------------- ### Configure Zulip bot and user allowlist in .env Source: https://github.com/zulip/zulipmcp/blob/main/hermes_plugin/zulip/README.md Sets the Zulip RC path and an explicit user allowlist. The adapter fails closed unless ZULIP_ALLOWED_USERS is set or ZULIP_ALLOW_ALL_USERS=true is explicitly enabled. ```dotenv ZULIP_RC_PATH=/home/you/.hermes/zulip-bot.zuliprc ZULIP_ALLOWED_USERS=12345,you@example.com ``` -------------------------------- ### Add ZulipMCP to Hermes config.yaml Source: https://github.com/zulip/zulipmcp/blob/main/hermes_plugin/zulip/README.md Registers ZulipMCP as an MCP server, excluding lifecycle tools owned by the gateway, and adds the zulip platform toolset. Replace __ALL__ with comma-separated stream names to narrow the MCP tool policy. ```yaml mcp_servers: zulip: command: /home/you/.hermes/hermes-agent/venv/bin/python args: ["-m", "zulipmcp.mcp"] env: ZULIP_RC_PATH: ${ZULIP_RC_PATH} BOT_ALLOWED_PRIVATE_STREAMS: "__ALL__" BOT_ALLOWED_WRITE_STREAMS: "__ALL__" tools: exclude: - set_context - reply - listen - end_session - typing - stop_typing resources: false prompts: false platform_toolsets: zulip: - hermes-cli - mcp-zulip ``` === COMPLETE CONTENT === This response contains all available snippets from this library. No additional content exists. Do not make further requests.