What is Mattermost Mcp Server

mattermost-mcp-server is a Model Context Protocol (MCP) server designed for integration with Mattermost. It connects to Mattermost API endpoints to retrieve and process information, making it accessible through standard MCP transports.

Use cases

Use cases include monitoring specific Mattermost channels for real-time updates, integrating Mattermost with other applications via MCP, and developing custom solutions that require secure and efficient communication with Mattermost.

How to use

To use mattermost-mcp-server, clone the repository, install dependencies, and build the server. You can run the server in either SSE transport mode or Standard I/O transport mode by providing the necessary parameters such as endpoint, token, team ID, and channels.

Key features

Key features include connection to Mattermost API endpoints, support for multiple transport modes (SSE and Standard I/O), real-time message processing, team and channel-specific monitoring, and secure token-based authentication.

Where to use

mattermost-mcp-server can be used in environments where Mattermost is deployed, such as team collaboration platforms, customer support systems, and any application requiring real-time communication and monitoring of Mattermost channels.

mcp-server-mattermost

This project implements a Model Context Protocol (MCP) server for Mattermost integration. It connects to Mattermost API endpoints to retrieve and process various information, making it available through standard MCP transports.

Features

• Secure, token-based connection to Mattermost API endpoints
• Supports multiple transport modes:
  • stdio
  • http-stream
  • sse
• Search for messages across multiple Mattermost channels
• Customizable default channels and message fetch limits

Requirements

• Node.js >= 22
• npm >= 10
• dotenvx
  • dotenvx

Setup

1. Clone this repository:

git clone https://github.com/kakehashi-inc/mcp-server-mattermost.git
cd mcp-server-mattermost

2. Install dependencies:

npm install

3. Set up your environment variables:

# Create .env file
cp .env.example .env

# Encrypt your .env file (optional but recommended for production)
dotenvx encrypt

Required environment variables:

• MATTERMOST_ENDPOINT: Your Mattermost server URL
• MATTERMOST_TOKEN: Your Mattermost authentication token
• MATTERMOST_TEAM_ID: The ID of the team to monitor
• MATTERMOST_CHANNELS: Comma-separated list of channel names to monitor

4. Build the server:

npm run build

Usage

The server supports three transport modes: stdio (default), sse, and http-stream.

Standard I/O Transport Mode

npm run start:stdio
# or
npx dotenvx run -q -- "node dist/main.js --transport stdio"

SSE Transport Mode

npm run start:sse
# or
npx dotenvx run -q -- "node dist/main.js --transport sse"

HTTP Transport Mode

npm run start:http
# or
npx dotenvx run -q -- "node dist/main.js --transport http-stream"

Development

• npm run dev: Start the server in development mode with hot reload
• npm run lint: Run ESLint
• npm run format: Format code using Prettier
• npm test: Run tests
• npm run inspect: Run MCP inspector

References

• Model Context Protocol TypeScript SDK
• MCP inspector

License

MIT