get_board
Retrieve a specific Trello board by its ID to access board details and manage tasks within the Trello MCP Server.
Instructions
Retrieves a specific board by its ID.
Args:
board_id (str): The ID of the board to retrieve.
Returns:
TrelloBoard: The board object containing board details.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| board_id | Yes |
Implementation Reference
- server/tools/board.py:20-39 (handler)The MCP tool handler function 'get_board' that retrieves a Trello board by ID, calls the BoardService, logs activity, and handles errors.async def get_board(ctx: Context, board_id: str) -> TrelloBoard: """Retrieves a specific board by its ID. Args: board_id (str): The ID of the board to retrieve. Returns: TrelloBoard: The board object containing board details. """ try: logger.info(f"Getting board with ID: {board_id}") result = await service.get_board(board_id) logger.info(f"Successfully retrieved board: {board_id}") return result except Exception as e: error_msg = f"Failed to get board: {str(e)}" logger.error(error_msg) await ctx.error(error_msg) raise
- server/tools/tools.py:11-11 (registration)Registration of the 'get_board' tool in the MCP server via mcp.add_tool.mcp.add_tool(board.get_board)
- server/services/board.py:19-30 (helper)Supporting BoardService.get_board method that makes the Trello API call to fetch the board data and parses it into a TrelloBoard model.async def get_board(self, board_id: str) -> TrelloBoard: """Retrieves a specific board by its ID. Args: board_id (str): The ID of the board to retrieve. Returns: TrelloBoard: The board object containing board details. """ response = await self.client.GET(f"/boards/{board_id}") return TrelloBoard(**response)