SkillFoxx

mcp-server-mattermost

A Mattermost MCP server: an agent reads, searches and posts messages, threads and files in your workspace, with 39 tools.

  • 53 ★ on the repository
  • Last commit
MCP serverOfficial

Broad access

Why this level

  • The agent reads conversations and can write, edit and delete messages as the token owner.
  • The bot token grants access to workspace channels and files.
All reasons and checks
Russian stack

cloud-ru-tech/mcp-server-mattermostAuthor:Cloud.ru

Install

In your terminal, with SkillFoxx CLI

npx skillfoxx add mcp/mcp-server-mattermost

Detects the agents on your machine, shows the access level and pins the version.

Other ways to install

Access and checks

How we review

Broad accessThe tool can change data, run commands or handle secrets.

  • The agent reads conversations and can write, edit and delete messages as the token owner.
  • The bot token grants access to workspace channels and files.

This is third-party code. Review the repository files before installing.

What it does

mcp-server-mattermost gives an AI assistant access to a Mattermost workspace. Its tools cover channels (listing, creating, joining, direct messages), messages (send, search, edit, delete, attachments), reactions and threads with pins, users and teams, files and bookmarks in the Entry edition and above. There are 39 tools in all. Example requests: list channels and find where a release is being discussed, show what you missed since yesterday morning and summarize threads you were mentioned in, post a build alert with a colored attachment, find messages about an incident and sum them up. The server runs through `uvx mcp-server-mattermost` or Docker and accepts a bot or personal token.

Who it is for. Teams on Mattermost who want to read channels, search conversations and post messages through Claude Code, Cursor or other MCP clients.

Good fit when

  • In the morning you want a recap of unread channels and threads with mentions.
  • A bot posts a build status alert to a channel with a colored attachment.
  • Messages about an incident from last week are searched and decisions summarized.
  • A report is uploaded to a shared channel along with a file link.

Not a fit when

  • The workspace is not on Mattermost.
  • Policy forbids giving an agent access to conversations.
  • You only want manual posting with no automatic sending.

Example request

Show my unread channels from yesterday, summarize threads where I was mentioned and send nothing without confirmation.

MCP

Transport
stdio
Authentication
API key

Environment variables

MATTERMOST_URL required
Mattermost server URL.
MATTERMOST_TOKEN required, secret
Bot or personal token for static_token mode.

Limitations

You need a Mattermost bot or personal token and the server address in `MATTERMOST_URL`. There are three auth modes: `static_token`, `client_token` and `oauth_proxy`. The agent can write, edit and delete messages with the token permissions, so give the token minimal rights and a dedicated bot account. Bookmarks are available only in the Entry edition and above. Channel content reaches the model context, so account for private discussions.

How to disable. Remove the `mattermost` entry from the MCP client configuration and revoke the bot token in Mattermost.

FAQ

How do I connect the server?

Get a Mattermost bot token, add a `uvx` command with the `mcp-server-mattermost` argument and the `MATTERMOST_URL` and `MATTERMOST_TOKEN` variables to the MCP config, then restart the client.

Which auth modes exist?

`static_token` by default, `client_token` and `oauth_proxy`. The `MATTERMOST_AUTH_MODE` variable sets the mode.

How many tools are there?

Thirty nine, covering channels, messages, reactions, threads, users, files and bookmarks.

Is there a Docker image?

Yes, `legard/mcp-server-mattermost` is published on Docker Hub. A PyPI package exists too.

Where is the full guide?

In the Read the Docs documentation, quickstart section: Claude Desktop, Cursor, Claude Code, Opencode, Docker and pip.

Discussion

No questions or reviews yet.

MCP servers

An MCP server for Slack: channel history, threads, DMs, search and unreads, with posting off by default

MCP serverBroad access1.9K
Official

The official Kibela MCP server searches, reads and edits notes, folders and comments of your wiki straight from an assistant chat

MCP serverExtended access16
Official

MWS TeamStream's official MCP: an agent finds recordings by meaning and reads transcripts and summaries right from AI tools

MCP serverExtended access

A local MCP server that lets the agent ask you questions in the console and notify you when a task is done

MCP serverExtended access351

MCP Teams Server

mcp-teams-server

An MCP server for Microsoft Teams: reading channel messages, creating threads with mentions and replying. The code is open by Inditex and runs in Docker

MCP serverExtended access469

An MCP server for Redmine: issues, projects, wikis, time tracking and files, a read-only mode and per-user OAuth2 sign-in

MCP serverBroad access92

README in short

The README lists features, example queries, tool tables by group and environment variables. The full guide lives in the documentation.

README badge

Report a problem