# KanbanTool MCP MCP > KanbanTool connects your workflow board directly into any AI agent. Stop managing tasks by clicking through dashboards and start talking about your project flow. This MCP lets you list boards, track every task's status from 'To Do' to 'Done,' identify bottlenecks using WIP limits, and even assign cards to team members—all in natural conversation. ## Overview - **Category:** productivity - **Price:** Free - **Tags:** kanban, agile, workflow-automation, wip-limits, cycle-time, task-management ## Description You manage complex projects on Kanban boards. But tracking the actual work is messy; sometimes you need to know which card is stuck at review, or who has capacity for a new feature. This MCP lets your AI agent read that board and understand its structure. You can ask it to list all active boards, check how many tasks are in 'In Progress,' and even monitor if a column is exceeding its Work-in-Progress limit. Need to update something? Your agent handles the API calls to create new cards or move existing ones across stages. If you use this connector through Vinkius, your AI client gets access to the full catalog of tools, keeping everything in one place. ## Tools ### archive_task_card Marks a specific task card as completed or removed from the active board view. ### create_task_card Adds a brand-new, empty task card to any specified Kanban board. ### get_board_details Retrieves the full metadata and current list of tasks for a specific Kanban board. ### get_user_profile Retrieves the current user's basic profile information (e.g., name and email). ### get_task_details Fetches all deep details about one single task card, like its description or priority level. ### list_task_activities Displays the entire chronological history and changelog for a selected task card. ### list_boards Gets an index of every Kanban board accessible under your account. ### list_shared_links Shows a list of board links that have been shared with other users or groups. ### list_board_tasks Lists all task cards currently associated with a board, grouped by column. ### update_task_details Modifies specific data points on an existing task, such as changing its title or due date. ## Prompt Examples **Prompt:** ``` Show all boards and the cards in the 'Sprint Board' by column. ``` **Response:** ``` Boards: 4. Sprint Board (42 cards), Product Roadmap (18), Bug Tracker (23), Onboarding (8). Sprint Board columns: Backlog (12 cards), To Do (8, WIP: 10), In Progress (6/5 ⚠️ over WIP), Review (4/4 at limit), Testing (3), Done (9). ⚠️ 'In Progress' exceeds WIP limit by 1. Would you like to move cards or create new ones? ``` **Prompt:** ``` Create a new card 'Implement OAuth' in To Do and move 'API Rate Limiting' to Done. ``` **Response:** ``` Card created! 'Implement OAuth' in To Do (card_4521). Priority: High. Assigned: Sarah Chen. To Do: 8 → 9 cards (WIP: 10). Card moved! 'API Rate Limiting' → Done ✅. In Progress: 6 → 5 cards (WIP restored). Done: 9 → 10 cards. Sprint velocity: 10 cards completed this sprint. ``` **Prompt:** ``` Show team workload and all cards assigned to Sarah. ``` **Response:** ``` Team workload: Sarah Chen — 8 cards (3 In Progress, 2 Review, 3 To Do). Mike Torres — 6 cards (2 In Progress, 4 To Do). Lisa Park — 5 cards (1 In Progress, 2 Testing, 2 To Do). Sarah's cards: 'Implement OAuth' (To Do, High), 'Refactor Auth Module' (In Progress, 2 days), 'Dashboard Redesign' (In Progress, 4 days), 'Write API Docs' (Review), 5 others. Sarah's average cycle time: 3.2 days. ``` ## Capabilities ### Visualize Board Structure Retrieve a list of all available Kanban boards and their overall metadata. ### Manage Task Lifecycle Create, update the status of, or archive specific task cards on any board. ### Monitor Team Workload Identify tasks assigned to a user and view their current workload distribution across different stages. ### Track Board History View the complete activity log or changelog for any specific task card. ## Use Cases ### The Sprint Review Check-in A PM needs to report status. They ask their agent to use 'list_board_tasks' and check the WIP limits on the main sprint board. The agent responds: 'Done is at 9/10 cards; In Progress is at 6/5, over limit by one. We need to move a card.' This prevents scope creep. ### Onboarding a New Team Member An Ops Lead needs to see the overall structure of work. They ask their agent to 'list_boards' first, then select the correct board using 'get_board_details' to give the new hire an immediate overview. ### Investigating a Delay A developer notices a card hasn't moved in days. They ask their agent to run 'list_task_activities' on that specific task, immediately revealing who last touched it and why the work stalled. ### Reassigning Priority Work A manager needs to shift an item from 'To Do.' They ask their agent to use 'update_task_details' on a specific card, changing its priority and assigning it to the correct team member without manual clicks. ## Benefits - Stop guessing about progress. You can use 'list_board_tasks' to get a real-time count of every card in every stage, allowing you to see where the team is bottlenecked right now. - Improve task clarity by using 'get_task_details'. Instead of opening the board and clicking through cards, your agent pulls all the necessary context for one task immediately. - Keep track of who's doing what. You can ask your agent to check workload distribution, making sure no single team member is assigned too many high-priority items. - Maintain a perfect record. Need to know why a card was moved? Use 'list_task_activities' to view the complete history and changelog of that specific task. - Keep things clean. When a project phase ends, use 'archive_task_card' so the board stays focused on only the tasks needing attention. ## How It Works The bottom line is: you talk to your AI client, and it talks to KanbanTool for you. 1. Subscribe to this MCP and provide your KanbanTool subdomain and API Token. 2. Connect your preferred AI agent (like Claude or Cursor) within the Vinkius catalog using these credentials. 3. Directly prompt your agent with a request, such as 'List all boards and tell me which one is over its WIP limit.' The agent handles the rest. ## Frequently Asked Questions **How do I list boards with KanbanTool MCP?** You use the 'list_boards' tool. This simple call gives you a complete index of every single board available under your account, so you know exactly where to start looking. **Does KanbanTool MCP help track task history?** Yes, it does. The 'list_task_activities' tool lets you view the entire changelog for any card, showing every update and who made it over time. **Can I move cards using KanbanTool MCP?** You can modify tasks using 'update_task_details'. Your agent handles moving a card from one column to another stage across the board. **What is the difference between list_board_tasks and get_board_details?** list_board_tasks gives you a focused, grouped count of tasks by column. 'get_board_details' retrieves all the raw metadata for the board itself, which can include things like overall limits or custom field definitions. **How do I check if a user is already assigned to a task?** You use 'get_task_details'. This tool pulls all current information about the card, including who it's currently assigned to and its priority level. **What information does the `get_user_profile` command provide about team members?** It returns detailed user metadata. This includes names, roles, and current status. Your agent can use this data to verify permissions before updating task assignments. **When I use the `create_task_card` tool, what fields must I include for proper tracking?** You need to provide a title, board ID, and at least one column. You can also specify priority levels or assignees during card creation. **What is the process when I run the `archive_task_card` command?** The task remains linked to the board but moves out of active views. Archiving keeps records available for auditing without cluttering the primary workflow columns. **Can I create and move cards across board columns?** Yes. Create new cards in any column, move them across workflow stages, update details, and archive completed cards. Track card history and activity. **Does KanbanTool require a subdomain?** Yes. Each KanbanTool account has a unique subdomain (e.g., `your-team`). Provide the subdomain and API Token. Bearer token against `https://{subdomain}.kanbantool.com/api/v3`. **Can I monitor WIP limits and identify bottlenecks?** Yes. Track how many cards are in each column relative to WIP limits. Identify bottleneck columns where work is accumulating beyond limits.