Mattermost Server
MCP server for Mattermost — let Claude, Cursor, and other AI assistants work with channels, messages, and files
What is Mattermost Server?
Mattermost Server is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to mcp server for mattermost — let claude, cursor, and other ai assistants work with channels, messages, and files
MCP server for Mattermost — let Claude, Cursor, and other AI assistants work with channels, messages, and files
This server falls under the Communication category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- MCP server for Mattermost — let Claude, Cursor, and other AI
Use Cases
Maintainer
Works with
Installation
NPM
npx -y mattermostManual Installation
npx -y mattermostConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use Mattermost Server
Mattermost MCP Server is a Python-based integration that gives AI assistants like Claude and Cursor full access to Mattermost team messaging, exposing 38 tools for reading and sending messages, managing channels and teams, uploading files, handling reactions and threads, searching message history, and more. It is designed for engineering teams using self-hosted or cloud Mattermost who want to automate communication workflows, get caught up on missed messages, or have their AI assistant interact with Mattermost on their behalf.
Prerequisites
- Python 3.10+ installed with uv or pip
- Access to a Mattermost server (self-hosted or cloud) with API access enabled
- MATTERMOST_URL set to your Mattermost server URL
- MATTERMOST_TOKEN: a personal access token or bot token from your Mattermost account settings
- An MCP-compatible client such as Claude Desktop, Cursor, or VS Code
Generate a Mattermost personal access token
In your Mattermost account, go to Profile > Security > Personal Access Tokens and create a new token. Copy the token value — it will only be shown once. Alternatively, create a bot account from the System Console and use its token.
Install and run via uvx
The recommended way to run the server is via uvx, which handles installation automatically. Test it with your credentials before adding to your MCP config.
MATTERMOST_URL=https://your-mattermost.com MATTERMOST_TOKEN=your-token uvx mcp-server-mattermostAdd the server to your MCP client config
Register mcp-server-mattermost in your Claude Desktop configuration with your Mattermost URL and token.
{
"mcpServers": {
"mattermost": {
"command": "uvx",
"args": ["mcp-server-mattermost"],
"env": {
"MATTERMOST_URL": "https://your-mattermost.com",
"MATTERMOST_TOKEN": "your_personal_access_token"
}
}
}
}Optionally configure authentication mode and timeouts
For advanced setups, set MATTERMOST_AUTH_MODE (static_token, client_token, or oauth_proxy), MATTERMOST_TIMEOUT (default 30s), and MATTERMOST_MAX_RETRIES (default 3). For Docker deployments, set MATTERMOST_VERIFY_SSL=false if using self-signed certs.
Restart your MCP client and verify
Restart Claude Desktop or Cursor to load the new configuration. Ask it to list your Mattermost channels to confirm the connection is working.
Mattermost Server Examples
Client configuration
Claude Desktop configuration for mcp-server-mattermost using uvx with a personal access token.
{
"mcpServers": {
"mattermost": {
"command": "uvx",
"args": ["mcp-server-mattermost"],
"env": {
"MATTERMOST_URL": "https://your-mattermost.com",
"MATTERMOST_TOKEN": "your_personal_access_token",
"MATTERMOST_AUTH_MODE": "static_token",
"MATTERMOST_TIMEOUT": "30",
"MATTERMOST_LOG_LEVEL": "INFO"
}
}
}
}Prompts to try
Example prompts for working with Mattermost channels and messages through the AI assistant.
- "What did I miss in the #engineering channel since yesterday morning?"
- "Send a message to #general: 'Deployment to production completed successfully'"
- "Search for messages about the outage last week and summarize the key points"
- "List all channels I'm a member of"
- "Post a message with a red attachment to #alerts: 'Build failed on main'"
- "Show me the thread replies on the last pinned message in #dev-team"Troubleshooting Mattermost Server
401 Unauthorized when connecting to Mattermost
Verify your MATTERMOST_TOKEN is a valid personal access token, not your login password. In Mattermost, go to Profile > Security > Personal Access Tokens. Also confirm personal access tokens are enabled by your system administrator in the System Console.
SSL certificate errors with self-hosted Mattermost
If your Mattermost instance uses a self-signed certificate, set MATTERMOST_VERIFY_SSL=false in your env configuration. For production, configure a valid certificate on your Mattermost server instead.
Bookmark tools are not available
Bookmark management requires Mattermost v10.1+ and the Entry+ edition. Check your Mattermost server version and license level. The remaining 37 tools work on standard Community and Enterprise editions.
Frequently Asked Questions about Mattermost Server
What is Mattermost Server?
Mattermost Server is a Model Context Protocol (MCP) server that mcp server for mattermost — let claude, cursor, and other ai assistants work with channels, messages, and files It connects AI assistants to external tools and data sources through a standardized interface.
How do I install Mattermost Server?
Install via npm with the command: npx -y mattermost. Then add the server configuration to your AI client's JSON config file (e.g., claude_desktop_config.json or .cursor/mcp.json).
Which AI clients work with Mattermost Server?
Mattermost Server works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is Mattermost Server free to use?
Yes, Mattermost Server is open source and available under the MIT license. You can use it freely in both personal and commercial projects.
Mattermost Server Alternatives — Similar Communication Servers
Looking for alternatives to Mattermost Server? Here are other popular communication servers you can use with Claude, Cursor, and VS Code.
Slack
★ 86.1kEnables interaction with Slack workspaces through comprehensive channel management, messaging, user management, file uploads, and Block Kit formatting. Features secure credential storage via macOS Keychain and supports all major Slack operations incl
LibreChat
★ 37.3kEnhanced ChatGPT Clone: Features Agents, MCP, DeepSeek, Anthropic, AWS, OpenAI, Responses API, Azure, Groq, o1, GPT-5, Mistral, OpenRouter, Vertex AI, Gemini, Artifacts, AI model switching, message search, Code Interpreter, langchain, DALL-E-3, OpenA
Note Gen
★ 11.9kA cross-platform Markdown AI note-taking software.
DeepChat
★ 5.8k🐬DeepChat - A smart assistant that connects powerful AI to your personal world
WhatsApp MCP
★ 5.7kConnects AI assistants to the official Meta WhatsApp Cloud API for managing conversations and sending various message types through natural language. It provides tools for media management, template messages, and real-time webhook processing without
Apple
★ 3.1kEnables interaction with Apple apps like Messages, Notes, and Contacts through the MCP protocol to send messages, search, and open app content using natural language.
Browse More Communication MCP Servers
Explore all communication servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up Mattermost Server in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use Mattermost Server?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.