MCP Mattermost Server

This is an MCP (Model Context Protocol) server for Mattermost, written in TypeScript. It provides various tools for interacting with the Mattermost API.

Installation

To run this tool, you need to set the following environment variables:

{
  ...
  "mcp-mattermost": {
    "command": "npx",
    "args": [
      "@dakatan/mcp-mattermost"
    ],
    "env": {
      "MCP_MATTERMOST_URL": "https://mattermost.x.y",
      "MCP_MATTERMOST_TOKEN": "",
      "MCP_MATTERMOST_TEAM_ID": "", // Optional: You can Use team ID instead of Team Name
      "MCP_MATTERMOST_TEAM_NAME": "" // Optional: You Use team name instead of Team ID
    }
  },
  ...
}

Configuration

To run this tool, you need to set the following environment variables:

| Variable Name | Description | Required | | -------------------------- | --------------------------------------------------------- | -------- | | MCP_MATTERMOST_URL | The URL of your Mattermost instance | Yes | | MCP_MATTERMOST_TOKEN | Your Mattermost personal access token | Yes | | MCP_MATTERMOST_TEAM_ID | The ID of the Mattermost team you want to interact with | No* | | MCP_MATTERMOST_TEAM_NAME | The name of the Mattermost team you want to interact with | No* |

* Either MCP_MATTERMOST_TEAM_ID or MCP_MATTERMOST_TEAM_NAME must be provided. If both are provided, MCP_MATTERMOST_TEAM_ID takes precedence.

Note: Using MCP_MATTERMOST_TEAM_ID is recommended as it's more reliable and efficient than using team names.

Tools Provided

The MCP server provides the following tools:

• User management: mattermost_get_users, mattermost_search_users
• Channel management: mattermost_search_channels, mattermost_get_channels, mattermost_get_my_channels
• Post management: mattermost_search_posts, mattermost_get_posts, mattermost_create_post, mattermost_get_posts_thread, mattermost_pin_post, mattermost_unpin_post, mattermost_get_pinned_posts
• Reaction management: mattermost_add_reaction, mattermost_remove_reaction, mattermost_get_reactions