TaskBoard

You can manage TaskBoardAI kanban boards through a Model Context Protocol (MCP) server. The MCP server lets you list, create, read, update, and delete boards from any MCP-enabled client or agent, enabling seamless collaboration and automation.

How to use

Interact with the MCP server to manage boards from your agent or tooling. Start the MCP server, then issue standard MCP actions such as listing boards, creating a new board, retrieving a board by name, updating progress, or deleting a board.

Starting the MCP server enables you to perform operations from your MCP client. You can run the MCP server standalone to manage boards, or start both the board server and the MCP server in tandem.

Common workflows you can perform via MCP include listing all boards, creating a new board, fetching details for a specific board, updating content, and deleting a board. These actions are designed to be simple to script or orchestrate within automation pipelines.

How to install

Prerequisites: ensure you have Node.js and npm installed on your system.

Option A: Install via npm (recommended) 1) Install globally for command-line access 2) Install locally in your project

npm install -g taskboardai

npm install taskboardai

Starting the MCP server and running with boards

If you installed via npm, you can start the MCP server on its own or start both servers together.

# Start only the MCP server
taskboard-mcp

# Start both the board server and MCP server
taskboard-all

Starting from the repository version

If you cloned the repository to work with a development version, use the included startup scripts.

# Start only the MCP server
./_start_mcp

# Start both boards and MCP servers
./_start_all

Access and usage with MCP clients

The MCP server provides endpoints your MCP clients can call to manage boards. Typical actions you can perform include listing boards, creating a board, retrieving details for a specific board, updating a board, and deleting a board.

Using with Agents

Once configured, you can ask your agent to perform MCP actions such as: Show me all my kanban boards; Create a new kanban board called 'Project X'; Show me the details of Project X; Update the Project X board with progress; Delete the Project X board.

Webhook and integration notes

Webhooks are supported to trigger external services on board events, enabling real-time updates and automation across your toolchain.

Notes on model context and board usage

MCP-enabled clients rely on the board context to shape actions. You can manage boards while keeping the project context in sync with your automation workflows.

Security considerations

Treat MCP endpoints as you would any API: protect access with appropriate authentication and limit permissions to only what is needed for your workflow.

Available tools

mcp_server

Model Context Protocol server that enables managing kanban boards via MCP for integration with agents and automation tools.

webhooks

Webhook integration to trigger external services on board events and provide real-time updates.