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

Tools available

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

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.

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

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