About home-office-deduction
home-office-deduction is a skill for calculating home office deductions for self-employed people. It compares the simplified and actual-expense methods and can organize housing costs for Form 8829 review.
Key features
- 01Check regular and exclusive business use
- 02Calculate the business-use percentage
- 03Compare simplified and actual-expense methods
- 04Find and total housing expenses
- 05Export expenses for Form 8829 review
Use cases
- 01Estimate a home office deduction
- 02Compare deduction methods for a tax year
- 03Collect housing expenses for Form 8829 or CPA review
MCP support
The skill uses Wilson tools to find housing transactions, summarize expenses, and export them for Form 8829 or CPA review.
Install
Copy the command and run it in a terminal.
npx skills add https:/ / github.com/ openaccountant/ skills --skill home-office-deductionAfter installing, type/home-office-deductionin Claude Code to confirm it loaded.
Details
From the project READMEHome Office Deduction
Overview
Calculates the home office deduction (Form 8829 or simplified method) for self-employed individuals who use part of their home regularly and exclusively for business. Two methods are available: the simplified method ($5 per square foot) and the actual expense method (percentage of real housing costs).
Wilson Tools Used
transaction_search— Find mortgage/rent, utilities, insurance, and repair transactionsspending_summary— Summarize housing-related expenses for the tax yearexport_transactions— Export housing expenses for Form 8829 or CPA review
Workflow
- Confirm the home office qualifies: the space must be used regularly and exclusively for business.
- Ask for the square footage of the office and the total square footage of the home.
- Calculate the business-use percentage:
office_sq_ft / total_home_sq_ft. - Choose a method:
Method 1: Simplified
- Multiply office square footage by $5/sq ft.
- Maximum: 300 sq ft = $1,500 max deduction.
- No depreciation, no Form 8829 required.
- Enter on Schedule C, Line 30.
Method 2: Actual Expenses (Form 8829)
- Use
transaction_searchto find these expense categories:- Mortgage interest or rent
- Property taxes
- Homeowners/renters insurance
- Utilities (electric, gas, water, internet, phone)
- Repairs and maintenance
- Depreciation of the home (residential, 27.5-year MACRS for the business-use portion)
- Use
spending_summaryto total each category for the tax year. - Multiply each total by the business-use percentage.
- Sum all adjusted amounts. This is the actual expense deduction.
- Compare to the simplified method result and use whichever is larger.
Comparison
| Factor | Simplified | Actual Expenses |
|---|---|---|
| Max deduction | $1,500 | No cap |
| Recordkeeping | Minimal | Must track all housing costs |
| Depreciation | Not allowed | Allowed (but recaptured on sale) |
| Form required | None (report on Schedule C) | Form 8829 |
| Best for | Small offices, simple situations | Large offices, high housing costs |
Without Wilson
- Measure your office space in square feet.
- Simplified method: Multiply sq ft (max 300) by $5. That is your deduction.
- Actual expense method:
- Gather 12 months of mortgage/rent statements, utility bills, insurance declarations, and repair receipts.
- Sum each category for the year.
- Calculate business-use percentage: office sq ft / total home sq ft.
- Multiply each expense category total by the business-use percentage.
- Add all adjusted amounts together.
- Fill out Form 8829 and attach to your Schedule C.
- Compare both methods and use the higher deduction (you can switch methods year to year).
Important Notes
- "Regular and exclusive use" is strictly enforced. A guest bedroom with a desk in the corner does not qualify unless the desk area is used only for business.
- Employees working from home generally cannot claim this deduction (eliminated for W-2 employees under the Tax Cuts and Jobs Act through 2025). Only self-employed individuals qualify.
- If you use actual expenses and claim depreciation on your home, you may owe depreciation recapture tax when you sell.
- The deduction cannot create a business loss. Any excess carries forward to next year.
- If you rent, use your rent payment instead of mortgage interest and property taxes.
- This is not tax advice. Consult a CPA or tax professional for filing decisions.