Mattermost MCP Server
MCP Server for the Mattermost API, enabling Claude and other MCP clients to interact with Mattermost workspaces.
Quick Start
Using npx (recommended)
npx @conarti/mattermost-mcp --helpUsing environment variables
MATTERMOST_URL=https://your-mattermost.com/api/v4 \
MATTERMOST_TOKEN=your-token \
MATTERMOST_TEAM_ID=your-team-id \
npx @conarti/mattermost-mcpUsing CLI arguments
npx @conarti/mattermost-mcp \
--url https://your-mattermost.com/api/v4 \
--token your-token \
--team-id your-team-idInstallation
Option 1: npx (no installation needed)
npx @conarti/mattermost-mcpOption 2: Global installation
npm install -g @conarti/mattermost-mcp
mattermost-mcp --helpOption 3: Clone and build
git clone https://github.com/conarti/mattermost-mcp.git
cd mattermost-mcp
npm install
npm run build
npm startConfiguration
The server supports multiple configuration methods with the following priority (highest to lowest):
- CLI arguments (
--url,--token,--team-id) - Environment variables (
MATTERMOST_URL,MATTERMOST_TOKEN,MATTERMOST_TEAM_ID) - config.local.json (for local overrides, gitignored)
- config.json (default configuration)






