Trello Desktop MCP

Instructions

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']
    }
  };