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.