mattermost-cli

Original：🇺🇸 English
Translated

This skill should be used when the user asks to "check my mattermost messages", "fetch DMs", "what did X say", "check messages from coworker", "read mattermost", "search mattermost for X", "check my mentions", "any unread messages", "watch a channel", "monitor chat", "what's new on mattermost", "find messages about X", "check channel history", "follow up on that mattermost thread", or mentions mattermost conversations, chat history, unread messages, or finding tasks mentioned in chat. Also use when the user needs context from team communication, wants to find action items from conversations, or needs to monitor a channel for updates in real-time.

11installs
Sourceardasevinc/mattermost-cli
Added on

NPX Install

npx skill4agent add ardasevinc/mattermost-cli mattermost-cli

Tags

Translated version includes tags in frontmatter
mattermost-clichat-monitoringmessage-retrievalteam-communicationtask-extraction

SKILL.md Content

View Translation Comparison →

Mattermost CLI

Read-only CLI for fetching Mattermost messages. Output is automatically redacted for safe LLM processing.

When to Invoke Immediately

Trigger this skill when the user:
  • Asks to check/read/fetch Mattermost messages, DMs, or channels
  • Wants to see what someone said ("what did alice say about X")
  • Needs to find tasks or action items from chat
  • Asks to search for something in Mattermost
  • Wants to check their mentions or unread messages
  • Needs to monitor a channel or DM in real-time
  • References a conversation or thread from Mattermost

When to Suggest (Don't Auto-Invoke)

Offer to use this skill when:
  • User mentions a task "from chat" without specifying Mattermost
  • User is looking for context that might be in messages
  • You need message history to understand a task better
  • User seems unaware of recent team discussions that might be relevant
Say: "want me to check your Mattermost messages for context?" — don't auto-invoke.

Prerequisites

The 
mm
CLI must be installed and configured:
bash
mm channels  # test if working
If it fails, configure credentials using one of:
  1. Config file: 
    mm config --init
    then edit 
    ~/.config/mattermost-cli/config.toml
  2. Environment variables: 
    MM_URL
    and 
    MM_TOKEN
  3. CLI flags: 
    --url
    and 
    --token

Commands

List Channels

bash
mm channels                  # all channels, sorted by last activity
mm channels --type dm        # DMs only
mm channels --type public    # public channels only
mm channels --type private   # private channels only
mm channels --type group     # group channels only

Fetch Direct Messages

bash
mm dms                             # all DMs, last 7 days
mm dms -u <username>               # from specific user
mm dms -u alice -u bob             # multiple users
mm dms --since 24h                 # last 24 hours
mm dms --since 30d --limit 100     # more history
mm dms -c <channel-id>             # specific DM channel by ID
mm dms --limit
is a total output cap across all matched DM channels.

Fetch Channel Messages

bash
mm channel general                 # last 7 days from #general
mm channel dev-ops --team myteam   # specify team if multi-team
mm channel general --since 24h     # last 24 hours
mm channel general --limit 200     # more messages

Search Messages

bash
mm search "deployment"                    # search across all channels
mm search "from:alice bug"                # Mattermost search syntax
mm search "in:general after:2026-01-01"   # channel + date filters
mm search "deployment" --team myteam      # scope to team
mm search "deployment" --limit 20         # limit results

Check Mentions

bash
mm mentions                        # messages mentioning you
mm mentions --since 24h            # recent mentions
mm mentions --channel general      # mentions in specific channel
mm mentions --team myteam          # scope to team
Mention detection uses your username plus any aliases configured in 
mention_names
in the config file.

Unread Summary

bash
mm unread                          # list channels with unread counts
mm unread --peek 5                 # also fetch 5 messages per unread channel
mm unread --team myteam            # scope to team
Channels are sorted by mentions first, then by unread count.

Watch (Real-Time)

bash
mm watch general                   # live-stream channel messages
mm watch general --team myteam     # specify team
mm watch --dm alice                # live-stream DMs with a user
WebSocket-based, streams new messages as they arrive. Ctrl+C to stop.

Fetch a Thread

bash
mm thread <postId>                 # fetch root post + all replies

Manage Configuration

bash
mm config                # show config status
mm config --init         # create config file template
mm config --path         # print config file path

Quick Reference

TaskCommand
Recent DMs
mm dms --since 24h
DMs from specific person
mm dms -u alice
All channels list
mm channels
Channel history
mm channel general --since 7d
Search messages
mm search "deployment issue"
Check mentions
mm mentions --since 24h
Unread summary
mm unread
Unread with preview
mm unread --peek 5
Watch channel live
mm watch general
Watch DM live
mm watch --dm alice
Specific thread
mm thread <postId>
JSON for processing
mm dms --json
Setup config
mm config --init

Global Options

These apply to all commands:
FlagEffect
--json
JSON output (default: pretty terminal)
--no-color
Disable ANSI colors
-r, --relative
Relative timestamps ("2 days ago")
--no-relative
Absolute timestamps
--redact
Enable secret redaction (default)
--no-redact
Disable secret redaction
--threads
Show thread structure (default)
--no-threads
Flatten thread replies

Output Formats

ContextFormatUse Case
Terminal (TTY)PrettyReading directly — colors, grouping, thread indentation
Piped / non-TTYMarkdownPassing to other tools or LLMs
--json
flag		JSONParsing, analysis, programmatic access
Under AI agents, relative time is auto-enabled ("2 days ago" instead of "29 Jan 2026"). Override with 
--no-relative
.

Security

All secrets are automatically redacted before output:
  • API keys and tokens (AWS, GitHub, GitLab, Slack, OpenAI, Anthropic, Stripe, etc.)
  • JWTs and Bearer/Basic auth headers
  • Connection strings (postgres://, mongodb://)
  • Private keys, passwords, credentials in config snippets
Masking preserves context: 
ghp_abc123xyz789secret
→ 
ghp_...cret
Output is safe to include in context or pass to other LLMs. Disable with 
--no-redact
if needed.

Configuration

Credentials resolve in this order (first wins):
  1. CLI flags (
    --url
    , 
    --token
    )
  2. Environment variables (
    MM_URL
    , 
    MM_TOKEN
    )
  3. Config file (
    ~/.config/mattermost-cli/config.toml
    )
Config file format:
toml
url = "https://mattermost.example.com"
token = "your-personal-access-token"
redact = true
mention_names = ["Arda", "arda.sevinc"]  # aliases for mm mentions

Error Handling

ErrorCauseSolution
"Mattermost URL required"Not configured
mm config --init
or set 
MM_URL
"Mattermost token required"Not configuredEdit config or set 
MM_TOKEN
"Could not find DM channel"User doesn't exist or no DM historyCheck username spelling
"Could not find channel"Channel name wrong or no accessVerify name and team
"Multiple teams found"Multi-team user without 
--team
Add 
--team <name>
Connection errorsNetwork/server issuesVerify URL is correct and accessible
WebSocket auth failureInvalid token for watch modeRegenerate access token

When NOT to Use

  • User is asking about Slack, Discord, or other chat platforms
  • User wants to send messages (this tool is read-only)
  • User needs webhook or bot integrations

Example Workflows

"What did Alice say about the deployment?"

bash
mm dms -u alice --since 7d
Scan output for deployment-related content.

"Check my recent messages for any tasks"

bash
mm dms --since 24h
Review output for action items, requests, or TODOs.

"Any mentions I missed?"

bash
mm mentions --since 24h
Catch up on messages that tagged you.

"What's happening in the dev channel?"

bash
mm channel dev --since 24h
Or for ongoing monitoring:
bash
mm watch dev

"Find that discussion about the API migration"

bash
mm search "API migration"

"Quick catch-up on everything unread"

bash
mm unread --peek 3
Shows unread channels with mention counts and previews 3 messages from each.

"Get full context from a thread someone linked"

bash
mm thread abc123def456