Mattermost MCP

A Model Context Protocol (MCP) server for comprehensive Mattermost integration. This tool provides AI agents and automation systems with full access to Mattermost's capabilities beyond basic messaging.

Features

Core Capabilities

• Message Management: Search, retrieve, and analyze message history

• Channel Operations: Create, manage, and monitor channels

• User & Team Management: Access user profiles, team structures, and presence

• File Operations: Upload, download, and manage file attachments

• Advanced Search: Find conversations, users, and content across your workspace

Designed For

• Autonomous AI agents requiring Mattermost context and control

• Automation developers building Mattermost integrations

• Teams creating custom workflow tools

• Research applications analyzing communication patterns

Related MCP server: Slack MCP Server

Quick Start

Installation

pip install mattermost-mcp

Configuration

Create a configuration file or set environment variables:

export MATTERMOST_URL="https://your-mattermost.example.com"
export MATTERMOST_TOKEN="your-bot-token"
export MATTERMOST_TEAM_ID="your-team-id"  # optional

Usage with Claude Desktop

Add to your Claude Desktop MCP configuration:

{
  "mcpServers": {
    "mattermost": {
      "command": "python",
      "args": ["-m", "mattermost_mcp"],
      "env": {
        "MATTERMOST_URL": "https://your-mattermost.example.com",
        "MATTERMOST_TOKEN": "your-bot-token"
      }
    }
  }
}

Available Tools

Channel Management

• list_channels - Get all accessible channels

• create_channel - Create new channels

• get_channel_info - Get detailed channel information

• add_user_to_channel - Manage channel membership

• set_channel_header - Update channel descriptions

Message Operations

• search_messages - Search message history with filters

• get_channel_messages - Retrieve recent messages from channels

• send_message - Send messages to channels

• update_message - Edit existing messages

• pin_message - Pin important messages

User & Team Operations

• list_team_members - Get team member directory

• get_user_profile - Access detailed user information

• get_user_presence - Check online/offline status

• list_teams - Get team structure information

File Management

• upload_file - Upload files to channels

• download_file - Download shared files

• list_files - Get file listings for channels

• get_file_info - Access file metadata

Advanced Features

• get_analytics - Channel and user activity analytics

• search_users - Find users by name, email, or criteria

• get_channel_stats - Message counts, activity metrics

API Reference

[Detailed API documentation coming soon]

Contributing

1. Fork the repository

2. Create a feature branch

3. Add tests for new functionality

4. Submit a pull request

License

MIT License - see LICENSE file for details.

Related Projects

• Claude-Mattermost Bridge - Real-time message relay between Claude and Mattermost

• Mattermost API Documentation

Support

• GitHub Issues for bug reports and feature requests

• Mattermost API documentation for API reference

• MCP specification for protocol details