create_checklist
Add a new checklist to a Trello card to organize tasks and track progress. Specify card ID, checklist name, and optional position.
Instructions
Create a new checklist on a card.
Args:
card_id (str): The ID of the card to create the checklist on
name (str): The name of the checklist
pos (Optional[str]): The position of the checklist (top, bottom, or a positive number)
Returns:
Dict: The created checklist data
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| card_id | Yes | ||
| name | Yes | ||
| pos | No |
Implementation Reference
- server/tools/checklist.py:41-53 (handler)MCP tool handler for create_checklist: thin wrapper that delegates to ChecklistService.async def create_checklist(card_id: str, name: str, pos: str | None = None) -> Dict: """ Create a new checklist on a card. Args: card_id (str): The ID of the card to create the checklist on name (str): The name of the checklist pos (Optional[str]): The position of the checklist (top, bottom, or a positive number) Returns: Dict: The created checklist data """ return await service.create_checklist(card_id, name, pos)
- server/tools/tools.py:30-38 (registration)Registration of checklist tools including create_checklist in the MCP tool registry.# Checklist Tools mcp.add_tool(checklist.get_checklist) mcp.add_tool(checklist.get_card_checklists) mcp.add_tool(checklist.create_checklist) mcp.add_tool(checklist.update_checklist) mcp.add_tool(checklist.delete_checklist) mcp.add_tool(checklist.add_checkitem) mcp.add_tool(checklist.update_checkitem) mcp.add_tool(checklist.delete_checkitem)
- server/services/checklist.py:41-58 (helper)ChecklistService method implementing the core logic: constructs payload and calls Trello API to create checklist.async def create_checklist( self, card_id: str, name: str, pos: str | None = None ) -> Dict: """ Create a new checklist on a card. Args: card_id (str): The ID of the card to create the checklist on name (str): The name of the checklist pos (Optional[str]): The position of the checklist (top, bottom, or a positive number) Returns: Dict: The created checklist data """ data = {"name": name} if pos: data["pos"] = pos return await self.client.POST(f"/checklists", data={"idCard": card_id, **data})