Skip to content
Back to search

mattermost-mcp

An MCP server for mattermost written in Go

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/hosseinmirzapur--mattermost-mcp/badge.svg)](/listings/hosseinmirzapur--mattermost-mcp)

HTML

<a href="/listings/hosseinmirzapur--mattermost-mcp"><img src="/api/listings/hosseinmirzapur--mattermost-mcp/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 49 lines
  1. # mattermost-mcp
  2. Read-only MCP server for a self-hosted Mattermost. Lets an AI agent read channels, teams and search results using your own session token. It has no write tools.
  3. ## Tools
  4. | Tool | Purpose |
  5. | --- | --- |
  6. | `get_me` | Logged-in user profile |
  7. | `list_teams` | Teams you belong to |
  8. | `list_channels` | Channels (optional `team_id`; omit to include DMs and group messages) |
  9. | `get_channel_posts` | Messages in a channel, newest first (`channel_id`, `per_page`, `page`) |
  10. | `search_posts` | Search a team (`team_id`, `terms`, supports `in:`, `from:`, `before:`, `after:`) |
  11. ## Build
  12. ```sh
  13. make test
  14. make docker-build # image: mattermost-mcp:latest
  15. ```
  16. ## Configure
  17. ```sh
  18. cp .env.example .env # then edit .env
  19. ```
  20. - `MATTERMOST_URL`: base URL of your server, for example `https://mm.company.internal`.
  21. - `MATTERMOST_TOKEN`: the `MMAUTHTOKEN` cookie value from your browser (DevTools → Application → Cookies). It is equivalent to being logged in, so keep it in `.env` only. It stops working when you log out.
  22. ## Register with Claude Code
  23. Pass the env file by path so the token never appears on the command line or in shell history:
  24. ```sh
  25. claude mcp add mattermost -- docker run -i --rm \
  26. --env-file /home/smartinex/workspace/docker/mattermost/.env \
  27. mattermost-mcp:latest
  28. ```
  29. Restart Claude Code, then run `/mcp` to check that `mattermost` is connected.
  30. ## Notes
  31. - Plain `http` is refused unless `MATTERMOST_ALLOW_HTTP=1`.
  32. - Redirects are not followed, so the token is never sent to another host.
  33. - Certificates come from the image's CA bundle. If your server uses an internal CA, add it to a derived image.
  34. - Logs go to stderr. Stdout is reserved for the MCP protocol.
  35. - Your company may need to know about AI tools that read internal chat. Check policy before using this on real data.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.