get_lists
Retrieve workflow columns from a Trello board to view and manage task organization stages like "To Do" and "Done".
Instructions
Get all lists in a specific Trello board. Use this to see the workflow columns (like "To Do", "In Progress", "Done") in a board.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| apiKey | Yes | Trello API key (automatically provided by Claude.app from your stored credentials) | |
| token | Yes | Trello API token (automatically provided by Claude.app from your stored credentials) | |
| boardId | Yes | The ID of the board to get lists from (you can get this from list_boards) | |
| filter | No | Filter lists by status: "open" for active lists, "closed" for archived lists, "all" for both | open |
Implementation Reference
- src/tools/boards.ts:216-262 (handler)The handleGetLists function executes the logic to retrieve Trello lists for a given board.
export async function handleGetLists(args: unknown) { try { const { apiKey, token, boardId, filter } = validateGetBoardLists(args); const client = new TrelloClient({ apiKey, token }); const response = await client.getBoardLists(boardId, filter); const lists = response.data; const result = { summary: `Found ${lists.length} ${filter} list(s) in board`, boardId, lists: lists.map(list => ({ id: list.id, name: list.name, position: list.pos, closed: list.closed, subscribed: list.subscribed })), rateLimit: response.rateLimit }; return { content: [ { type: 'text' as const, text: JSON.stringify(result, null, 2) } ] }; } catch (error) { const errorMessage = error instanceof z.ZodError ? formatValidationError(error) : error instanceof Error ? error.message : 'Unknown error occurred'; return { content: [ { type: 'text' as const, text: `Error getting lists: ${errorMessage}` } ], isError: true }; } } - src/tools/boards.ts:186-214 (schema)The getListsTool constant defines the MCP tool registration, name, and input schema for 'get_lists'.
export const getListsTool: Tool = { name: 'get_lists', description: 'Get all lists in a specific Trello board. Use this to see the workflow columns (like "To Do", "In Progress", "Done") in a board.', inputSchema: { type: 'object', properties: { apiKey: { type: 'string', description: 'Trello API key (automatically provided by Claude.app from your stored credentials)' }, token: { type: 'string', description: 'Trello API token (automatically provided by Claude.app from your stored credentials)' }, boardId: { type: 'string', description: 'The ID of the board to get lists from (you can get this from list_boards)', pattern: '^[a-f0-9]{24}$' }, filter: { type: 'string', enum: ['all', 'open', 'closed'], description: 'Filter lists by status: "open" for active lists, "closed" for archived lists, "all" for both', default: 'open' } }, required: ['apiKey', 'token', 'boardId'] } };