The mcp-boards-nk server enables full management of Mattermost Boards (Focalboard) via natural language through Claude or other MCP-compatible clients.
List Teams (list_teams): Retrieve all Mattermost teams/workspaces.
List Boards (list_boards): List all boards within a specific team.
Get Board Details (get_board): Fetch detailed board information, including properties, columns, and option values.
List Cards (list_cards): Retrieve cards/tasks from a board, with optional filtering and pagination.
Get Card Details (get_card): Fetch full details of a specific card.
Create Card (create_card): Create a new card with a title, content/description, and custom properties.
Update Card (update_card): Modify an existing card's title, content, or properties.
Delete Card (delete_card): Remove a card from a board.
Add Comment (add_comment): Post a comment on a specific card.
List Views (list_views): View all available board views (kanban, table, gallery, etc.).
List Board Members (list_board_members): See all members associated with a board.
Provides tools for managing Mattermost Boards (Focalboard), including listing teams, boards, cards, views, and members, as well as creating, updating, and deleting cards.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@mcp-boards-nk list all boards in the design team"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
MCP server for Mattermost Boards (Focalboard) — lets Claude and other MCP-compatible clients list teams, boards, and cards, create and update tasks, add comments, and more — all via natural language.
The first MCP server with full support for Mattermost Boards (Focalboard).
Tool | Description |
| List all Mattermost teams |
| List boards in a team |
| Get board details including properties and columns |
| List cards/tasks in a board. Optional filter: |
| Get full card details |
| Create a new card with title, properties and content |
| Update title, properties or content of an existing card |
| Delete a card from a board |
| Add a comment to a card |
| List views of a board (kanban, table, gallery…) |
| List members of a board |
Related MCP server: Another Planka MCP
Self-hosted Mattermost instance with the Boards (Focalboard) plugin enabled
A Mattermost Personal Access Token
Run the interactive setup wizard — it configures Claude Desktop or Claude Code automatically:
npx --prefer-online --package=mcp-boards-nk mcp-boards-nk-setup
The wizard will ask you:
Which client to install to (Claude Desktop / Claude Code global or project)
Your Mattermost URL
Your personal access token
You can install to multiple clients in a single run.
npx --prefer-online --package=mcp-boards-nk mcp-boards-nk-setup --uninstallSelect which clients to remove the MCP from and the wizard handles the rest.
Variable | Required | Description |
| ✅ | Base URL of your Mattermost instance (no trailing slash) |
| ✅ | Personal access token of the Mattermost user |
Go to Profile → Security → Personal Access Tokens → Edit
Click Create Token, give it a name, copy the value
If the option doesn't appear, ask your Mattermost admin to enable it: System Console → User Management → Users → Manage Roles → Allow this account to generate personal access tokens
When creating or updating cards, pass properties as a JSON object using the IDs defined in the board.
Use get_board to see all available property IDs and their option values.
Example:
{
"prop_estado": "opt_pendiente"
}MIT
Agrega un comentario a una card
Inputs: board_id (required), card_id (required), content (required).
Crea una nueva card/tarea en un board
Inputs: board_id (required), title (required), properties, content.
Elimina una card de un board
Inputs: board_id (required), card_id (required).
Obtiene detalles de un board incluyendo sus propiedades/columnas
Inputs: board_id (required).
Obtiene el detalle completo de una card
Inputs: card_id (required).
Lista los miembros de un board
Inputs: board_id (required).
Lista los boards de un team
Inputs: team_id (required).
Lista las cards/tareas de un board
Inputs: board_id (required), page, per_page.
Lista todos los teams/workspaces de Mattermost Boards
Inputs: _dummy.
Lista las vistas de un board (tablero, tabla, galería, etc.)
Inputs: board_id (required).
Actualiza el título, propiedades o contenido de una card existente
Inputs: card_id (required), title, properties, content.
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Scored across 11 tools
Each tool clearly targets a distinct resource: cards, boards, members, teams, views, comments. No overlapping responsibilities, making it easy for an agent to select the right tool.
All tools follow a consistent verb_noun pattern in snake_case (e.g., create_card, list_boards). The verb is always imperative, and nouns are singular/plural appropriately, providing a predictable interface.
With 11 tools, the server is well-scoped for a board management system. Each tool covers a necessary operation without unnecessary duplication, striking a good balance between simplicity and functionality.
The server covers major CRUD operations for cards and provides board, member, view, team, and comment access. Minor gaps like board deletion or card reordering are missing, but the core workflows are fully supported.
One MCP server for the services your AI needs: memory, files, Microsoft 365, kanban and more.
MCP server for generating rough-draft project plans from natural-language prompts.
Task & board management for AI agents + humans. Kanban, comments, digests via MCP.
