mattermost-mcp-server

What is mattermost-mcp-server?

Mattermost-mcp-server is an MCP (Model Context Protocol) server that connects to the Mattermost API to retrieve and process messages, making them available to MCP clients via standard transports. It is designed for developers and teams who want to integrate Mattermost with AI assistants or other MCP-compatible tools.

How to use mattermost-mcp-server?

Clone the repository, install dependencies with npm install, and set the required environment variables (MATTERMOST_ENDPOINT, MATTERMOST_TOKEN, MATTERMOST_TEAM, MATTERMOST_CHANNELS). Build with npm run build, then run the server using node dist/main.js --transport <mode> where mode is stdio, sse, or http-stream. You can also use npx mcp-server-mattermost with the appropriate arguments. For Claude Desktop, add a configuration entry with the command, transport, endpoint, token, team, and channels.

Key features of mattermost-mcp-server

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

Use cases of mattermost-mcp-server

• Integrate Mattermost with Claude Desktop to query channel messages
• Build AI‑powered search tools that look across team conversations
• Enable automated retrieval of recent messages from selected channels

FAQ from mattermost-mcp-server

What are the runtime requirements?

Node.js version 22 or higher and npm version 10 or higher.

Which transport modes are supported?

The server supports stdio, http-stream, and sse transports.

How do I authenticate with the Mattermost API?

Set the MATTERMOST_TOKEN environment variable to your personal access token.

Can I configure which channels are monitored?

Yes, set the MATTERMOST_CHANNELS environment variable with a comma‑separated list of channel names.

How do I integrate this server with Claude Desktop?

Add a configuration entry under mcpServers in your Claude Desktop settings, specifying the command npx, the server package, and arguments for transport, endpoint, token, team, and channels.