Automated Invoice Processing with Claude Code and n8n

What Is Automated Invoice Processing with Claude Code and n8n

Automated invoice processing with Claude Code and n8n connects email invoice attachments to QuickBooks through a fully automated pipeline. When an invoice lands in a monitored Gmail inbox, n8n triggers a workflow that passes the attachment to Claude Code via the n8n MCP server. Claude extracts structured data including vendor name, invoice number, line items, subtotals, tax amounts, and due dates using its vision capabilities on PDFs and images. The structured data flows into QuickBooks as a draft invoice. A Slack message asks the finance team to approve or reject the entry. Once approved, the invoice is finalized and the entire transaction is logged to a Google Sheet audit trail. The entire sequence runs without a human touching a keyboard for data entry.

[TOOL: n8n MCP Server] Install the n8n-mcp npm package to expose n8n workflow tools to Claude Code. Configure via Claude Code settings with MCP_MODE=stdio, LOG_LEVEL=error, DISABLE_CONSOLE_OUTPUT=true, N8N_API_URL, and N8N_API_KEY environment variables.

[ TOOL: Claude Code CLI ] Claude Code operates in two phases. MCP mode provides live read and write access to n8n workflows through tools like create_workflow, update_workflow, and execute_workflow. Reasoning mode generates structured JSON for workflow configuration.

[ TOOL: Gmail API ] Gmail trigger node uses OAuth 2.0 to monitor a dedicated inbox for invoice-type attachments. Polls on a configurable schedule with a minimum 1-minute interval in production instances.

[ TOOL: QuickBooks Online ] QuickBooks node creates a draft invoice from Claude-extracted data. Requires OAuth credentials with Accounting API scope and tax code ID mapping from extracted percentages to QuickBooks tax code IDs.

[ TOOL: Slack ] Slack approval node sends a summary message to the #invoices channel with inline action buttons or emoji reactions. Requires a Slack app with chat:write and reactions:read scopes.

[ TOOL: Google Sheets ] Google Sheets node appends a row to the master invoice audit log with all extracted fields, approval status, QuickBooks link, and processing timestamp.

[ STAT ] Mid-market companies receive 250-500 invoices per month, with 68 percent still processed manually. Source, Ardent Partners, 2024.

[ STAT ] Workflow build time using Claude Code and n8n MCP drops from 4-12 hours to 15-45 minutes. Source, Ability.ai, 2026.

[ STAT ] Human data entry error rates on invoices average 1-3 percent, leading to duplicate payments and reconciliation issues. Automated extraction reduces errors below 0.1 percent. Source, Ability.ai, 2026.

How the Invoice Processing Workflow Works Step by Step

1. Gmail trigger node polls the inbox for unread emails with PDF, PNG, or JPEG invoice attachments. The trigger fires for each qualifying email and passes the attachment binary and email metadata to the next node.

2. The binary data node downloads the attachment and passes the file data to an HTTP Request node configured to call Claude Code through the n8n MCP server endpoint.

3. Claude analyzes the invoice image or PDF text and returns a structured JSON object containing vendor name, invoice number, date, line items with descriptions and amounts, subtotal, tax, total, and due date.

4. A Set node normalizes Claude's JSON output to match QuickBooks API field names. An additional Function node maps tax percentages to QuickBooks tax code IDs configured in the QuickBooks instance.

5. The QuickBooks node creates a draft invoice in QuickBooks Online with all mapped fields. The draft is created in a Pending Review status so no actual accounting impact occurs until approval.

6. The Slack node sends a message to the #invoices channel with the invoice summary, a link to the QuickBooks draft, and instructions to approve with a checkmark emoji or reject with an X emoji.

7. A Slack webhook listener node captures the reaction event. If approved, the QuickBooks node updates the invoice status to Active. If rejected, a Google Sheets node logs the rejection with the timestamp and reviewer's identity.

8. The Google Sheets node appends a complete audit row to the master invoice log including invoice number, vendor, amount, approval status, QuickBooks link, processing time, and reviewer notes.

9. The Gmail node moves the processed email to an Invoices/Processed label folder and marks it with a processed label to prevent re-processing.

[ STAT ] Claude Code MCP tools include list_workflows, get_workflow, create_workflow, update_workflow, delete_workflow, execute_workflow, and get_execution. Source, czlonkowski n8n-mcp, 2026.

Three Critical GOTCHAs You Must Know Before Running This Workflow

GOTCHA 1: Claude Code cannot set credentials. All OAuth tokens for Gmail, QuickBooks, Slack, and Google Sheets must be configured in the n8n UI manually. The pipeline will fail silently at whichever integration step encounters the missing credential. Test each node credential individually before connecting the full pipeline.

GOTCHA 2: The n8n MCP server will not load until Claude Code is fully restarted. A partial reload or config refresh may not pick up the MCP server configuration. Run claude mcp add n8n-mcp with the required environment variables, then fully close and reopen Claude Code.

GOTCHA 3: QuickBooks API tokens are shown only once when generated. Copy the token string immediately and store it in n8n's credential manager. If you lose the token, you must generate a new one from the QuickBooks app settings.

Invoice Processing ROI and Time Savings

1. Per-invoice data entry time drops from 6-8 minutes of manual typing to 45 seconds of automated processing. 2. Data entry error rate falls from an estimated 2.3 percent to below 0.1 percent with Claude's structured extraction. 3. Approval cycle time compresses from an average of 2.3 days to same-day processing for standard invoices. 4. Annual labor savings: one AP clerk processing at 12 hours per week at 28 USD per hour equals 17,472 USD saved per clerk per year. 5. Late payment penalties on 5-8 percent of invoices are eliminated when invoices are processed within terms.

Setup Requirements and Common Pitfalls

1. (critical risk) QuickBooks OAuth tokens expire after 6 months. Set a calendar reminder to refresh tokens before expiry or the pipeline will silently fail. 2. (significant risk) Non-standard invoice layouts may cause Claude to mis-extract fields. Add a human review step for invoices above 5,000 USD. 3. (moderate risk) n8n MCP server must be restarted after Claude Code is fully restarted for the connection to reload. 4. (minor) QuickBooks rate limits at 650 requests per minute per app. A throttle node between steps 3 and 4 prevents rate limit errors during bulk processing.

Q: What is the n8n MCP server and how does it connect to Claude Code? A: The n8n MCP server is an npm package (n8n-mcp by czlonkowski) that exposes n8n workflow management tools through the Model Context Protocol. Claude Code connects to it by running claude mcp add n8n-mcp with environment variables for the n8n instance URL and API key.

Q: Can Claude Code create n8n workflows from scratch? A: Yes. Claude Code uses the create_workflow MCP tool to generate complete n8n workflow JSON. Alex P., AI Systems Lab reports that Claude generates the full workflow structure including node configurations, connections, and credentials.

Q: Does this workflow work with Xero instead of QuickBooks? A: Yes. Replace the QuickBooks node with the Xero node in n8n. The invoice creation endpoint and field mapping differ, but the Claude extraction step is identical regardless of the target accounting platform.

Q: How long does a full cycle take from invoice arrival to approval notification? A: The average end-to-end time is 90 seconds for extraction and QuickBooks draft creation. The approval step depends on human response time, but the pipeline processes the invoice in under 2 minutes of automated work.