Skip to content

Quick Start

Get up and running in 2 minutes.

Prerequisites

  • Mattermost server with API access
  • Bot account or personal access token

For HTTP deployments where each user signs in with their own Mattermost identity, see Authentication for client_token and oauth_proxy modes.

Install

uvx mcp-server-mattermost

No installation needed — runs directly.

pip install mcp-server-mattermost

docker pull legard/mcp-server-mattermost

git clone https://github.com/cloud-ru-tech/mcp-server-mattermost
cd mcp-server-mattermost
uv sync

Get a Mattermost Token

  1. Go to System Console → Integrations → Bot Accounts
  2. Create a new bot or use an existing one
  3. Copy the access token

Tip

Personal access tokens also work: Profile → Security → Personal Access Tokens

Configure Your MCP Client

Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "mattermost": {
      "command": "uvx",
      "args": ["mcp-server-mattermost"],
      "env": {
        "MATTERMOST_URL": "https://your-mattermost-server.com",
        "MATTERMOST_TOKEN": "your-bot-token"
      }
    }
  }
}

Add to ~/.cursor/mcp.json:

{
  "mcpServers": {
    "mattermost": {
      "command": "uvx",
      "args": ["mcp-server-mattermost"],
      "env": {
        "MATTERMOST_URL": "https://your-mattermost-server.com",
        "MATTERMOST_TOKEN": "your-bot-token"
      }
    }
  }
}

claude mcp add mattermost \
  -e MATTERMOST_URL=https://your-mattermost-server.com \
  -e MATTERMOST_TOKEN=your-bot-token \
  -- uvx mcp-server-mattermost

Add to opencode.json:

{
  "mcp": {
    "mattermost": {
      "type": "local",
      "command": ["uvx", "mcp-server-mattermost"],
      "enabled": true,
      "environment": {
        "MATTERMOST_URL": "https://your-mattermost-server.com",
        "MATTERMOST_TOKEN": "your-bot-token"
      }
    }
  }
}

Verify

  1. Restart your MCP client
  2. Test with a simple query: "List my teams" or "What channels are available?"

The Mattermost tools are now available in your conversations.

Next Steps