create_list
Add a new list to a Trello board to organize tasks and workflows. Specify board ID, list name, and position for structured project management.
Instructions
Creates a new list on a given board.
Args:
board_id (str): The ID of the board to create the list in.
name (str): The name of the new list.
pos (str, optional): The position of the new list. Can be "top" or "bottom". Defaults to "bottom".
Returns:
TrelloList: The newly created list object.Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| board_id | Yes | ||
| name | Yes | ||
| pos | No | bottom |
Implementation Reference
- server/tools/list.py:62-84 (handler)MCP tool handler for create_list: executes the logic, handles errors, logs, and calls the service.
async def create_list( ctx: Context, board_id: str, name: str, pos: str = "bottom" ) -> TrelloList: """Creates a new list on a given board. Args: board_id (str): The ID of the board to create the list in. name (str): The name of the new list. pos (str, optional): The position of the new list. Can be "top" or "bottom". Defaults to "bottom". Returns: TrelloList: The newly created list object. """ try: logger.info(f"Creating list '{name}' in board: {board_id}") result = await service.create_list(board_id, name, pos) logger.info(f"Successfully created list '{name}' in board: {board_id}") return result except Exception as e: error_msg = f"Failed to create list: {str(e)}" logger.error(error_msg) await ctx.error(error_msg) raise - server/tools/tools.py:19-19 (registration)Registers the create_list tool handler with the MCP server.
mcp.add_tool(list.create_list) - server/services/list.py:40-55 (helper)Core service method that performs the actual Trello API call to create a list.
async def create_list( self, board_id: str, name: str, pos: str = "bottom" ) -> TrelloList: """Creates a new list on a given board. Args: board_id (str): The ID of the board to create the list in. name (str): The name of the new list. pos (str, optional): The position of the new list. Can be "top" or "bottom". Defaults to "bottom". Returns: TrelloList: The newly created list object. """ data = {"name": name, "idBoard": board_id, "pos": pos} response = await self.client.POST("/lists", data=data) return TrelloList(**response)