Mattermost MCP Server

MCP server for comprehensive Mattermost administration and operations, with priority focus on admin console functionality.

Features

Admin Console Operations

• System Configuration: Get and update all system settings

• System Status: Monitor system health and status

• Analytics: Access system analytics and metrics

• Logs: View server logs

User Management

• List, create, and manage users

• Update user roles (make admins)

• Deactivate user accounts

• Filter users by team and role

Team Management

• List and create teams

• Add users to teams

• Manage team settings

Channel Management

• List and create channels (public/private)

• Add users to channels

• Manage channel settings

Messaging

• Send messages to channels

• Retrieve channel posts

Plugin Management

• List installed plugins

• Enable/disable plugins

• Upload new plugins

Related MCP server: Systems Manager

Installation

cd /Users/franksimpson/CascadeProjects/mattermost-mcp-server
npm install

Configuration

Add to your MCP settings file (~/.codeium/windsurf/mcp_config.json):

{
  "mcpServers": {
    "mattermost": {
      "command": "node",
      "args": ["/Users/franksimpson/CascadeProjects/mattermost-mcp-server/index.js"],
      "env": {
        "MATTERMOST_URL": "https://docker-production-a32b.up.railway.app",
        "MATTERMOST_TOKEN": "tfszhco5sfy1jbfif9cfyz4gyy"
      }
    }
  }
}

Available Tools

Admin Console

• get_system_config - Get entire system configuration

• update_system_config - Update system settings

• get_system_status - Get system health status

• get_analytics - Get system analytics

• get_logs - View server logs

Users

• list_users - List all users with filtering

• get_user - Get specific user details

• create_user - Create new user

• update_user_roles - Update user roles (admin access)

• deactivate_user - Deactivate user account

Teams

• list_teams - List all teams

• create_team - Create new team

• add_user_to_team - Add user to team

Channels

• list_channels - List channels

• create_channel - Create new channel

• add_user_to_channel - Add user to channel

Messages

• send_message - Send message to channel

• get_channel_posts - Get posts from channel

Plugins

• list_plugins - List installed plugins

• enable_plugin - Enable a plugin

• disable_plugin - Disable a plugin

Usage Examples

After configuration, you can use these tools through the MCP interface:

// Get system configuration
mcp_mattermost_get_system_config()

// List all users
mcp_mattermost_list_users({ page: 0, per_page: 100 })

// Create a new user
mcp_mattermost_create_user({
  email: "user@example.com",
  username: "newuser",
  password: "securepassword123"
})

// Make a user admin
mcp_mattermost_update_user_roles({
  user_id: "user_id_here",
  roles: "system_admin system_user"
})

// Send a message
mcp_mattermost_send_message({
  channel_id: "channel_id_here",
  message: "Hello from MCP!"
})

Requirements

• Node.js 18+

• Mattermost server with API access

• Valid Mattermost API token with admin permissions