receipt-organizer

Rename and sort receipt PDFs and import Gmail receipts into tax-ready folders.

Updated Feb 28, 2026
One-click install
npx skills add https://github.com/shuhei-fujita/receipt-organizer --skill receipt-organizer
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: receipt-organizer
Source: https://github.com/shuhei-fujita/receipt-organizer/tree/main/.claude/skills/receipt-organizer
Command: npx skills add https://github.com/shuhei-fujita/receipt-organizer --skill receipt-organizer

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill automates the organization of receipts for tax filing by renaming and sorting receipt files in a specified folder and by importing Gmail receipts.

Core Features & Use Cases

  • Renaming and sorting receipts according to a consistent naming convention (YYYYMMDD_Store_Description.pdf) and categorizing into folders.
  • Importing Gmail receipts by extracting text from emails and optionally downloading attached PDFs for consolidation.
  • Guiding interactive prompts to collect the target folder, time period, and actions, then executing the operations with safeguards such as pre-rename previews and non-destructive moves.

Quick Start

Start the skill with /receipt-organizer and follow the prompts to specify the receipts folder, target period, and actions.

Frequently Asked Questions about receipt-organizer

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I organize receipts from Gmail for tax filing?▼

Organizing Gmail receipts involves extracting text from emails and optionally downloading attached PDFs to consolidate them. The skill imports Gmail receipts using read-only access to prepare tax-ready expense records.

How do I rename and sort PDF receipts into a consistent folder structure?▼

Renaming and sorting PDF receipts applies a consistent naming convention like YYYYMMDD_Store_Description.pdf and categorizes files into folders. Pre-rename previews ensure files are moved non-destructively.

Can I extract vendor names and dates from receipt emails and PDFs automatically?▼

Extracting vendor names and dates from receipt emails and PDFs is automated by parsing contents and text. This process applies to local folders and Gmail-based receipts to prepare tax-ready expense records.

What is the best way to batch rename local receipt files without overwriting existing data?▼

Batch renaming local receipt files safely requires safeguards to avoid overwriting existing data. The skill provides pre-rename previews and performs non-destructive moves to protect original files.

Does this receipt organizer require write access to my Gmail account?▼

The receipt organizer operates with Gmail read-only access, meaning it does not require write permissions. It securely extracts text and downloads attached PDFs without modifying your emails.

How do I filter receipts by a specific time period before sorting them?▼

Filtering receipts by a specific time period is handled through interactive prompts that collect your target period. The skill then executes renaming and sorting operations only for receipts within that timeframe.