gcontext/browser-cookbook
GitHubInstall

Browser Cookbook

Automate your browser and create recipes for repetitive tasks.

Install the agent
YOU · CLAUDE
export this month's invoices
on it
→
Invoices
Dashboard
←→
billing.acme.com/invoices
PDF
PDF
PDF
→
~/invoices/2026-0712 files
INV-2041.pdf
INV-2042.pdf
INV-2043.pdf
+ 9 more
✓ done
YOU ASK
IT WORKS IN YOUR BROWSER
YOU GET THE FILES

Cost of
repeating

The first run explores and saves a Playwright script. Every run after replays it. No AI, no tokens. When the site changes, the AI steps back in, repairs the script (3 attempts, then it reports), and the next run is cheap again.

1st ask
minutes · AI explores
1× AI
2nd
0
3rd
0
400th
0

Ask it things like

export this month's invoices
pull new CRM leads to CSV
fill this form for every row
download last week's report
check 3 portals for changes
update 40 ticket statuses
IN CLAUDE
claude
❯ /mcp__my_instance__browser_cookbook__new_recipe task: export this month's invoices
● new_recipe("export this month's invoices" )
analyzing task ... no site notes (first contact)
opening billing.acme.com/invoices
logged in via saved session
found invoice table, 12 rows
downloading INV-2041.pdf ... ✓
downloading INV-2042.pdf ... ✓
downloading INV-2043.pdf ...
browser-cookbook● working
IN CHROME
Invoices - Billing×
Dashboard
+
←→↻
🔒billing.acme.com/invoices
B
Invoices
Filter
Export All
Invoice
Date
Amount
Status
Action
INV-2041
Jul 01
$2,340.00
Paid
✓ Downloaded
INV-2042
Jul 03
$1,890.00
Paid
✓ Downloaded
INV-2043
Jul 07
$3,120.00
Paid
⬇ Downloading...
INV-2044
Jul 12
$945.00
Paid
Download PDF
INV-2045
Jul 18
$2,670.00
Pending
Download PDF

Three Actions

browse
Do it now
✓
EXPLORING
–
not saved
new_recipe
Do it + save
✓
EXPLORING
recipe
run_recipe
Do it again
recipe
✓
FAST
Your Chrome.
Your logins.
Playwright scripts
you own.
↺
Site changed?
It repairs itself.

Get Started.

1
Set up gcontext

One-time setup. Already have a gcontext instance? Skip to step 2 ↓

a/Install uv
$curl -LsSf https://astral.sh/uv/install.sh | sh
b/Install gcontext What is gcontext? →
$uv tool install gcontext-ai
c/Create your instance
$gcontext init my_instance

This creates a folder named my_instance. Every step below runs inside it.

2
Install the agent
a/Add the agent to your instance
$cd <instance_name>
$gcontext add browser-cookbook

<instance_name> is the folder from step 1 (e.g. my_instance).

b/Start the server
$gcontext up .
c/Connect your client
connect (once per client)
Claude Code
Cursor
Codex
claude mcp add --transport http <instance_name> http://127.0.0.1:4242/mcp
"<instance_name>": {"url": "http://127.0.0.1:4242/mcp"} in ~/.cursor/mcp.json
[mcp_servers.<instance_name>] url = "http://127.0.0.1:4242/mcp" in ~/.codex/config.toml
Full steps per client:gcontext connect

Claude Desktop: add the server URL to claude_desktop_config.json manually.

d/Run setup inside your client
/mcp__<instance_name>__browser_cookbook__setup

Setup asks one question: which Chrome the agent should drive (your daily profile or a dedicated instance).

3
First steps
a/Browse once
terminal
$ /mcp__<instance_name>__browser_cookbook__browse task: export this month's invoices
opening billing.acme.com/invoices
logged in via saved Chrome session
found invoice table, 12 rows
downloading INV-2041.pdf ... done
downloading INV-2042.pdf ... done
... 10 more
saved to ~/invoices/2026-07/
b/Save as a recipe
terminal
$ /mcp__<instance_name>__browser_cookbook__new_recipe task: export monthly invoices
analyzing task, checking site knowledge
exploring + recording actions
proposing script (47 lines), user approves
testing recipe ... passed
saved recipes/export-monthly-invoices/
c/Run the recipe
terminal
$ /mcp__<instance_name>__browser_cookbook__recipe_export_monthly_invoices
running recipes/export-monthly-invoices/script.py
12 files downloaded
done, 4s, 0 tokens

Requirements: macOS, Linux, or Windows. Python 3.11+. Google Chrome. An MCP client (Claude Code, Cursor, Codex). No playwright install step: the agent drives your own Chrome.

Something broke? Open an issue.