Mattermost MCP Client

What is Mattermost MCP Client?

A Python-based MCP (Model Context Protocol) client that connects Mattermost with MCP servers, enabling command execution and tool management through Mattermost channels. It runs on any system with Python 3.13.1+ and a Mattermost server, targeting developers and teams wanting to extend Mattermost with AI and automation tools.

How to use Mattermost MCP Client?

Create a virtual environment, install dependencies with uv sync, and configure a .env file with Mattermost URL, bot token, and MCP server settings. Define MCP servers in mcp-servers.json, then run python src/mattermost_mcp_client/main.py. Once running, send commands like !mcp help or !mcp <server_name> call <tool_name> <args> in a Mattermost channel.

Key features of Mattermost MCP Client

• Connects Mattermost to any stdio-based MCP server
• Execute tools and manage resources via channel commands
• Built-in MCP servers for chat, Ollama, and Mattermost API
• Command-line utility to test MCP servers directly
• Configuration through environment variables and JSON files

Use cases of Mattermost MCP Client

• Trigger AI text generation in Mattermost using local Ollama models
• Automate Mattermost actions like posting messages programmatically
• Build custom toolchains that execute from chat commands
• Test and debug MCP servers before deploying to production

FAQ from Mattermost MCP Client

What does this client do that alternatives don’t?

It bridges Mattermost communication with MCP servers, letting users call any MCP tool directly from a Mattermost channel without leaving the chat interface.

Which platforms and models are supported?

The client runs on any OS with Python 3.13.1+. It supports any MCP server configured via stdio; included servers demonstrate integration with Ollama (local models) and the Mattermost API.

How does MCP server configuration work?

Servers are defined in mcp-servers.json as objects with command, args, and type (stdio). Multiple servers can be listed, and the client discovers them at startup.

What are the known limitations?

The client currently lacks support for npx-based MCP servers, built-in authentication, and file uploads. These are noted as planned next steps.