mcpField
F
financial-document-parser

financial-document-parser

github.com/onewave-aiDocuments393422 installsUpdated 1w ago
Repository

About financial-document-parser

financial-document-parser is a skill for extracting and analyzing data from invoices, receipts, and bank or credit card statements. It identifies document types, categorizes expenses, and detects transaction patterns to produce structured summaries.

Key features

  1. 01Identify several financial document types
  2. 02Extract transaction, amount, and date fields
  3. 03Categorize expenses
  4. 04Find duplicate, recurring, and unusual transactions
  5. 05Summarize category totals and flag items
  6. 06Generate CSV- or JSON-ready data

Use cases

  1. 01Extract invoice or receipt details for expense reporting
  2. 02Categorize bank statement transactions and summarize spending
  3. 03Review statements for duplicate charges and unusual amounts

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/onewave-ai/claude-skills --skill financial-document-parser

After installing, type/financial-document-parserin Claude Code to confirm it loaded.

Details

From the project README

Financial Document Parser

Extract structured data from financial documents with automatic categorization and analysis.

When to Use This Skill

Activate when the user:

  • Provides invoices, receipts, or bank statements
  • Asks to "parse this invoice" or "extract data from this receipt"
  • Needs expense categorization
  • Wants to track spending patterns
  • Asks to generate expense reports
  • Mentions financial document analysis
  • Provides PDF or image of financial documents

Instructions

  1. Identify Document Type

    • Invoice (business to business)
    • Receipt (point of sale)
    • Bank statement
    • Credit card statement
    • Expense report
    • Tax document
  2. Extract Core Information

    For Invoices:

    • Invoice number
    • Invoice date and due date
    • Vendor/supplier name and contact
    • Client/recipient name
    • Line items (description, quantity, unit price, total)
    • Subtotal, tax, and grand total
    • Payment terms
    • Payment methods accepted

    For Receipts:

    • Merchant name and location
    • Date and time
    • Items purchased
    • Individual prices
    • Subtotal, tax, total
    • Payment method
    • Last 4 digits of card (if present)

    For Bank/Credit Card Statements:

    • Statement period
    • Account number (last 4 digits)
    • All transactions (date, description, amount, balance)
    • Beginning and ending balance
    • Total credits and debits
    • Fees or interest charges
  3. Categorize Expenses

    • Business expenses: Office supplies, software, equipment
    • Travel: Transportation, lodging, meals
    • Utilities: Internet, phone, electricity
    • Professional services: Legal, accounting, consulting
    • Marketing: Advertising, subscriptions
    • Entertainment: Client meals, events
    • Other: Miscellaneous
  4. Identify Patterns

    • Recurring charges (subscriptions)
    • Duplicate charges
    • Unusual or high-value transactions
    • Tax-deductible expenses
    • Foreign currency transactions
  5. Generate Structured Output

    • Create CSV-ready format
    • Summarize totals by category
    • Flag items needing attention
    • Calculate tax implications (if relevant)

Output Format

# Financial Document Analysis

## Document Details
- **Type**: Invoice / Receipt / Statement
- **Date**: [Date]
- **Vendor/Merchant**: [Name]
- **Document Number**: [Number]
- **Total Amount**: $X,XXX.XX

## Line Items
| Description | Quantity | Unit Price | Total |
|-------------|----------|------------|-------|
| [Item] | X | $XX.XX | $XX.XX |

## Financial Summary
- **Subtotal**: $X,XXX.XX
- **Tax**: $XXX.XX
- **Total**: $X,XXX.XX
- **Payment Method**: [Method]

## Expense Categorization
| Category | Amount | Items |
|----------|--------|-------|
| Software | $XXX | Slack, GitHub |
| Office | $XX | Supplies |

## Insights
- Tax-deductible business expenses: $X,XXX
- Recurring charges detected: 3 subscriptions ($XXX/month)
- Foreign transaction fees: $XX

## Flagged Items
- [ ] Large expense ($X,XXX) - verify approval
- [ ] Duplicate charge detected on [date]

## Export Data (CSV Format)
```csv
Date,Vendor,Description,Category,Amount,Tax Deductible
2025-01-15,Adobe,Creative Cloud,Software,52.99,Yes

Recommendations

  • Track recurring $XXX/month for [subscription]
  • Consider negotiating bulk discount with [vendor]
  • Set up payment reminder for [invoice due date]

## Examples

**User**: "Extract data from this invoice PDF"
**Response**: Parse PDF → Extract vendor info, line items, totals → Categorize as business expense → Format as structured data → Generate CSV export

**User**: "Analyze my bank statement and categorize expenses"
**Response**: Extract all transactions → Categorize each (dining, software, travel) → Identify recurring charges → Calculate totals by category → Flag unusual transactions → Generate spending report

**User**: "Parse these 10 receipts and create an expense report"
**Response**: Process each receipt → Extract merchant, date, amount, items → Categorize expenses → Calculate totals → Generate consolidated report → Create CSV for expense submission

## Best Practices

- Preserve exact amounts (don't round)
- Maintain currency symbols and formats
- Note when data is unclear or illegible
- Flag suspicious or duplicate transactions
- Provide tax-relevant categorization
- Use standard expense categories
- Generate export-ready formats (CSV, JSON)
- Protect sensitive info (mask account numbers)
- Identify missing information (no date, unclear vendor)
- Calculate totals and verify against document
- Note discrepancies or calculation errors
- Include exchange rates for foreign currency

Comments

Markdown supported