mattermost mcp server

Local 2025-08-31 23:45:06 0
Communication @kakehashi-inc/mattermost-mcp-server

A Model Context Protocol server that connects to Mattermost, allowing AI models to monitor and process messages from specific teams and channels in real-time via SSE or Standard I/O transport modes.

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

  • Connects to Mattermost API endpoints
  • Supports multiple transport modes:
  • SSE (Server-Sent Events)
  • Standard I/O
  • Real-time message processing
  • Team and channel-specific monitoring
  • Secure token-based authentication

Requirements

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

Setup

  1. Clone this repository:
git clone https://github.com/kakehashi-inc/mattermost-mcp-server.git
cd mattermost-mcp-server
  1. Install dependencies:
npm install
  1. 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:

  • MCP_PORT: Port number for SSE transport mode (default: 8201)
  • 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

  • Build the server:

npm run build

Usage

The server can be run in two transport modes:

SSE Transport Mode

npm start

Standard I/O Transport Mode

npm start -- --stdio

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

License

MIT