platform-mattermost

Configure a remote Hermes Agent for Mattermost with bot access and allowlists.

13|1|Updated Jun 1, 2026
One-click install
npx skills add https://github.com/paarths-collab/hstack --skill platform-mattermost
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: platform-mattermost
Source: https://github.com/paarths-collab/hstack/tree/main/skills/platform-mattermost
Command: npx skills add https://github.com/paarths-collab/hstack --skill platform-mattermost

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill connects a remote Hermes agent to Mattermost so the bot can receive direct messages, respond reliably, and stay locked down with an explicit allowlist.

Core Features & Use Cases

  • SSH-first setup: Configures the integration directly on the VPS where Hermes is running.
  • Safe access control: Refuses to enable Mattermost until at least one valid allowed user ID is provided.
  • Docker-aware networking: Handles the common self-hosted case where Mattermost and Hermes run in separate containers on the same host.
  • Idempotent and rollback-safe: Detects existing wiring, avoids duplicate changes, and provides rollback paths if verification fails.
  • Use case: A team self-hosts Mattermost on a VPS and wants their Hermes agent to respond only to approved users without exposing the bot to the whole server.

Quick Start

Ask the AI to wire Mattermost to your Hermes agent by gathering the VPS details, bot token, allowlisted user IDs, and any Docker network information, then complete the SSH-based setup safely and idempotently.

Frequently Asked Questions about platform-mattermost

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I connect a remote Hermes agent to a self-hosted Mattermost server?

To connect Mattermost to a Hermes agent, configure bot access, allowlists, and network reachability via SSH on the VPS, providing the server URL, bot token, and valid user IDs for safe integration.

Can I restrict Mattermost bot access to specific approved users only?

Yes, you can restrict bot access using an explicit allowlist of 26-character user IDs, refusing to enable the integration until at least one valid ID is provided.

Does the Mattermost Hermes integration support Docker networking on the same host?

Yes, the integration handles Docker networking for self-hosted setups where Mattermost and Hermes run in separate containers on the same host, ensuring correct proxy or network access.

What do I need to set up Mattermost bot integration with Hermes on a VPS?

You need a valid Mattermost server URL, a bot token, 26-character allowlist user IDs, and correct Docker networking or proxy access to complete the SSH-based setup safely.

How does the Mattermost integration handle configuration changes if verification fails?

The integration applies idempotent and rollback-safe changes, detecting existing wiring, avoiding duplicates, and providing rollback paths if verification fails during setup.