MattermostSAFE

MCP Server for the Mattermost API, enabling Claude and other MCP clients to interact with Mattermost workspaces.

Features

This MCP server provides tools for interacting with Mattermost, including:

Topic Monitoring

The server includes a topic monitoring system that can:

• Monitor specified channels for messages containing topics of interest
• Run on a configurable schedule (using cron syntax)
• Send notifications when relevant topics are discussed
• Mention you in a specified channel when topics are found

Channel Tools

• mattermost_list_channels: List public channels in the workspace
• mattermost_get_channel_history: Get recent messages from a channel

Message Tools

• mattermost_post_message: Post a new message to a channel
• mattermost_reply_to_thread: Reply to a specific message thread
• mattermost_add_reaction: Add an emoji reaction to a message
• mattermost_get_thread_replies: Get all replies in a thread

Monitoring Tools

• mattermost_run_monitoring: Trigger the topic monitoring process immediately

User Tools

• mattermost_get_users: Get a list of users in the workspace
• mattermost_get_user_profile: Get detailed profile information for a user

Setup

1. Clone this repository:

git clone https://github.com/yourusername/mattermost-mcp.git
cd mattermost-mcp

1. Install dependencies:

npm install

1. Configure the server:

The repository includes a config.json file with placeholder values. For your actual configuration, create a config.local.json file (which is gitignored) with your real credentials:

{
"mattermostUrl": "https://your-mattermost-instance.com/api/v4",
"token": "your-personal-access-token",
"teamId": "your-team-id",
"monitoring": {
"enabled": false,
"schedule": "*/15 * * * *",
"channels": ["town-square", "off-topic"],
"topics": ["tv series", "champions league"],
"messageLimit": 50
}
}

This approach keeps you