Mattermost MCP Server

Mattermost MCP Server

Local serverstdioGo

What is the Mattermost MCP server?

Most monitoring and observability work still happens through a UI a human drives. Mattermost MCP server moves it into the conversation instead. Mattermost MCP Server.

The short version

MCP Server for the Mattermost API, enabling Claude and other MCP clients to interact with Mattermost workspaces.

The tools it exposes

The server publishes 10 tools. What each one is for:

  • mattermost_list_channels — List channels in the workspace (public, private, and DMs)
  • mattermost_get_channel_history — Get messages from a channel with filtering options
  • mattermost_post_message — Post a new message to a channel
  • mattermost_reply_to_thread — Reply to a specific message thread
  • mattermost_add_reaction — Add an emoji reaction to a message
  • mattermost_get_thread_replies — Get all replies in a thread
  • mattermost_get_users — Get a list of users in the workspace
  • mattermost_get_user_profile — Get detailed profile information for a user
  • mattermost_run_monitoring — Trigger topic monitoring immediately
  • Configuration — The Configuration tool exposed by this server

What it needs from you

Configuration is passed through the environment: MATTERMOST_URL, MATTERMOST_TOKEN, MATTERMOST_TEAM_ID, YOUR_TOKEN. Treat anything key-shaped as a real credential — scope it to the minimum the server needs, and rotate it if it ever lands in a shared config.

Getting it running

The server ships on npm as @donach/mattermost-mcp, so your MCP client can launch it on demand — there is no separate build step. Add the server block to your client's configuration, restart it, and the tools register themselves.

How it compares

This sits in the monitoring and observability group, where several servers overlap in what they claim to do but differ sharply once you actually set them up. Mattermost's toolset — mattermost_list_channels, mattermost_get_channel_history, mattermost_post_message and 7 more — is a fair guide to whether it matches your workflow. It is maintained by donach; worth a glance at recent repository activity before you build anything load-bearing on it.

We check each listing at SyncDev against the project's documentation before it goes live — if something here drifts out of date, it is a bug worth reporting.

Things to watch

  • It runs with your machine's permissions. That is convenient and also the reason to think about what you point it at before you approve a tool call.
  • With 10 tools registered it takes up a noticeable share of the context window; turn it off in projects that never touch Mattermost.
  • Missing credentials fail quietly in some clients — if no tools show up, check the environment block first.
  • Keep per-call confirmation enabled while you learn its behaviour; it is the cheapest safeguard you have.

Available tools

ToolWhat it does
mattermost_list_channelsList channels in the workspace (public, private, and DMs)
mattermost_get_channel_historyGet messages from a channel with filtering options
mattermost_post_messagePost a new message to a channel
mattermost_reply_to_threadReply to a specific message thread
mattermost_add_reactionAdd an emoji reaction to a message
mattermost_get_thread_repliesGet all replies in a thread
mattermost_get_usersGet a list of users in the workspace
mattermost_get_user_profileGet detailed profile information for a user
mattermost_run_monitoringTrigger topic monitoring immediately
ConfigurationThe Configuration tool exposed by this server.

How to install the Mattermost MCP server

Or using a config file:

```json
{
  "mcpServers": {
    "mattermost": {
      "command": "node",
      "args": ["/path/to/mattermost-mcp/build/index.js"]
    }
  }
}

Configuration as documented by the project. Restart the client after saving.

Configuration

VariableDescriptionRequired
MATTERMOST_URLEndpoint or connection string the server talks to.Yes
MATTERMOST_TOKENCredential the server authenticates with.Yes
MATTERMOST_TEAM_IDConfiguration value read at startup.Optional
YOUR_TOKENCredential the server authenticates with.Yes

Example prompts to try

  • Use Mattermost to mattermost list channels.
  • Use Mattermost to mattermost get channel history.
  • Use Mattermost to mattermost post message.

Frequently asked questions

It connects Mattermost to MCP-compatible AI assistants such as Claude and Cursor, exposing 10 tools (mattermost_list_channels, mattermost_get_channel_history, mattermost_post_message, and more) that the assistant can call on your behalf. Instead of copying data back and forth by hand, the assistant works with Mattermost directly.