Trello MCP Server with Python

Instructions

Args:
    list_id (str): The ID of the list whose cards to retrieve.

Returns:
    List[TrelloCard]: A list of card objects.

Implementation Reference

• server/tools/card.py:42-60 (handler)

  MCP tool handler for 'get_cards': retrieves cards from a Trello list using CardService, logs actions, handles errors with ctx.error.

  async def get_cards(ctx: Context, list_id: str) -> List[TrelloCard]:
      """Retrieves all cards in a given list.
  
      Args:
          list_id (str): The ID of the list whose cards to retrieve.
  
      Returns:
          List[TrelloCard]: A list of card objects.
      """
      try:
          logger.info(f"Getting cards for list: {list_id}")
          result = await service.get_cards(list_id)
          logger.info(f"Successfully retrieved {len(result)} cards for list: {list_id}")
          return result
      except Exception as e:
          error_msg = f"Failed to get cards: {str(e)}"
          logger.error(error_msg)
          await ctx.error(error_msg)
          raise

• server/tools/tools.py:25-25 (registration)

  Registration of the 'get_cards' tool with the MCP server via mcp.add_tool.

  mcp.add_tool(card.get_cards)

• server/services/card.py:31-42 (helper)

  CardService method that implements the core logic by calling Trello API to fetch cards from a list.

  async def get_cards(self, list_id: str) -> List[TrelloCard]:
      """Retrieves all cards in a given list.
  
      Args:
          list_id (str): The ID of the list whose cards to retrieve.
  
      Returns:
          List[TrelloCard]: A list of card objects.
      """
      response = await self.client.GET(f"/lists/{list_id}/cards")
      return [TrelloCard(**card) for card in response]