Skip to content

mattermost-mcp

Mattermost team-collaboration API + MCP Server for the agent-connector-sdk ecosystem Server v4 REST API.

Official documentation

This site is the canonical reference for mattermost-mcp, maintained alongside every release.

PyPI MCP Server License GitHub

Overview

mattermost-mcp wraps the Mattermost Server v4 REST API with a dynamic-facade client

  • Api — a multi-inheritance REST facade (mattermost_mcp.api_client) covering channels, teams, posts, users, bots, files, and the full administrative surface.
  • A broad MCP tool set — FastMCP tools tagged under the MM prefix, with runtime toolset selection and visibility filtering to keep the model's context window lean. serve a web UI for conversational operations.

The package connects to Mattermost when credentials are provided and remains inactive when those credentials are absent.

Explore the documentation

  • :material-rocket-start: Installation — pip, source, extras, and the prebuilt Docker image.
  • Deployment — run the MCP server and agent, Docker Compose, Caddy + Technitium.
  • Usage — the MCP tools, the Api client, and the CLI.
  • Backing Platform — deploy Mattermost with Docker.
  • Concepts — the CONCEPT:MM-* registry.

Quick start

pip install "mattermost-mcp[mcp]"
mattermost-mcp                   # stdio MCP server (default transport)

Connect it to a Mattermost server:

export MATTERMOST_URL=http://your-mattermost:8065
export MATTERMOST_TOKEN=your_personal_access_token
mattermost-mcp --transport streamable-http --host 0.0.0.0 --port 8000

See Installation and Deployment for the proxy, DNS).

Spec delivery

Spec delivery dashboard. No owned specs are recorded yet. Missing requirement and code mappings remain unknown.