Yokan Board MCP

Instructions

Implementation Reference

• src/main.py:335-364 (handler)

  The handler function 'update_column_color' that implements the MCP tool logic for updating a column's color. It is registered using the '@app_instance.tool' decorator and wrapped with '@error_handler'.

  @app_instance.tool
  @error_handler
  async def update_column_color(
      board_id: int,
      column_id: str,
      color: str,
      auth: AuthContext,
  ) -> yokan_models.Column:
      """Updates the highlight color of a specified column.
  
      Args:
          board_id (int): The ID of the board containing the column.
          column_id (str): The ID of the column to update.
          color (str): The new highlight color for the column (e.g., "red", "#FF0000").
          auth (AuthContext): The authentication context containing user ID and token.
  
      Returns:
          yokan_models.Column: The updated column object.
      """
      board = await yokan_client.get_board(board_id=board_id, token=auth.token)
      if "columns" not in board.data or column_id not in board.data["columns"]:
          raise McpError(error=ErrorData(code=NOT_FOUND, message="Column not found"))
  
      column = board.data["columns"][column_id]
      column["highlightColor"] = color
  
      await yokan_client.update_board(
          board_id=board_id, name=board.name, data=board.data, token=auth.token
      )
      return yokan_models.Column(**column)