jules_set_cookies
Configure browser authentication by setting cookies from JSON or string format to maintain session persistence in Google Jules AI coding workflows.
Instructions
Set browser cookies from string or JSON for authentication
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| cookies | Yes | Cookies as JSON string or cookie string format | |
| format | No | Format of input cookies (default: json) |
Implementation Reference
- src/index.ts:1658-1695 (handler)The handler function that implements the jules_set_cookies tool. Parses cookies from JSON or string input, adds them to the browser page context using Playwright's addCookies, and saves to file if configured.private async setCookies(args: any) { const { cookies, format = 'json' } = args; const page = await this.getPage(); try { let cookiesToSet: Array<{name: string, value: string, domain: string}> = []; if (format === 'string') { cookiesToSet = this.parseCookiesFromString(cookies); } else { const parsed = JSON.parse(cookies); cookiesToSet = Array.isArray(parsed) ? parsed : [parsed]; } await page.context().addCookies(cookiesToSet.map(cookie => ({ name: cookie.name, value: cookie.value, domain: cookie.domain, path: '/', }))); // Save cookies if in cookies mode if (this.config.sessionMode === 'cookies' && this.config.cookiePath) { await this.saveCookiesToFile(cookiesToSet, this.config.cookiePath); } return { content: [ { type: 'text', text: `Successfully set ${cookiesToSet.length} cookies. Session authentication should now work for Google Jules.` } ] }; } catch (error) { throw new Error(`Failed to set cookies: ${error}`); } }
- src/index.ts:320-337 (schema)The input schema definition for the jules_set_cookies tool, registered in the ListTools response.name: 'jules_set_cookies', description: 'Set browser cookies from string or JSON for authentication', inputSchema: { type: 'object', properties: { cookies: { type: 'string', description: 'Cookies as JSON string or cookie string format', }, format: { type: 'string', enum: ['json', 'string'], description: 'Format of input cookies (default: json)', }, }, required: ['cookies'], }, },
- src/index.ts:384-387 (registration)Registration of the jules_set_cookies handler in the CallToolRequestSchema switch statement.return await this.getCookies(args); case 'jules_set_cookies': return await this.setCookies(args); case 'jules_session_info':
- src/index.ts:1035-1067 (helper)Helper function to parse cookie strings in 'name=value; name2=value2' format into Playwright cookie objects, used by the setCookies handler.private parseCookiesFromString(cookieString: string): Array<{name: string, value: string, domain: string}> { const cookies: Array<{name: string, value: string, domain: string}> = []; // Split by semicolon and process each cookie const parts = cookieString.split(';'); for (let i = 0; i < parts.length; i++) { const part = parts[i].trim(); // Skip domain specifications if (part.startsWith('domain=')) { continue; } // Parse name=value pairs const equalIndex = part.indexOf('='); if (equalIndex > 0) { const name = part.substring(0, equalIndex).trim(); const value = part.substring(equalIndex + 1).trim(); if (name && value) { cookies.push({ name, value, domain: '.google.com' }); } } } console.error(`Parsed ${cookies.length} cookies from string`); return cookies; }