mcpbeat

Expense Categorization

seb1n/expense-categorization

Classify expenses by category, department, and tax deductibility from transaction data

2k tokens
context cost
the whole folder, loaded on every use
1
files
instructions only
0
copies elsewhere
how many repositories repackaged it
143
stars on the repo
on the repository, not the skill itself

Install

one command, takes just this skill from the repository
npx skills add https://github.com/seb1n/awesome-ai-agent-skills --skill expense-categorization

The instruction itself

8 sections, as written by the author

Expense Categorization

Automatically classify business expenses into accounting categories, assign department cost centers, and flag tax-deductible items from raw transaction data. This skill processes credit card statements, bank feeds, and expense reports to produce clean, categorized output suitable for bookkeeping, tax preparation, and spend analytics.

Workflow

  • Receive Expense Data

Accept transaction data as CSV, bank statement text, or structured records. Required fields: date, amount, and description or merchant name. Optional fields: card last four digits, employee name, department, receipt notes. Normalize date formats and currency to a consistent standard.

  • Parse Description and Merchant

Extract the merchant name from the transaction descriptor, stripping out authorization codes, location suffixes, and card network prefixes. Map common merchant name variations to canonical names (e.g., "AMZN MKTP US" → "Amazon", "GOOGLE *GSUITE" → "Google Workspace"). Use the merchant category code (MCC) when available as a secondary signal.

  • Classify Expense Category

Assign each transaction to a primary category based on merchant identity, MCC, description keywords, and amount patterns. Standard categories: Travel & Lodging, Meals & Entertainment, Software & SaaS, Office Supplies, Professional Services, Advertising, Utilities, Insurance, Shipping & Postage, Equipment, Training & Education, Miscellaneous.

  • Assign Department and Cost Center

Route each expense to the appropriate department based on the cardholder, project codes in the description, or pre-configured rules. Apply default department assignments for known merchants (e.g., AWS charges → Engineering, HubSpot → Marketing).

  • Flag Tax-Deductible Items

Mark expenses that qualify for tax deduction based on category and business purpose. Apply IRS rules for meals (50% deductible for business meals, 100% for company events), home office, vehicle mileage, and professional development. Flag items that need substantiation — receipts, business purpose memo, or attendee lists.

  • Generate Categorized Summary

Output a categorized transaction list with totals by category, department, and tax status. Highlight any transactions that couldn't be confidently categorized (confidence < 80%) for manual review.

Usage

Provide transaction data in any tabular format. Specify any custom category mappings, department rules, or tax jurisdiction if not US federal.

Example prompt:

> Categorize these November credit card transactions for our 15-person startup. We have Engineering, Marketing, and Operations departments. Flag tax-deductible items. Here's the CSV: [paste transactions]

Examples

Example 1: Monthly Credit Card Categorization

Input (CSV):

date,amount,description,cardholder
2024-11-02,249.00,GITHUB TEAM PLAN,Sarah Chen
2024-11-03,1450.00,UNITED AIRLINES 0167823,Mike Torres
2024-11-03,189.50,MARRIOTT HOTEL CHI,Mike Torres
2024-11-05,42.67,UBER TRIP FKJE83,Mike Torres
2024-11-08,156.00,GOOGLE ADS 8834721,Lisa Park
2024-11-12,89.99,ZOOM VIDEO COMMS,Sarah Chen
2024-11-14,67.32,DOORDASH DASHER TIP,Operations
2024-11-18,4200.00,DELL TECHNOLOGIES,Sarah Chen
2024-11-22,350.00,COURSERA BUSINESS,Mike Torres
2024-11-25,23.45,STAPLES #1284,Operations

Output:

| Date | Amount | Merchant | Category | Department | Tax Deductible | Notes |

|------------|-----------|------------------|-----------------------|-------------|----------------|-------------------------------|

| 2024-11-02 | $249.00 | GitHub | Software & SaaS | Engineering | Yes (100%) | |

| 2024-11-03 | $1,450.00 | United Airlines | Travel & Lodging | Engineering | Yes (100%) | Business travel |

| 2024-11-03 | $189.50 | Marriott | Travel & Lodging | Engineering | Yes (100%) | Business travel |

| 2024-11-05 | $42.67 | Uber | Travel & Lodging | Engineering | Yes (100%) | Ground transport |

| 2024-11-08 | $156.00 | Google Ads | Advertising | Marketing | Yes (100%) | |

| 2024-11-12 | $89.99 | Zoom | Software & SaaS | Engineering | Yes (100%) | |

| 2024-11-14 | $67.32 | DoorDash | Meals & Entertainment | Operations | Yes (50%) | Needs business purpose memo |

| 2024-11-18 | $4,200.00 | Dell | Equipment | Engineering | Depreciation | Section 179 eligible |

| 2024-11-22 | $350.00 | Coursera | Training & Education | Engineering | Yes (100%) | |

| 2024-11-25 | $23.45 | Staples | Office Supplies | Operations | Yes (100%) | |

Summary:

| Category | Total | % of Spend |

|-----------------------|-----------|------------|

| Equipment | $4,200.00 | 61.5% |

| Travel & Lodging | $1,682.17 | 24.6% |

| Training & Education | $350.00 | 5.1% |

| Software & SaaS | $338.99 | 5.0% |

| Advertising | $156.00 | 2.3% |

| Meals & Entertainment | $67.32 | 1.0% |

| Office Supplies | $23.45 | 0.3% |

| Total | $6,817.93 | 100% |

Example 2: Flagging Misclassified Expenses

Input: Review existing categorizations for accuracy.

Output — Correction Report:

| Date | Amount | Merchant | Current Category | Corrected Category | Reason |

|------------|---------|----------------|------------------|------------------------|---------------------------------------------------------|

| 2024-11-07 | $320.00 | WeWork | Office Supplies | Rent & Facilities | Co-working space is rent, not supplies |

| 2024-11-10 | $85.00 | Blue Apron | Office Supplies | Meals & Entertainment | Meal delivery service miscoded |

| 2024-11-16 | $599.00 | Adobe Creative | Training | Software & SaaS | Creative Cloud is a software subscription, not training |

| 2024-11-29 | $175.00 | Lyft Business | Miscellaneous | Travel & Lodging | Business ground transportation should be under travel |

Impact: Reclassifying these 4 transactions shifts $1,179.00 across categories, affecting department budgets and tax deduction calculations. The Adobe correction reduces the Training & Education deduction by $599 and increases the Software & SaaS deduction by the same amount.

Best Practices

  • Build and maintain a merchant-to-category mapping dictionary. Start with the 50 most common merchants in your transaction history and expand over time.
  • Set a confidence threshold (recommended: 80%) below which transactions are routed for human review rather than auto-categorized.
  • Review categorization accuracy monthly — track precision and recall by category to identify systematic errors.
  • Always separate personal and business expenses before categorization. Flag transactions from personal merchants (grocery stores, streaming services) for review.
  • Apply consistent rules for edge cases like meals during travel (Travel vs. Meals) and document the policy.
  • Keep tax deductibility rules current with the applicable tax year — IRS rules change frequently for categories like meals, entertainment, and vehicle expenses.

Edge Cases

  • Split transactions: A single purchase at a warehouse store may include both office supplies and snacks. If the receipt is available, split into separate line items with distinct categories.
  • Foreign currency transactions: Categorize based on the merchant and purpose, not the currency. Record both the original currency amount and the converted amount. Watch for duplicate entries from currency conversion fees.
  • Refunds and chargebacks: Match refunds to the original transaction and apply the same category as a negative entry. Don't create a new "refund" category — it distorts spend analytics.
  • Recurring vs. one-time: Identify recurring charges (same merchant, similar amount, monthly cadence) and flag any that stop unexpectedly or change amount by more than 10%.
  • Ambiguous merchants: When a merchant name maps to multiple possible categories (e.g., Amazon could be office supplies, software, or equipment), use the amount and cardholder's department as tiebreakers. Amounts under $100 from Amazon default to Office Supplies; over $500 default to Equipment.

How to use it

Copy the folder

Take seb1n/expense-categorization from the repository into ~/.claude/skills for personal use, or into .claude/skills inside a project.

Check the name does not clash

The agent identifies a skill by the name field in its header. Two skills with the same name cannot sit side by side — one of them will be ignored.