israel-tax-refund

Guides the user through a step-by-step interview to gather all information needed to file an Israeli tax refund (החזר מס / Form 135). Use when the user wants to start a tax refund claim, collect their tax data, or fill in their Form 106 details.

Guides the user through claiming a tax refund for charitable donations (תרומות) made to Israeli approved organizations (עמותות מאושרות לפי סעיף 46). Collects donation receipts, validates them, updates the filer data file, and explains the online submission process via the Misim portal. Run this as part of the collect-info flow, or standalone before form-fill.

Scans the user's Gmail for Israeli tax-relevant documents (Form 106 / טופס 106, Form 867 / טופס 867, National Insurance certificates, donation receipts, pension statements) and extracts pre-fill data for the tax refund interview. Run this before collect-info to auto-populate known fields.

Uses Playwright to log in to Bank Hapoalim (בנק הפועלים) online banking and extract Form 867 (אישור ניכוי מס שנתי) data for a given tax year. Run this during the collect-info flow to auto-populate investment income fields. Requires the Playwright MCP server to be configured.

Main orchestrator for the Israeli tax refund process. Guides the user end-to-end through all phases: data collection, authentication, and form submission. Start here when the user wants to file a tax refund.

Opens the user's Israeli bank portal via Playwright and automatically extracts branch and account numbers for the tax refund deposit. Run during the collect-info flow to auto-populate the bank account section (Step 9). Requires the Playwright MCP server.

Uses Playwright to log in to the Israeli Tax Authority (Misim) portal and retrieve every available Form 106 (טופס 106) employer salary certificate. Defaults to importing ALL years the portal exposes (usually 2017 forward, up to 9 years) in a single run — downloads each PDF and extracts fields 158, 042, 045, 218, employer name/ID, and months worked. Accepts an optional year filter for a single year or subset. Run during the collect-info flow to auto-populate the employment income section across multiple years in one pass.

Fetches IDF mandatory service record from the IDF certificates portal (ishurim.prat.idf.il) to extract service start and discharge dates, calculate total service length, and determine tax credit eligibility. Run during the collect-info flow to auto-populate the military service section (Step 7c). For reserve duty (מילואים) income, use the miluim-import skill instead.

Fetches IDF reserve duty (מילואים) records from the Miluim portal (miluim.idf.il) to extract Form 3010 reserve duty pay and tax withheld for a given tax year. Run during the collect-info flow to auto-populate the reserve duty income section.

Fills and submits Form 135 (בקשה להחזר מס) on the Israeli Tax Authority (Misim) portal using the saved filer data file. Run this as Phase 3 of the tax-refund flow, after the login skill has authenticated the user. Requires the Playwright MCP server and an active authenticated session.

Retrieves saved credentials from Chrome's password manager (macOS Keychain) for Israeli tax-related portals — misim.gov.il, IDF portals, Bank Hapoalim, and others. Decrypts Chrome's AES-128-CBC encrypted passwords using the macOS Keychain master key. Returns credentials for the current session only — nothing is written to disk.

Opens the Israeli Tax Authority (Misim) portal via Playwright and guides the user through authentication with their Israeli ID and OTP. Run this as Phase 2 of the tax-refund flow, after collect-info has saved the filer's data file. Requires the Playwright MCP server.

Reads recent SMS/iMessage texts from the macOS Messages app and extracts 2FA/OTP codes. Requires Full Disk Access for Terminal. Called by other skills (login, idf-service, hapoalim-import, miluim-import) to auto-fill OTP fields without user copy-paste.