Trello Desktop MCP

Instructions

Implementation Reference

• src/tools/advanced.ts:415-457 (handler)

  The handler function that executes the Trello get checklists logic.

  export async function handleTrelloGetCardChecklists(args: unknown) {
    try {
      const { apiKey, token, cardId, checkItems, fields } = validateGetCardChecklists(args);
      const client = new TrelloClient({ apiKey, token });
      
      const response = await client.getCardChecklists(cardId, {
        ...(checkItems && { checkItems }),
        ...(fields && { fields })
      });
      const checklists = response.data;
      
      const result = {
        summary: `Found ${checklists.length} checklist(s) for card`,
        cardId,
        checklists: checklists.map(checklist => ({
          id: checklist.id,
          name: checklist.name,
          position: checklist.pos,
          checkItems: checklist.checkItems?.map((item: any) => ({
            id: item.id,
            name: item.name,
            state: item.state,
            position: item.pos,
            due: item.due,
            nameData: item.nameData
          })) || []
        })),
        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 

• src/tools/advanced.ts:380-413 (schema)

  Tool definition including input schema for 'trello_get_card_checklists'.

  export const trelloGetCardChecklistsTool: Tool = {
    name: 'trello_get_card_checklists',
    description: 'Get all checklists and their items for a specific Trello card.',
    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)'
        },
        cardId: {
          type: 'string',
          description: 'ID of the card to get checklists for',
          pattern: '^[a-f0-9]{24}$'
        },
        checkItems: {
          type: 'string',
          enum: ['all', 'none'],
          description: 'Include checklist items in response',
          default: 'all'
        },
        fields: {
          type: 'array',
          items: { type: 'string' },
          description: 'Optional: specific fields to include (e.g., ["name", "pos"])'
        }
      },
      required: ['apiKey', 'token', 'cardId']
    }
  };