Trello MCP Server with Python

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

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