Skip to content

mattermost-mcp

Mattermost team-collaboration API + MCP Server for the agent-utilities ecosystem — a typed, deterministic tool surface and Pydantic-AI agent over the Mattermost 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 and exposes it as both an MCP server and an optional Pydantic-AI agent. It provides:

  • 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.
  • A Pydantic-AI agent (mattermost-agent) that consumes the MCP server and can serve a web UI for conversational operations.

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

Explore the documentation

  • 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.
  • Architecture — dynamic facade, FastMCP, agent server.
  • 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 full matrix (PyPI extras, Docker image, all transports, the agent server, reverse proxy, DNS).