browser-use/browser-use · error · MissingCookieException

Missing required cookie '{cookie_name}': {cookie_description

Error message

Missing required cookie '{cookie_name}': {cookie_description}

What it means

Error "Missing required cookie '{cookie_name}': {cookie_description}" thrown in browser-use/browser-use.

Source

Thrown at browser_use/skills/service.py:207

		# Check if skill exists in cache
		skill = await self.get_skill(skill_id)
		if skill is None:
			raise ValueError(f'Skill {skill_id} not found in cache. Available skills: {list(self._skills.keys())}')

		# Extract cookie parameters from the skill
		cookie_params = [p for p in skill.parameters if p.type == 'cookie']

		# Build a dict of cookies from the provided cookie list
		cookie_dict: dict[str, str] = {cookie['name']: cookie['value'] for cookie in cookies}

		# Check for missing required cookies and fill cookie values
		if cookie_params:
			for cookie_param in cookie_params:
				is_required = cookie_param.required if cookie_param.required is not None else True

				if is_required and cookie_param.name not in cookie_dict:
					# Required cookie is missing - raise exception with description
					raise MissingCookieException(
						cookie_name=cookie_param.name, cookie_description=cookie_param.description or 'No description provided'
					)

			# Fill in cookie values into parameters
			# Convert parameters to dict first if it's a BaseModel
			if isinstance(parameters, BaseModel):
				params_dict = parameters.model_dump()
			else:
				params_dict = dict(parameters)

			# Add cookie values to parameters
			for cookie_param in cookie_params:
				if cookie_param.name in cookie_dict:
					params_dict[cookie_param.name] = cookie_dict[cookie_param.name]

			# Replace parameters with the updated dict
			parameters = params_dict

View on GitHub (pinned to 6c73fced2f)

Solutions

1. Provide the required cookie in the browser profile before invoking the skill.
2. Log in to the target site so the cookie is set, or sync a cloud profile.

When it happens

Trigger: A skill declares a required cookie that is absent from the browser profile's cookies.

Common situations: Running an authenticated skill without first logging in / syncing the profile cookies.

AI-assisted analysis of browser-use/browser-use@6c73fced2f (2026-08-14). Data as JSON: /api/errors/38095bd9bb1f0fe9. Report an issue: GitHub.