| name: mattermost-platform |
| label: Mattermost |
| kind: platform |
| version: 1.0.0 |
| description: > |
| Mattermost gateway adapter for Hermes Agent. |
| Connects to a self-hosted or cloud Mattermost instance via the v4 REST |
| API + WebSocket event stream and relays messages between Mattermost |
| channels/DMs and the Hermes agent. Supports thread-mode replies, native |
| file uploads, channel-scoped allowlists, and home-channel cron delivery. |
| author: NousResearch |
| requires_env: |
| - name: MATTERMOST_URL |
| description: "Mattermost server URL (e.g. https://mm.example.com)" |
| prompt: "Mattermost server URL" |
| password: false |
| - name: MATTERMOST_TOKEN |
| description: "Bot account token or personal-access token" |
| prompt: "Mattermost bot token" |
| password: true |
| optional_env: |
| - name: MATTERMOST_ALLOWED_USERS |
| description: "Comma-separated Mattermost user IDs allowed to talk to the bot" |
| prompt: "Allowed users (comma-separated)" |
| password: false |
| - name: MATTERMOST_ALLOW_ALL_USERS |
| description: "Allow any Mattermost user to trigger the bot (dev only)" |
| prompt: "Allow all users? (true/false)" |
| password: false |
| - name: MATTERMOST_HOME_CHANNEL |
| description: "Default channel ID for cron / notification delivery" |
| prompt: "Home channel ID" |
| password: false |
| - name: MATTERMOST_REPLY_MODE |
| description: "How replies are sent: 'thread' (nested) or 'off' (flat). Default: off." |
| prompt: "Reply mode (thread|off)" |
| password: false |
| - name: MATTERMOST_REQUIRE_MENTION |
| description: "Require @bot mention in channels (default true). Set false for free-response everywhere." |
| prompt: "Require @mention? (true/false)" |
| password: false |
| - name: MATTERMOST_FREE_RESPONSE_CHANNELS |
| description: "Comma-separated channel IDs where @mention is not required." |
| prompt: "Free-response channel IDs (comma-separated)" |
| password: false |
| - name: MATTERMOST_ALLOWED_CHANNELS |
| description: "If set, the bot only responds in these channels (whitelist)." |
| prompt: "Allowed channel IDs (comma-separated)" |
| password: false |
|
|
