Your Mattermost, within your agent's reach¶
mm-mcp is an MCP server for Mattermost. It lets an AI agent read and search your Mattermost, and, when you allow it, post and reply, as you or as a bot, or draft a post for you to check and send yourself. Each post states how far it goes, and mm-mcp checks that before it is sent.
The 2.4 notes are ready, Sam. The changelog is in the release doc.
What it is for¶
-
Reading and searching
Channels, threads, unread messages and mentions, and people and channels looked up by the names you use.
-
Posting and replying
Posts, replies, edits, reactions and pins, joining and creating channels, and your status, once you allow writes, each approved by your AI app and checked by mm-mcp before it is sent.
-
Your own things
Following threads, saved posts, reminders, proposed posts, the typing indicator and marking a channel read, which change only what is yours.
-
Files and attachments
Read as text or images the model can use, uploaded, and saved to your machine.
Views in the chat: in an AI app that shows them, a thread, what you missed, or a post your agent made appears as Mattermost shows it, and a post it drafts appears as it will be posted, for you to post, change or discard. See them live.
How it behaves¶
-
Read-only unless you say otherwise
The tools that post or change anything are not even offered until you allow writes. Then your AI app's own approval of each call decides, and mm-mcp checks what each change states before it goes out: how many people a post reaches and notifies, the text an edit replaces, what a deletion takes away, and where it goes. Each post is marked as written with AI, unless you turn that off (Configuration).
-
One account, yours or a bot's
It acts as whoever owns the token it is given: a personal access token, a bot's token, or your own login through
mm-mcp login, single sign-on included. It can do what that account can, and no more. -
On your own machine
Your AI app starts mm-mcp on your computer and talks to it directly. Nothing is hosted, and mm-mcp talks to nothing but your Mattermost (Security).
-
Tested against a real Mattermost
Every tool is exercised against Team Edition, on the current Extended Support Release and the newest release (Supported releases).
What it does well¶
- Nothing to install on the server. mm-mcp talks to Mattermost's API as its own apps do, so it needs no plugin, and works with the free Team Edition too.
- States what each post does. A post names where it goes by its address,
and how many people it reaches and an
@channelnotifies; an edit writes out the whole text it replaces. mm-mcp checks each against Mattermost before it acts, and a refusal says what it found. - Answers shaped for an agent. A post comes with its author, channel, team, files and reactions; channels, teams and people are found by the names you use, and a name that matches nothing comes back with the closest ones.
- Reads as Mattermost does. Unread posts from where you stopped, without marking them read; mentions as your notification settings define them; threads as its threads view lists them.
- Reads your files. Word, PowerPoint and Excel as their text, archives as a listing, images upright and scaled, and text in windows of numbered lines.
- Logs in where tokens are off. Through your own browser, single sign-on and second factor included (Logging in).
Why it works the way it does, one decision at a time, is in the decision records.
mm-mcp is an independent project. It is not affiliated with, endorsed by or supported by Mattermost, Inc.; Mattermost is a trademark of Mattermost, Inc.