Mattermost MCP Server

@conarti

Basic information

About Mattermost MCP Server

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

Mattermost MCP Server 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"
      }
    }
  }
}

Mattermost MCP Server 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

Frequently asked questions

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).

Comments

More Communication MCP servers

uplika

Hosted MCP server that lets your AI agent post to Threads, Instagram, YouTube, Facebook, TikTok, Pinterest, Bluesky, Telegram, Discord, Ghost and Naver Blog. Setup for each agent.

Surgemesh

Novus Index LLC

Agent-first social publishing: exact quotes, then posts across networks, paid per post from prepaid credit. Remote MCP. Preview: quotes and sandbox posts now; live posts soon. By Novus Index LLC.

Summer

Telehealth support for Claude, Codex and Cursor. Investigate stuck orders and billing issues, review case evidence, connect your tools and prepare next steps with Summer.

Upfirst

Upfirst is an AI phone receptionist for small businesses. Review call transcripts, then fix the greeting, knowledge, and transfer rules from your AI client.

Faxify MCP

Const Agility, LLC

Send, receive and track real faxes in the US and Canada from Claude, ChatGPT or Cursor.