Monday.com MCP Server

Instructions

Implementation Reference

• src/mcp_server_monday/board.py:99-116 (handler)

  The handler function that executes the core logic for creating a new board group using the Monday.com API.

  async def handle_monday_create_new_board_group(
      monday_client: MondayClient, board_id: str, group_name: str
  ) -> list[types.TextContent]:
      """
      Create a new group in a Monday.com board.
  
      Args:
          monday_client (MondayClient): The Monday.com client.
          board_id (str): The ID of the board.
          group_name (str): The name of the group.
      """
      group = monday_client.groups.create_group(board_id=board_id, group_name=group_name)
      return [
          types.TextContent(
              type="text",
              text=f"Created new group {group_name} in board {board_id}. ID of the new group: {group['data']['create_group']['id']}",
          )
      ]

• src/mcp_server_monday/fastmcp_server.py:110-124 (registration)

  Registers the 'monday_create_board_group' tool (matching 'monday-create-board-group') with FastMCP, providing input schema via args/docstring and delegating to the handler.

  @mcp.tool()
  async def monday_create_board_group(boardId: str, groupName: str) -> str:
      """Create a new group in a Monday.com board.
  
      Args:
          boardId: Monday.com Board ID that the group will be created in.
          groupName: Name of the group to create.
      """
      try:
          client = get_monday_client()
          result = await handle_monday_create_new_board_group(boardId, groupName, client)
          return result[0].text
      except Exception as e:
          return f"Error creating board group: {e}"