mattermost

Reads, summarizes, and sends Mattermost messages via the REST API.

7|Updated Apr 30, 2026
One-click install
npx skills add https://github.com/rascheel/scheel-skills --skill mattermost-rascheel
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: mattermost
Source: https://github.com/rascheel/scheel-skills/tree/main/mattermost
Command: npx skills add https://github.com/rascheel/scheel-skills --skill mattermost-rascheel

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Keeping up with Mattermost channels means manually checking unread messages across teams and channels. This Skill automates reading unread messages, summarizing conversations by topic, sending messages, and marking channels as read through the Mattermost REST API. ## Core Features & Use Cases - Unread Detection & Summaries: Computes unread counts per channel using total_msg_count versus member msg_count, then summarizes recent posts by topic, participants, and status. - Messaging & Channel Management: Sends messages, searches channels, resolves user profiles in bulk, and marks channels as read with the verified /channels/members/{user_id}/view endpoint. - Preference-Aware Prioritization: Uses a stored user_preferences.json to prioritize interested channels and de-emphasize noisy ones in summaries. - Use Case: Ask for a morning digest of unread Mattermost activity; the Skill validates your token, finds unread channels, fetches recent posts, and returns a prioritized topic summary. ## Quick Start Check my Mattermost for unread messages and give me a summary of the most important conversations.

Frequently Asked Questions about mattermost

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

FAQPage Schema
How do I check unread Mattermost messages from the command line?

Fetch channel members and channels for your team, then compute unread as channel.total_msg_count minus member.msg_count per channel. This Skill automates that flow using the Mattermost REST API with your personal access token.

How do I send a message to a Mattermost channel via API?

Send a POST request to /api/v4/posts with a JSON body containing channel_id and message, authenticated with an Authorization: Bearer token header. The Skill handles authentication and channel ID lookup for you.

How do I authenticate with the Mattermost REST API?

Create a personal access token under Profile, Security, Personal Access Tokens, then store the server URL and token in ~/.config/mattermost-skill/config. Validate with GET /api/v4/users/me, which returns HTTP 200 for valid tokens.

Why does marking Mattermost messages as read return 404?

Several documented mark-as-read endpoints return 404 on some server versions, including 10.11.6. The working endpoint is POST /api/v4/channels/members/{user_id}/view with a channel_id body, which this Skill uses.

Can Mattermost summaries prioritize specific channels?

Yes. The Skill stores interested and not_interested channel lists in ~/.config/mattermost-skill/user_preferences.json and matches them against channel display names, prioritizing preferred channels and omitting de-emphasized ones.