Mattermost MCP Server

What is Mattermost MCP Server?

The Mattermost MCP Server is a Model Context Protocol server that wraps the Mattermost API, enabling Claude and other MCP clients to interact with Mattermost workspaces. It provides tools for channel management, messaging, user queries, and topic monitoring.

How to use Mattermost MCP Server?

Clone the repository, run npm install, create a config.local.json with your Mattermost URL, personal access token, and team ID, then run npm run build followed by npm start. Add "mattermost": {"command": "node", "args": ["/path/to/mattermost-mcp/build/index.js"]} to your claude_desktop_config.json.

Key features of Mattermost MCP Server

• Channel tools: list public channels and get channel history.
• Message tools: post, reply, add reactions, and get thread replies.
• User tools: list users and get detailed user profiles.
• Topic monitoring system with configurable cron schedule.
• Manual monitoring triggers via HTTP, CLI, and MCP tool.
• Utility scripts for viewing and analyzing channel messages.

Use cases of Mattermost MCP Server

• Monitor Mattermost channels for specific topics and receive notifications.
• Automate posting messages or replying to threads from an MCP client.
• Retrieve recent messages or full thread replies for analysis.
• Get user profile information for workspace administration.
• Trigger ad‑hoc monitoring without restarting the server.

FAQ from Mattermost MCP Server

What dependencies does Mattermost MCP Server require?

Node.js and npm are required. The server also needs a Mattermost personal access token and the workspace URL.

How is authentication handled?

Authentication is configured via a config.local.json file containing your Mattermost URL, personal access token, and team ID. The server uses these credentials for all API calls.

Can I run monitoring on a schedule?

Yes. Enable monitoring by setting "enabled": true in your config and specify a cron expression (e.g., "*/15 * * * *") for the schedule. You can also trigger it manually via HTTP, CLI, or the mattermost_run_monitoring tool.

What are the limits for paginated tools?

The mattermost_list_channels, mattermost_get_users, and similar tools accept limit (default 100, max 200) and page parameters. mattermost_get_channel_history and mattermost_get_thread_replies also support pagination with limit (default 30) and page.

Where are credentials and configuration stored?

Your real Mattermost credentials and monitoring settings are stored in a config.local.json file (gitignored). The repository includes a config.json template with placeholder values.