Mattermost Mcp

Name: Mattermost Mcp
Author: conarti

@conarti

About Mattermost Mcp

MCP Server for Mattermost API. Enables Claude and other MCP clients to interact with Mattermost workspaces - list channels, read/post messages, manage threads, reactions, and monitor topics. Supports flexible configuration via CLI args, environment variables, or config files.

#mattermost #chat #messaging #slack-alternative #team-communication #channels

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "mattermost": {
      "command": "npx",
      "args": [
        "-y",
        "@conarti/mattermost-mcp"
      ],
      "env": {
        "MATTERMOST_URL": "https://your-mattermost.com/api/v4",
        "MATTERMOST_TOKEN": "your-token",
        "MATTERMOST_TEAM_ID": "your-team-id"
      }
    }
  }
}

Tools

List channels in the Mattermost workspace. By default lists public team channels. Set include_private=true to get all channels including private channels and direct messages (DMs).

Get messages from a Mattermost channel. By default returns ALL messages. Use limit parameter to restrict the number of messages.

Post a new message to a Mattermost channel

Reply to a specific message thread in Mattermost

Add a reaction emoji to a message

Get all replies in a message thread

Get a list of users in the Mattermost workspace with pagination

Get detailed profile information for a specific user

Run the topic monitoring process immediately

Overview

What is Mattermost Mcp?

Mattermost Mcp is a Model Context Protocol server that enables Claude and other MCP clients to interact with Mattermost workspaces via the Mattermost API. It provides tools for reading and writing messages, managing channels, and monitoring topics.

How to use Mattermost Mcp?

Run it with npx @conarti/mattermost-mcp and provide the Mattermost URL, a personal access token, and the team ID via CLI arguments, environment variables, or a config file. Integrate with Claude Code by adding the server to the MCP settings in ~/.claude/claude_desktop_config.json.

Key features of Mattermost Mcp

List public channels in the workspace
Retrieve channel messages with filtering and pagination
Post messages and reply to threads
Add emoji reactions to messages
Get workspace users and user profiles
Monitor channels for topics of interest on a schedule

Use cases of Mattermost Mcp

Allow an AI assistant to read conversations and post updates in Mattermost channels
Automatically scan specified channels for keywords (e.g., “urgent”, “bug”) and trigger notifications
Fetch and summarize recent discussions for daily standups or reports
Manage team communication by posting status updates from automated workflows

FAQ from Mattermost Mcp

What credentials are required?

You need the Mattermost API URL (typically https://your-mattermost-domain.com/api/v4), a personal access token, and the team ID. All three are mandatory.

How do I generate a personal access token?

In Mattermost, go to Account Settings → Security → Personal Access Tokens, create a new token, and copy it immediately (it will not be shown again).

How do I find my team ID?

Open your browser’s developer tools, refresh the page, and look for API calls containing teams/ – the ID is in the URL. Alternatively, use curl -H "Authorization: Bearer YOUR_TOKEN" https://your-mattermost.com/api/v4/teams.

What configuration methods are supported?

Configuration can be provided via CLI arguments (highest priority), environment variables (MATTERMOST_URL, MATTERMOST_TOKEN, MATTERMOST_TEAM_ID), a local config.local.json (gitignored), or the default config.json.

Can I run topic monitoring as a one-off job?

Yes, use the --run-monitoring flag to trigger monitoring immediately on startup, and optionally --exit-after-monitoring to exit after the run (useful for cron jobs).