get_board_details
Retrieve comprehensive details about a Trello board, including its lists and cards, to analyze board structure and content for project management.
Instructions
Get detailed information about a specific Trello board, including its lists and cards. Useful for understanding board structure and content.
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 retrieve (you can get this from list_boards) | |
| includeDetails | No | Include lists and cards in the response for complete board overview |
Implementation Reference
- src/tools/boards.ts:114-184 (handler)The handler function that executes the logic for 'get_board_details' tool.
export async function handleGetBoardDetails(args: unknown) { try { const { apiKey, token, boardId, includeDetails } = validateGetBoard(args); const client = new TrelloClient({ apiKey, token }); const response = await client.getBoard(boardId, includeDetails); const board = response.data; const result = { summary: `Board: ${board.name}`, board: { id: board.id, name: board.name, description: board.desc || 'No description', url: board.shortUrl, lastActivity: board.dateLastActivity, closed: board.closed, permissions: board.prefs?.permissionLevel || 'unknown', ...(includeDetails && { lists: board.lists?.map(list => ({ id: list.id, name: list.name, position: list.pos, closed: list.closed })) || [], cards: board.cards?.map(card => ({ id: card.id, name: card.name, description: card.desc, url: card.shortUrl, listId: card.idList, position: card.pos, due: card.due, closed: card.closed, labels: card.labels?.map(label => ({ id: label.id, name: label.name, color: label.color })) || [] })) || [] }) }, 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 board details: ${errorMessage}` } ], isError: true }; } } - src/tools/boards.ts:85-112 (registration)The MCP Tool definition for 'get_board_details'.
export const getBoardDetailsTool: Tool = { name: 'get_board_details', description: 'Get detailed information about a specific Trello board, including its lists and cards. Useful for understanding board structure and content.', 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 retrieve (you can get this from list_boards)', pattern: '^[a-f0-9]{24}$' }, includeDetails: { type: 'boolean', description: 'Include lists and cards in the response for complete board overview', default: false } }, required: ['apiKey', 'token', 'boardId'] } };