israel-tax-refund

Hebrew supported — If you speak Hebrew, Claude will respond in Hebrew. See also: README בעברית

An agentic Claude Code workspace that automates the Israeli tax refund process. Clone the repo, open a Claude session, and let Claude navigate the tax authority website on your behalf using Playwright.

How It Works

• You clone this repo and open it in Claude Code
• Claude guides you through entering your personal and financial details
• A Playwright MCP server controls a real browser session
• Claude navigates the Israeli Tax Authority (Misim) portal, fills in your information, and submits the refund request on your behalf

No coding required on your end.

Setup

3. Configure the Playwright MCP server in Claude Code

Add the following to your Claude Code MCP settings (~/.claude/settings.json):

Or run the setup command inside Claude Code:

Usage

Once inside Claude Code, simply tell Claude:

"Help me apply for a tax refund"

• Ask for the required personal information (ID number, income details, bank account for refund)
• Open a browser via Playwright
• Log in to the tax authority portal using your credentials
• Fill out and submit the refund form
• Report back with confirmation details

What You'll Need to Have Ready

• Israeli ID number (מספר זהות)
• Tax year you are claiming for
• Income details (תלושי שכר / Form 106)
• Bank account number for the refund deposit
• Access to your email/phone for OTP verification during login