How to Use the Mattermost MCP in Claude

Q: Can Claude Desktop manage multiple Mattermost teams at once?

Yes, your Claude Desktop agent uses listteams to fetch all accessible Mattermost workspaces. It then filters the results to target specific channels across different Mattermost teams based on your text prompts in Claude Desktop.

Q: How do I view incoming Mattermost webhooks inside Claude Desktop?

Ask your Claude Desktop agent to run listincomingwebhooks via the MCP Server directly in the chat interface. Claude Desktop parses the returned Mattermost JSON payload and displays the configured event endpoints in a clean list.

Run your Mattermost chat operations directly inside Claude Desktop using local tools to ping servers and manage channels.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Mattermost MCP to Claude Desktop

Create your Vinkius account to connect Mattermost to Claude Desktop and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup Mattermost with Claude Desktop

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Run Mattermost diagnostics inside Claude Desktop

The `test_server_ping` tool lets your Claude Desktop instance verify connection health to your self-hosted Mattermost chat server instantly. You don't need to open a terminal to check if the Mattermost API is responding to Claude Desktop requests. Your Claude Desktop agent uses `get_server_config` to read the active Mattermost configuration limits directly from your local workspace. This lets you debug Mattermost connection timeouts or payload size limits without leaving the Claude Desktop chat interface.

Manage Mattermost team workspaces with this MCP Server

The `list_teams` tool retrieves your active Mattermost organizational workspaces so Claude Desktop can map where your developer channels live. Your Claude Desktop agent queries `get_team_details` to resolve Mattermost team IDs before creating new discussion spaces. Once the Mattermost workspace context is established, the Claude Desktop agent runs `list_team_channels` to prevent duplicate channel creation. This keeps your Mattermost communication hub clean and structured without manual searching in Claude Desktop.

Dispatch Mattermost messages via Claude Desktop

The `post_message` tool sends text alerts directly into your Mattermost channels from the Claude Desktop interface. Your Claude Desktop agent formats the payload and transmits it immediately, saving you from constant window-switching between Mattermost and Claude Desktop. If a new Mattermost incident arises, the Claude Desktop agent invokes `create_new_channel` to spin up a dedicated room. It then pulls context using `list_channel_posts` to catch up on what happened before you opened Claude Desktop.

Setup guide

Set up Mattermost MCP in Claude Web or Desktop

1

Open Claude Settings

Go to claude.ai, click your profile icon, then navigate to Customize → Connectors.
2

Add Custom Connector

Click the "+" button and select Add custom connector. Paste your Vinkius endpoint URL: https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com. For OAuth-protected servers, expand Advanced settings to add credentials.
3

Start a conversation

Open a new chat. The Mattermost MCP tools are available immediately — no restart needed.

Endpoint URL

https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp

No configuration file needed — paste the URL directly in the Claude web interface.

Available on Free (1 connector), Pro, Max, Team, and Enterprise plans.

Prerequisites

Claude Desktop installed (macOS or Windows)
Active Vinkius subscription with a valid endpoint token

1

Open Claude Desktop Settings

Click the menu icon at the top-left corner, go to Settings → Developer → Edit Config. This opens claude_desktop_config.json in your default text editor.
2

Paste the Mattermost MCP configuration

Copy the JSON snippet on the right into the mcpServers object. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Restart Claude Desktop

Close and reopen the application. Claude needs a full restart to load new MCPs — refreshing a conversation is not enough.
4

Verify the connection

Open a new conversation. Click the 🔌 icon at the bottom of the message input. You should see tools listed under mattermost-mcp.

json

{
  "mcpServers": {
    "mattermost-mcp": {
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Mattermost. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect Mattermost now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about Mattermost MCP in Claude Desktop

Open your Claude Desktop config file and add the Mattermost MCP Server configuration under the mcpServers key. Provide the command and arguments for the node executable, save the file, and fully restart your Claude Desktop app to load the Mattermost tools.

Yes, your Claude Desktop agent uses `list_teams` to fetch all accessible Mattermost workspaces. It then filters the results to target specific channels across different Mattermost teams based on your text prompts in Claude Desktop.

This failure usually means your Claude Desktop config file points to an unreachable Mattermost URL or uses an invalid personal access token. Double-check your environment variables in the Claude Desktop configuration file to ensure the Mattermost API has network access.

Ask your Claude Desktop agent to run `list_incoming_webhooks` via the MCP Server directly in the chat interface. Claude Desktop parses the returned Mattermost JSON payload and displays the configured event endpoints in a clean list.

No, your Mattermost chat messages and user profiles remain secure inside your private network. The MCP connection runs locally on your machine via stdio transport, meaning Claude Desktop only accesses the specific Mattermost payloads you request during active chat sessions.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript