mcp-server-receipt

What is mcp-server-receipt?

mcp-server-receipt is an MCP protocol server that provides context for LLMs to automatically organize receipt files. It instructs the LLM on naming conventions and storage locations, enabling extraction of date, amount, and company name from receipt PDFs and renaming them to a standardized format (YYYYMMDD_amount_company.pdf) before saving to a specified output directory.

How to use mcp-server-receipt?

Clone the repository, install dependencies (npm install), and build (npm run build). Then configure your MCP host with the command node and arguments pointing to dist/index.js, followed by an input directory and an output directory (e.g., ~/Downloads/receipts and ~/Documents/Finance/Receipts). The server provides a gen-receipt-filename prompt (no arguments) that guides the LLM to process attached receipt files.

Key features of mcp-server-receipt

• Provides the gen-receipt-filename prompt for LLM guidance
• Extracts date, amount, and company name from receipt PDFs
• Renames files to YYYYMMDD_amount_company.pdf
• Copies renamed files to a configurable output directory
• Supports local build from source with npm
• Designed for MCP-compatible LLM hosts

Use cases of mcp-server-receipt

• Automating receipt file organization for personal finance
• Generating standardized filenames for expense tracking
• Integrating with LLM-based document management workflows
• Reducing manual file renaming and sorting tasks

FAQ from mcp-server-receipt

What does the gen-receipt-filename prompt do?

It provides instructions to the LLM to extract information from attached receipt files and store them with standardized filenames.

How do I set up the input and output directories?

Configure them as command-line arguments when starting the server, for example: node dist/index.js ~/Downloads/receipts ~/Documents/Finance/Receipts.

What runtime does the server require?

Node.js and npm are required. You need to clone the repository, install dependencies, and build the server with npm run build.

What information does the LLM extract from receipt PDFs?

The LLM extracts the date, amount, and company name from receipt PDFs.

How are receipt files renamed?

Files are renamed to the format YYYYMMDD_amount_company.pdf, where amount and company are derived from the receipt content.