Skip to content
Back to search

mattermost-plugin-agents

Mattermost Agents plugin supporting multiple LLMs

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 11 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/mattermost/mattermost-plugin-agents with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/mattermost/mattermost-plugin-agents'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/mattermost--mattermost-plugin-agents/badge.svg)](/listings/mattermost--mattermost-plugin-agents)

HTML

<a href="/listings/mattermost--mattermost-plugin-agents"><img src="/api/listings/mattermost--mattermost-plugin-agents/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

1. Setup your Mattermost development environment by following the [Mattermost developer setup guide](https://developers.mattermost.com/contribute/server/developer-setup/). If you have a remote mattermost server you want to develop to you can skip this step.

2. Setup your Mattermost plugin development environment by following the [Plugin Developer setup guide](https://developers.mattermost.com/integrate/plugins/developer-setup/).

3. Clone the repository:

git clone https://github.com/mattermost/mattermost-plugin-agents.git
cd mattermost-plugin-agents

4. **Optional**. If you are developing to a remote server, setup environment variables to deploy:

MM_SERVICESETTINGS_SITEURL=http://localhost:8065
MM_ADMIN_USERNAME=<YOUR_USERNAME>
MM_ADMIN_PASSWORD=<YOUR_PASSWORD>

5. Run deploy to build the plugin

make deploy

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 180 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. <div align="center">
  2. # Mattermost Agents Plugin [![Download Latest Master Build](https://img.shields.io/badge/Download-Latest%20Master%20Build-blue)](https://github.com/mattermost/mattermost-plugin-agents/releases/tag/latest-master)
  3. Self-hosted AI agents for [Mattermost](https://github.com/mattermost/mattermost) that act on your behalf through tools and MCP servers, plus a built-in Mattermost MCP server for external AI clients such as Claude Code, Claude Desktop, Cursor, and VS Code.
  4. </div>
  5. ![The Mattermost Agents AI Plugin is an extension for mattermost that provides functionality for self-hosted and vendor-hosted LLMs](img/mattermost-ai-llm-access.webp)
  6. Mattermost Agents (plugin ID `mattermost-ai`) adds AI agents to a Mattermost server. You talk to an agent in a direct message, the Agents pane, or a channel. The agent can search and post in Mattermost, call tools on other systems through the Model Context Protocol (MCP), and work with files, all with the permissions of the person it is acting for. You choose the LLM, including models that run on your own infrastructure, so with a self-hosted model, conversations and data stay in your environment.
  7. **Does Mattermost have an official MCP server?** Yes. It is built into this plugin and needs no separate installation. After an admin enables it, MCP clients connect to `/plugins/mattermost-ai/mcp-server/mcp` on your Mattermost server and sign in as a Mattermost user. See [Mattermost MCP Server](docs/mcp_server.md).
  8. ## Key Features
  9. - **Agents that act on your behalf**: Chat with a personal agent that searches and reads Mattermost, posts and sends messages, schedules posts and reminders, and uses tools from other systems. Configure multiple agents with their own instructions, models, and tool access. See [Use Mattermost Agents as your personal AI assistant](docs/personal_agent.md).
  10. - **Tools and MCP**: Agents use built-in Mattermost tools, remote MCP servers with per-user OAuth (with a **Connect** card in the conversation), and tools registered by other Mattermost plugins. Dynamic tool loading keeps large tool catalogs out of the model's context.
  11. - **Built-in Mattermost MCP server**: Connect Claude Code, Claude Desktop, Cursor, VS Code, or any MCP client that supports streamable HTTP to Mattermost, using OAuth with dynamic client registration or a personal access token. Over 100 tools run with the signed-in user's own permissions. See [Mattermost MCP Server](docs/mcp_server.md).
  12. - **Governance**: Per-tool approval policies, user, team, and channel access controls for agents, attribute-based access control, server audit logging, token usage tracking, and OpenTelemetry tracing. Admins decide which tools exist and which need approval. See the [Admin Guide](docs/admin_guide.md).
  13. - **Bring your own LLM**: Use local models through OpenAI-compatible APIs (Ollama, vLLM), or OpenAI, Anthropic, AWS Bedrock, Azure OpenAI, Google Gemini and Vertex AI, Cohere (including Cohere North), and Mistral. See [Provider configuration](docs/providers.md) and [Sovereign AI deployments](docs/sovereign_ai.md).
  14. - **Summaries, search, and meetings**: Summarize threads, unread messages, and channels; ask questions about a channel; search with keyword and semantic search; and summarize Mattermost Calls and Zoom meeting recordings.
  15. - **Files and artifacts**: Agents create text files attached to their replies, read attachments, analyze images with vision-capable models, and render HTML artifacts in the conversation.
  16. - **Channel use**: @mention an agent in a channel, or set a channel to auto-reply. Tool results in channels can be shared or kept private by the person who asked.
  17. - **Custom prompts**: Save reusable prompts, pin them in the Agents pane, and share them with your team.
  18. Some features depend on your Mattermost license level. See the [license requirements](docs/admin_guide.md#license-requirements).
  19. ## Documentation
  20. Documentation is in the [`docs`](docs/) directory. The same pages are published on docs.mattermost.com.
  21. **For users**
  22. - [Use Mattermost Agents](docs/user_guide.md): Start a conversation, choose an agent, attach files, and find every user feature
  23. - [Use Agents as your personal AI assistant](docs/personal_agent.md): What an agent can do across channels, MCP servers, and integrations, and how to prompt it
  24. - [Use tools and approve actions](docs/using_tools.md): Accept or reject tool calls and connect your accounts
  25. - [Use agents in channels](docs/agents_in_channels.md): Mentions, tool use in channels, and auto-reply
  26. - [Summaries and AI search](docs/summaries_and_search.md): Summarize threads and channels, and search with AI
  27. - [Meeting summaries](docs/meeting_summaries.md): Summarize Calls and Zoom meetings
  28. - [Custom prompts](docs/custom_prompts.md): Save, share, and pin reusable prompts
  29. - [What agents can see and keep](docs/what_agents_see.md): What an agent reads, what it can reach, and what is stored
  30. **For admins**
  31. - [Admin guide](docs/admin_guide.md): Requirements, quick start, settings map, and license requirements
  32. - [Configure LLM services](docs/llm_services.md), [Provider configuration](docs/providers.md), and [AWS Bedrock setup](docs/aws_bedrock_setup.md)
  33. - [Create and manage agents](docs/managing_agents.md) and [Control who can use agents](docs/access_control.md)
  34. - [Connect agents to MCP servers](docs/mcp_integrations.md) and [Tool approval and credentials](docs/tool_approval.md)
  35. - [Control agents in channels](docs/channel_settings.md)
  36. - [Web search](docs/web_search.md) and [Set up semantic search](docs/embedding_search.md)
  37. - [Secure AI-generated links and HTML](docs/ai_output_security.md)
  38. - [Monitor Agents](docs/observability.md), [Back up and automate](docs/backup_and_automation.md), and [Troubleshooting](docs/troubleshooting.md)
  39. - [Data handling](docs/data_handling.md) and [Sovereign AI deployments](docs/sovereign_ai.md)
  40. - [Upgrade from Agents 1.x](docs/upgrading_to_2.0.md)
  41. **For developers**
  42. - [Mattermost MCP server](docs/mcp_server.md): Connect Claude Code, Claude Desktop, Cursor, VS Code, and other MCP clients to Mattermost
  43. - [Mattermost MCP tool reference](docs/mcp_tools.md): All 121 built-in tools
  44. - [LLM Bridge for plugins](docs/llm_bridge.md): Call agents and services from another plugin
  45. - [Load testing](docs/load-testing.md): Configure the in-process mock LLM and the load-test-ng Agents controller
  46. ## Installation
  47. 1. Download the latest release from the [releases page](https://github.com/mattermost/mattermost-plugin-agents/releases). You can also download the **experimental** [latest master](https://github.com/mattermost/mattermost-plugin-agents/releases/tag/latest-master)
  48. 2. Upload and enable the plugin through the Mattermost System Console
  49. 3. Configure your desired LLM provider settings
  50. ### System Requirements
  51. - Mattermost Server v12.0.0+
  52. - PostgreSQL database, with the pgvector extension for semantic search
  53. - **Site URL** set on the Mattermost server
  54. - Network access to your chosen LLM provider
  55. ## Quick Start
  56. After installation, complete these steps to get started:
  57. 1. Go to **System Console > Plugins > Agents** and select **Add an AI Service**. Choose your LLM provider and enter its credentials and a default model.
  58. 2. Open the **Agents** page from the product switcher (grid icon) and select **Create agent**. Choose a username and the service.
  59. 3. Optionally set who can use the agent on its **Access** tab.
  60. 4. Send the agent a direct message, or open the Agents pane from the apps bar.
  61. For more, see the [Admin guide](docs/admin_guide.md).
  62. ## Integration
  63. ### Bridge Client
  64. The plugin provides a Go client library for other Mattermost plugins and the Mattermost server to interact with the AI plugin's LLM Bridge API. This allows you to easily add AI capabilities to your own plugins or server-side features.
  65. See the [Bridge Client README](public/bridgeclient/README.md) for installation and usage instructions.
  66. ## Development
  67. ### Prerequisites
  68. - Go 1.27+
  69. - Node.js 24.11+
  70. - Access to an LLM provider (OpenAI, Anthropic, etc.)
  71. ### Local Setup
  72. 1. Setup your Mattermost development environment by following the [Mattermost developer setup guide](https://developers.mattermost.com/contribute/server/developer-setup/). If you have a remote mattermost server you want to develop to you can skip this step.
  73. 2. Setup your Mattermost plugin development environment by following the [Plugin Developer setup guide](https://developers.mattermost.com/integrate/plugins/developer-setup/).
  74. 3. Clone the repository:
  75. ```bash
  76. git clone https://github.com/mattermost/mattermost-plugin-agents.git
  77. cd mattermost-plugin-agents
  78. ```
  79. 4. **Optional**. If you are developing to a remote server, setup environment variables to deploy:
  80. ```bash
  81. MM_SERVICESETTINGS_SITEURL=http://localhost:8065
  82. MM_ADMIN_USERNAME=<YOUR_USERNAME>
  83. MM_ADMIN_PASSWORD=<YOUR_PASSWORD>
  84. ```
  85. 5. Run deploy to build the plugin
  86. ```bash
  87. make deploy
  88. ```
  89. ### Other make commands
  90. - Run `make help` for a list of all make commands
  91. - Run `make check-style` to verify code style
  92. - Run `make test` to run the test suite
  93. - Run `make e2e` to run the e2e tests
  94. - Run `make evals` to run prompt evaluations interactively (with TUI)
  95. - Run `make evals-ci` to run prompt evaluations in CI mode (non-interactive)
  96. ### Benchmark Tests
  97. The streaming code has benchmark tests to measure performance and detect regressions:
  98. ```bash
  99. # Run all streaming benchmarks
  100. go test -bench=. -benchmem ./llm/... ./streaming/...
  101. # Run specific benchmark
  102. go test -bench=BenchmarkStreamToPost -benchmem ./streaming/...
  103. # Run with CPU profiling
  104. go test -bench=BenchmarkReadAll -cpuprofile=cpu.prof ./llm/...
  105. ```
  106. Benchmarks cover:
  107. - `ReadAll()` stream consumption with varying response sizes
  108. - `TokenUsageLoggingWrapper` interception overhead
  109. - `StreamToPost()` full processing pipeline with WebSocket events
  110. ### Multi-Provider Evaluation Support
  111. The evaluation system supports testing with multiple LLM providers: OpenAI, Anthropic, and Azure OpenAI. By default, evaluations run against all providers, but you can target specific ones:
  112. ```bash
  113. # Run with all providers (default)
  114. make evals
  115. # Run with only Anthropic
  116. LLM_PROVIDER=anthropic make evals
  117. # Run with OpenAI and Azure
  118. LLM_PROVIDER=openai,azure make evals
  119. # Use a specific model
  120. ANTHROPIC_MODEL=claude-opus-5-5 make evals
  121. ```
  122. See `cmd/evalviewer/README.md` for complete documentation on environment variables and configuration options.
  123. ## License
  124. This repository is licensed under [Apache-2](./LICENSE.txt), except for the [enterprise](enterprise) directory which is licensed under the [Mattermost Source Available License](enterprise/LICENSE). See [Mattermost Source Available License](https://docs.mattermost.com/overview/faq.html#mattermost-source-available-license) to learn more.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.