@stithy/mileage
v0.1.1
Published
IRS-audit-proof mileage tracker MCP server — log trips, manage vehicles, export Schedule C — local-first, no subscription
Maintainers
Readme
@stithy/mileage
IRS-audit-proof mileage tracking. Log every business mile in your AI client. Get a Schedule C export at tax time. No app, no cloud, no monthly fee.
Stithy Mileage is a local-first MCP server for tracking deductible vehicle mileage. Every trip lives in a SQLite database on your laptop. Tax-year deductions are computed using the actual IRS standard mileage rate for that year — public-domain data, baked in.
Outcomes
- Stop missing deductions. The average self-employed driver leaves $1,500-$3,000 on the table because they didn't log trips. Talk to Claude. Trip's logged.
- Stop paying $5-10/mo for an app you barely open. MileIQ, Everlance, Driversnote — replaced by one MCP install.
- Audit-proof your log. Per-trip date, miles, category, purpose, start/end, and vehicle — exactly what the IRS asks for during an audit.
- No cloud sync issues. Your trip data lives on your machine. You own it. You back it up.
Install
npx -y @stithy/mileage installThen in your AI client:
add_vehicle name="My truck" make=Toyota model=Tacoma year=2019 is_default=true
add_trip trip_date=2026-04-01 miles=23 category=business purpose="client visit, downtown"At tax time:
annual_deduction year=2026
export_csv from_date=2026-01-01 to_date=2026-12-31Tools (14)
| Tool | Purpose |
|---|---|
| add_vehicle | Register a vehicle (year/make/model optional) |
| list_vehicles | All vehicles, default first |
| set_default_vehicle | Pick which vehicle add_trip uses by default |
| remove_vehicle | Delete (blocks if trips reference it) |
| add_trip | Log a trip — date, miles, category, purpose |
| update_trip | Patch a trip |
| delete_trip | Remove a trip |
| list_trips | List with optional date/category/vehicle filters |
| log_odometer | Year-start / year-end odometer reading |
| list_odometer | All readings for a vehicle, oldest first |
| mileage_summary | Total miles per category for any date range |
| annual_deduction | IRS-rate × miles for a tax year (Schedule C number) |
| export_csv | Audit-trail CSV: Date, Miles, Category, Purpose, Start, End, Vehicle, Notes |
| irs_rates | Reference: IRS standard mileage rates by year |
IRS Standard Mileage Rates Built-In
Categories supported: business, medical, moving (active-duty military only since TCJA 2017), charitable.
Rates baked in for years 2022-2026 (from public IRS publications). When the IRS publishes the next year's rate (typically December), @stithy/mileage ships a one-line update. No subscription required to receive it.
Privacy
Everything is local. Writes to ~/.stithy/mileage.db (override with STITHY_MILEAGE_DB). Nothing is sent to Stithy or any third party. No telemetry. No cloud backup. No analytics.
Compliance Notes
- This tool computes mileage deductions using the IRS standard-mileage method.
- The IRS requires you choose between standard-mileage and actual-expense in Year 1 of placing a vehicle in service. Standard-mileage is binding only if elected first; otherwise you can switch only with restrictions. Talk to your CPA.
- This is software, not tax advice. Always verify deductions with a qualified preparer before filing.
License
BUSL-1.1. Free for personal and commercial use under $1M annual revenue. Commercial license via mcp-marketplace.io.
Maintained
Active maintenance, 7-day bug-fix turnaround, 30-day refund. Annual IRS rate refresh shipped within 1 week of IRS publication. Issues: https://github.com/resolceo-ai/stithy-mcp/issues
