Trello MCP Server with Python

Instructions

Returns:
    List[TrelloBoard]: A list of board objects.

Implementation Reference

• server/tools/board.py:41-56 (handler)

  The MCP tool handler function for 'get_boards' that retrieves all Trello boards for the user via the BoardService, logs the operation, and handles errors by notifying the context.

  async def get_boards(ctx: Context) -> List[TrelloBoard]:
      """Retrieves all boards for the authenticated user.
  
      Returns:
          List[TrelloBoard]: A list of board objects.
      """
      try:
          logger.info("Getting all boards")
          result = await service.get_boards()
          logger.info(f"Successfully retrieved {len(result)} boards")
          return result
      except Exception as e:
          error_msg = f"Failed to get boards: {str(e)}"
          logger.error(error_msg)
          await ctx.error(error_msg)
          raise

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

  Registration of the 'get_boards' tool using mcp.add_tool(board.get_boards) within the register_tools function.

  mcp.add_tool(board.get_boards)

• server/services/board.py:31-41 (helper)

  The BoardService.get_boards method, which performs the actual API call to fetch boards from Trello and parses them into TrelloBoard models. Called by the tool handler.

  async def get_boards(self, member_id: str = "me") -> List[TrelloBoard]:
      """Retrieves all boards for a given member.
  
      Args:
          member_id (str): The ID of the member whose boards to retrieve. Defaults to "me" for the authenticated user.
  
      Returns:
          List[TrelloBoard]: A list of board objects.
      """
      response = await self.client.GET(f"/members/{member_id}/boards")
      return [TrelloBoard(**board) for board in response]