Monday.com MCP Server

Instructions

Implementation Reference

• src/mcp_server_monday/board.py:21-55 (handler)

  The core handler function that implements the logic for retrieving board columns from Monday.com using GraphQL query, processes column settings, and returns formatted text content.

  async def handle_monday_get_board_columns(
      boardId: str, monday_client: MondayClient
  ) -> list[types.TextContent]:
      """Get the Columns of a Monday.com Board."""
      query = f"""
          query {{
              boards(ids: {boardId}) {{
                  columns {{
                      id
                      title
                      type
                      settings_str
                  }}
              }}
          }}
      """
      response = monday_client.custom._query(query)
      for board in response.get("data", {}).get("boards", []):
          for column in board["columns"]:
              settings_str = column.pop("settings_str", None)
              if settings_str:
                  if isinstance(settings_str, str):
                      try:
                          settings_obj = json.loads(settings_str)
                          if settings_obj.get("labels"):
                              column["available_labels"] = settings_obj["labels"]
                      except json.JSONDecodeError:
                          pass
  
      return [
          types.TextContent(
              type="text",
              text=f"Got the columns of a Monday.com board:\n{json.dumps(response)}",
          )
      ]

• src/mcp_server_monday/fastmcp_server.py:77-89 (registration)

  Tool registration using FastMCP's @mcp.tool() decorator. This wrapper function initializes the Monday client, calls the core handler, and handles errors, exposing the tool as 'monday-get-board-columns'.

  @mcp.tool()
  async def monday_get_board_columns(boardId: str) -> str:
      """Get the Columns of a Monday.com Board.
  
      Args:
          boardId: Monday.com Board ID that the Item or Sub-item is on.
      """
      try:
          client = get_monday_client()
          result = await handle_monday_get_board_columns(boardId, client)
          return result[0].text
      except Exception as e:
          return f"Error getting board columns: {e}"