Trello Desktop MCP

Instructions

Implementation Reference

• src/tools/members.ts:54-120 (handler)

  The handler function 'handleTrelloGetUserBoards' performs the logic of fetching user boards using the Trello API client.

  export async function handleTrelloGetUserBoards(args: unknown) {
    try {
      const { apiKey, token, filter } = validateGetUserBoards(args);
      const client = new TrelloClient({ apiKey, token });
      
      const response = await client.getCurrentUser();
      const user = response.data;
      
      const result = {
        summary: `User: ${user.fullName || user.username}`,
        user: {
          id: user.id,
          fullName: user.fullName,
          username: user.username,
          bio: user.bio,
          url: user.url,
          memberType: user.memberType,
          confirmed: user.confirmed
        },
        boards: user.boards?.filter((board: any) => {
          if (filter === 'all') return true;
          if (filter === 'closed') return board.closed;
          return !board.closed; // 'open' or default
        }).map((board: any) => ({
          id: board.id,
          name: board.name,
          description: board.desc || 'No description',
          url: board.shortUrl,
          closed: board.closed,
          lastActivity: board.dateLastActivity,
          permissions: board.prefs?.permissionLevel || 'unknown'
        })) || [],
        organizations: user.organizations?.map((org: any) => ({
          id: org.id,
          name: org.name,
          displayName: org.displayName,
          description: org.desc
        })) || [],
        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 user boards: ${errorMessage}`
          }
        ],
        isError: true
      };
    }
  }

• src/tools/members.ts:6-14 (schema)

  Input validation for 'trello_get_user_boards' tool using Zod.

  const validateGetUserBoards = (args: unknown) => {
    const schema = z.object({
      apiKey: z.string().min(1, 'API key is required'),
      token: z.string().min(1, 'Token is required'),
      filter: z.enum(['all', 'open', 'closed']).optional()
    });
    
    return schema.parse(args);
  };

• src/tools/members.ts:29-52 (registration)

  MCP Tool registration definition for 'trello_get_user_boards'.

  export const trelloGetUserBoardsTool: Tool = {
    name: 'trello_get_user_boards',
    description: 'Get all boards accessible to the current user. This is the starting point for exploring your Trello workspace.',
    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)'
        },
        filter: {
          type: 'string',
          enum: ['all', 'open', 'closed'],
          description: 'Filter boards by status: "open" for active boards, "closed" for archived boards, "all" for both',
          default: 'open'
        }
      },
      required: ['apiKey', 'token']
    }
  };