Monday.com MCP Server

Instructions

Implementation Reference

• src/mcp_server_monday/item.py:66-99 (handler)

  Core handler function that builds and executes a GraphQL query to fetch subitems for the given item IDs using the MondayClient, formats the response as JSON text content.

  async def handle_monday_list_subitems_in_items(
      itemIds: list[str],
      monday_client: MondayClient,
  ) -> list[types.TextContent]:
      formatted_item_ids = ", ".join(itemIds)
      get_subitems_in_item_query = f"""query
          {{
              items (ids: [{formatted_item_ids}]) {{
                  subitems {{
                      id
                      name
                      parent_item {{
                          id
                      }}
                      updates {{
                          id
                          body
                      }}
                      column_values {{
                          id
                          text
                          value
                      }}
                  }}
              }}
          }}"""
      response = monday_client.custom._query(get_subitems_in_item_query)
  
      return [
          types.TextContent(
              type="text",
              text=f"Sub-items of Monday.com items {itemIds}: {json.dumps(response)}",
          )
      ]

• src/mcp_server_monday/fastmcp_server.py:225-238 (registration)

  MCP tool registration using @mcp.tool() decorator. Defines the tool name 'monday_list_subitems_in_items', input schema (itemIds: List[str]), docstring description, and calls the core handler.

  @mcp.tool()
  async def monday_list_subitems_in_items(itemIds: List[str]) -> str:
      """List all Sub-items of a list of Monday.com Items.
  
      Args:
          itemIds: List of Monday.com Item IDs to get sub-items for.
      """
      try:
          client = get_monday_client()
          result = await handle_monday_list_subitems_in_items(itemIds, client)
          return result[0].text
      except Exception as e:
          return f"Error listing sub-items: {e}"

• src/mcp_server_monday/fastmcp_server.py:19-30 (schema)

  Import of the handler function from item.py into fastmcp_server.py, necessary for tool registration.

  from mcp_server_monday.item import (
      handle_monday_archive_item,
      handle_monday_create_item,
      handle_monday_create_update_on_item,
      handle_monday_delete_item,
      handle_monday_get_item_by_id,
      handle_monday_get_item_updates,
      handle_monday_list_items_in_groups,
      handle_monday_list_subitems_in_items,
      handle_monday_move_item_to_group,
      handle_monday_update_item,
  )