MCP.so
Sign In

Mattermost MCP Server

@pvev

Basic information

Category

Communication

Transports

stdio

Author

pvev

About Mattermost MCP Server

Mattermost MCP server to enable Claude to interact with Mattermost Workspaces

Mattermost MCP Server config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "mattermost-mcp": {
      "command": "node",
      "args": [
        "view-channel-messages.js",
        "<channel-name>"
      ]
    }
  }
}

Mattermost MCP Server tools

Tool list not available yet

This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

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.

Frequently asked questions

1

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.

2

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.

3

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.

4

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`.

5

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.

Comments

More Communication MCP servers