board

name	board
description	Task board for agents. Track work, manage cards across lists.
allowed-tools	mcp__board__board_list, mcp__board__board_add, mcp__board__board_update, mcp__board__board_move, mcp__board__board_delete, mcp__board__board_get

board

Trello-like task board designed for AI agents. Structured JSON output, not human markdown.

Why This Exists

Agents need to track complex work that spans multiple steps. The board provides:

• Persistent state across sessions
• Organized workflow (backlog → todo → in_progress → done)
• Priority tracking
• Labels for categorization

Quick Reference

Task	Tool	Example
See board	board_list	board_list({})
Create card	board_add	board_add({ title: "Fix bug" })
Update card	board_update	board_update({ id, priority: "high" })
Move card	board_move	board_move({ id, list: "done" })
Delete card	board_delete	board_delete({ id })
Get details	board_get	board_get({ id })

Default Lists

List	Purpose
backlog	Ideas, future work
todo	Planned for current session
in_progress	Currently working on
blocked	Waiting on something
done	Completed

Priorities

• low - Nice to have
• medium - Normal priority (default)
• high - Important
• critical - Urgent

Typical Workflow

Starting Work

board_list({})                    // See current state
board_add({ title: "Task 1" })    // Add new card
board_move({ id, list: "todo" })  // Move to todo

During Work

board_move({ id, list: "in_progress" })  // Start working
board_update({ id, labels: ["bug"] })    // Add context
board_move({ id, list: "done" })         // Complete

Filtering

board_list({ list: "in_progress" })      // Current work only
board_list({ priority: "high" })         // High priority
board_list({ labels: ["bug"] })          // Bugs only
board_list({ search: "auth" })           // Search text

Output Format

All tools return structured JSON:

{
  "board": "Board",
  "lists": [{ "id": "todo", "name": "To Do", "cardCount": 3 }],
  "cards": [{ "id": "...", "title": "...", "list": "...", "priority": "..." }],
  "total": 3
}

Storage

Data persists in .board/board.json in the project root.