Trello Desktop MCP

Instructions

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