Skip to main content
Glama

mcp-boards-nk

npm version npm downloads CI License: MIT Node >=18

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).

mcp-boards-nk demo

Tools available

Tool

Description

list_teams

List all Mattermost teams

list_boards

List boards in a team

get_board

Get board details including properties and columns

list_cards

List cards/tasks in a board. Optional filter: filter_property + filter_value (e.g. prop_estado / opt_pendiente)

get_card

Get full card details

create_card

Create a new card with title, properties and content

update_card

Update title, properties or content of an existing card

delete_card

Delete a card from a board

add_comment

Add a comment to a card

list_views

List views of a board (kanban, table, gallery…)

list_board_members

List members of a board

Related MCP server: Another Planka MCP

Requirements

  • Self-hosted Mattermost instance with the Boards (Focalboard) plugin enabled

  • A Mattermost Personal Access Token

Installation

Run the interactive setup wizard — it configures Claude Desktop or Claude Code automatically:

npx --prefer-online --package=mcp-boards-nk mcp-boards-nk-setup

Setup wizard

The wizard will ask you:

  1. Which client to install to (Claude Desktop / Claude Code global or project)

  2. Your Mattermost URL

  3. Your personal access token

You can install to multiple clients in a single run.

MCP connected

Uninstall

npx --prefer-online --package=mcp-boards-nk mcp-boards-nk-setup --uninstall

Select which clients to remove the MCP from and the wizard handles the rest.

Environment variables

Variable

Required

Description

MATTERMOST_URL

Base URL of your Mattermost instance (no trailing slash)

MATTERMOST_TOKEN

Personal access token of the Mattermost user

Getting a Personal Access Token

  1. Go to Profile → Security → Personal Access Tokens → Edit

  2. 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

How to use card properties

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"
}

License

MIT

Install Server
A
license - permissive license
A
quality
B
maintenance

Maintenance

Maintainers
Response time
Release cycle
Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/nikodev-documentacion/mcp-boards-nk'

If you have feedback or need assistance with the MCP directory API, please join our Discord server