MCP App Store
by KeenEthics
Receipta icon

Receipta MCP Server for ChatGPT

By T&L Health Service Group Pty Ltd

Overview

Receipta helps individuals and small businesses keep expense and invoice records organized, with receipt evidence and spending reports. Connect your Receipta account to search saved receipts, file supporting photos and PDFs, correct expense entries, organize folders and warranties, and generate spending reports. You can also maintain reusable invoice issuer, customer and item details, draft and correct outgoing invoices, record their bookkeeping status, and export invoice PDFs and analysis reports. Invoice contact details and recipient payment instructions are optional document content supplied by you for that purpose. Receipta does not charge customers, transfer money, send invoices by email or offer financial advice. Confirm the intended Receipta ledger and review the exact preview before confirmed invoice changes. ChatGPT sign-in and Receipta sign-in are separate. Existing local records upload only when selected; automatic upload of new records requires consent. Secure Pro vault content is excluded. The connection cannot independently search an email inbox.

How to connect

  1. ChatGPT: Open the Receipta listing in the ChatGPT app directory and choose Connect. ChatGPT listing Receipta exposes 65 tools here.

Tools

analyze_invoice_out

ChatGPT
Analyze outgoing InvoiceOut only, never expenses. Currency is mandatory; no exchange conversion. Match App calendar week (Monday), month, quarter or year, or use custom [rangeStart,rangeEnd) / all. asOfDate is an explicit calendar date for overdue status; use the confirmed member timezone or ask rather than assume server timezone. App-compatible issued/unpaid totals exclude drafts and cancelled invoices; draft amounts are reported separately. issuedOnly/unpaidIssued fields remain explicit aliases. Cancelled invoices appear separately. Complete only within the bounded cloud workspace (100 invoices / 256 KiB); local-only/deleted records excluded.

append_receipt_attachments

ChatGPT
Attach uploaded original photos or PDFs to ONE existing receipt in the confirmed Receipta ledger. Identify the ledger owner and receipt first, call get_receipt for current expectedVersion, then pass the uploaded files using their real download_url and stable file_id. Never create a duplicate expense merely to add evidence. Preserve all existing originals. Up to five originals per receipt. Retry with the same idempotencyKey and file_id even if the temporary download URL expires and changes. Report success only if the returned attachment count confirms persistence; downloaded files are checked and stored before success. Do not silently fall back to text-only if file transfer fails.

append_receipt_uploads

ChatGPT
Append one or more portable uploaded originals to an existing receipt after reading its current version. Pass the uploadSessionId values returned by create_receipt_upload as uploadIds. Requires the confirmed ledgerId, receiptId, expectedVersion, idempotencyKey, and uploadIds. Reauthorize live before commit. Stale versions return a conflict and do not consume the staged upload; duplicate originals are reported by the repository semantics.

apply_receipt_enrichment

ChatGPT
Apply exactly the merchant/tax fields and evidence shown by prepare_receipt_enrichment only after the user explicitly confirms them. Supply userConfirmed:true, the exact token and receipt version. Reuse the same idempotencyKey on retry. The server atomically verifies authorization, token expiry and receipt version, saves the evidence with the values, and consumes the token. A changed receipt needs another preview. Report the saved fields and owner and distinguish confirmed estimates from printed receipt tax.

confirm_email_intake_batch

ChatGPT
Save only the exact candidate IDs the user confirmed from prepare_email_intake_batch using its token. Retry with the identical selection. Each receipt is independently authorized, checked for duplicates and persisted; report created/already_exists/review_required/needs_handling/failed separately. A batch confirmation never bypasses a specific duplicate decision. Partial success remains saved; retry only repeats unfinished operations with their original keys. Temporary file URLs may expire before the one-hour batch preview: report per-item failure and refresh the preview with the same file IDs and new download URLs while it is valid. A new upload file ID requires a new preview and new keys only for unfinished items; inspect and retain successful receipt IDs. Never silently save text without required originals. already_exists adds no expense total and does not automatically append another original.

confirm_invoice_out_amend

ChatGPT
Apply only the approved before/after edits to this issued or paid invoice, including its displayed total and fully paid amount where applicable. Requires the token from prepare_invoice_out_amend and explicit user approval. The server checks that token against this operation, invoice ID, member and revision before applying or replaying it. Expired or stale previews require preparation again. No email or payment is sent.

confirm_invoice_out_cancel

ChatGPT
Cancel the exact invoice using the approved cancellation date. Requires the token from prepare_invoice_out_cancel and explicit user approval. The server checks that token against this operation, invoice ID, member and revision before applying or replaying it. Expired or stale previews require preparation again. No email or payment is sent.

confirm_invoice_out_delete

ChatGPT
Move the exact invoice into recoverable deleted history. Requires the token from prepare_invoice_out_delete and explicit user approval. The server checks that token against this operation, invoice ID, member and revision before applying or replaying it. Expired or stale previews require preparation again. No email or payment is sent.

confirm_invoice_out_issue

ChatGPT
Issue the exact draft invoice as unpaid using its approved issue date and amount. Requires the token from prepare_invoice_out_issue and explicit user approval. The server checks that token against this operation, invoice ID, member and revision before applying or replaying it. Expired or stale previews require preparation again. No email or payment is sent.

confirm_invoice_out_mark_paid

ChatGPT
Record the exact invoice as fully paid for the approved amount, date and bookkeeping label. Requires the token from prepare_invoice_out_mark_paid and explicit user approval. The server checks that token against this operation, invoice ID, member and revision before applying or replaying it. Expired or stale previews require preparation again. No email or payment is sent.

confirm_invoice_out_mark_unpaid

ChatGPT
Record the exact invoice as unpaid and clear its recorded paid date and payment label. Requires the token from prepare_invoice_out_mark_unpaid and explicit user approval. The server checks that token against this operation, invoice ID, member and revision before applying or replaying it. Expired or stale previews require preparation again. No email or payment is sent.

confirm_invoice_out_restore

ChatGPT
Restore the exact deleted invoice snapshot without changing its financial or payment fields. Requires the token from prepare_invoice_out_restore and explicit user approval. The server checks that token against this operation, invoice ID, member and revision before applying or replaying it. Expired or stale previews require preparation again. No email or payment is sent.

create_folder

ChatGPT
First get_account_context and confirm the intended Receipta owner; never use ChatGPT login or an ambiguous folder label as identity. Create a custom category with a unique label within this ledger. Maximum ten active custom folders. Reuse the operation key when retrying; list existing folders before creating duplicates.

create_invoice_out

ChatGPT
Create one draft invoice using an existing businessProfileId. First read list_invoice_out and use the exact saved business profile selected by the user; if multiple profiles could apply, ask the user to choose by profile ID, business name, country or currency and never choose the first profile silently. Saved profile country, currency, tax defaults, payment terms and bank instructions supply omitted invoice defaults. Supply invoice ID/number, customer name, issue date and line items; due date, currency and payment terms inherit from the chosen profile when omitted. Optional Bill to details appear on this invoice. Optional issuerSnapshot fields are only invoice-specific display overrides expressly requested by the user; never invent issuer, tax or bank details. Server supplies draft status, sequence and calculated totals. Explicit tax treatment is required. Use the dedicated prepare_invoice_out_issue or prepare_invoice_out_mark_paid tools for status, payment labels and event dates. No email or payment is sent. Returns invoice ID/revision; use get_invoice_out for readback.

create_receipt_upload

ChatGPT
Create a short-lived, single-file Receipta upload link for the confirmed ledger owner. The link opens a native mobile camera/file picker and accepts one JPEG, PNG, or PDF up to 10 MB. The capability is in the URL fragment and is never an OAuth bearer token. Return the ownerName and ledgerLabel with the link. Creating a link does not read or save a ledger receipt. The idempotencyKey is optional: reuse the same key on a retry to avoid a duplicate session; replaying the same key reuses that session but rotates the short-lived capability URL.

delete_folder

ChatGPT
First get_account_context and confirm the intended Receipta owner; never use ChatGPT login or an ambiguous folder label as identity. After the user confirms prepare_folder_delete, soft-delete that custom folder and atomically move its receipts to Other, incrementing their versions. Does not delete receipts or originals. Pass exact confirmationToken/expectedVersion and reuse idempotencyKey on retry. If snapshot changed, prepare and ask again.

delete_receipt

ChatGPT
Soft-delete one receipt only after prepare_receipt_delete and user explicitly confirms its owner, amount/date and deletion. Pass exact preview confirmationToken and expectedVersion, reuse idempotencyKey for retries. Removes it from active lists and reports while retaining originals for recovery. Never delete every matching record automatically. Report receiptId and version for restore.

export_invoice_out_analysis_pdf

ChatGPT
Analyze outgoing InvoiceOut only, never expenses. Currency is mandatory; no exchange conversion. Match App calendar week (Monday), month, quarter or year, or use custom [rangeStart,rangeEnd) / all. asOfDate is an explicit calendar date for overdue status; use the confirmed member timezone or ask rather than assume server timezone. App-compatible issued/unpaid totals exclude drafts and cancelled invoices; draft amounts are reported separately. issuedOnly/unpaidIssued fields remain explicit aliases. Cancelled invoices appear separately. Complete only within the bounded cloud workspace (100 invoices / 256 KiB); local-only/deleted records excluded. Generate an actual PDF summary with period buckets, statuses and scoped invoice rows. Creates and stores a temporary private export file without changing invoice records. Returns a private resource_link; retrieve bytes with get_report_file. Does not send customer email or mark any invoice sent.

export_invoice_out_csv

ChatGPT
Analyze outgoing InvoiceOut only, never expenses. Currency is mandatory; no exchange conversion. Match App calendar week (Monday), month, quarter or year, or use custom [rangeStart,rangeEnd) / all. asOfDate is an explicit calendar date for overdue status; use the confirmed member timezone or ask rather than assume server timezone. App-compatible issued/unpaid totals exclude drafts and cancelled invoices; draft amounts are reported separately. issuedOnly/unpaidIssued fields remain explicit aliases. Cancelled invoices appear separately. Complete only within the bounded cloud workspace (100 invoices / 256 KiB); local-only/deleted records excluded. Generate canonical App-column CSV containing every scoped saved status. Creates and stores a temporary private export file without changing invoice records. Returns a private resource_link; retrieve bytes with get_report_file. Does not send customer email or mark any invoice sent.

export_invoice_out_pdf

ChatGPT
Create and store a temporary private outgoing invoice PDF export from the saved supplier/client/line/tax/payment snapshot without changing invoice records. Does not email or send it. Returns a private authenticated report resource; use get_report_file to download it.

generate_analysis_report

ChatGPT
Create and store a temporary private Personal Analyze PDF export without changing receipt records: overview includes metrics/trend/folders/composition; trend, folder and composition contain their selected analysis. Uses the same currency/date/folder/tag filters as get_spending_analysis. Confirm ledgerId. Includes readable tables, not a claim of pixel-identical App charts. Standard private report expiry and get_report_file/resources/read apply. PDF text bound20000characters; unsupported glyphs fail explicitly. No SecurePro data or local-only records.

generate_report

ChatGPT
Generate an actual CSV, PDF, or accountant ZIP for the confirmed ledgerId. This creates and stores a temporary private export file; it does not change receipt records. Choose inclusive dates and optional folderIds/tag. expense_csv uses the App expense columns and exact currency decimal units; csv retains the legacy technical columns. expense_summary_pdf and pdf generate the expense PDF. accountant_zip contains expense CSV/PDF, bookkeeper CSV, attachment index, README, manifest and available originals verified by checksum; report missingOriginals honestly. At most 1000 date/currency/folder records before Unicode tag filtering, no partial totals. PDF preserves supported Latin/Chinese text and fails rather than replacing unsupported characters; PDF text is limited to 20000 characters, with explicit rejection and CSV fallback for larger exports. Returns a private MCP resource valid 15 minutes; read it with get_report_file/resources/read. Do not invent a public download URL or claim the client displayed a download button. Cloud receipts only; unknown tax is not zero.

get_account_context

ChatGPT
Read the member regionalPreferences (country, currency, language, date format, fiscal year and IANA timezone) before interpreting dates or choosing receipt defaults. Missing preferences are unknown; explicit receipt evidence takes precedence. Identify the Receipta ledger owner of this connection before selecting a ledger or saving. Confirm ledgerName together with owner and ledgerId; identical names do not identify the same ledger. If ledgerName is null, suggest naming the ledger in the Receipta App. Returns trusted Receipta account identity, NOT the ChatGPT login identity. If multiple connected ledgers could match a name or "my ledger", ask the user which owner they mean. Never infer the owner from the ChatGPT email, speaking style, or a Primary connection. This read does not save a receipt.

get_email_intake_batch

ChatGPT
Read the persisted partial results of a supplied-email intake batch in this Receipta ledger. Use after interruptions or before retrying. Pending/failed/review_required items are not saved receipts; only created/already_exists provides a real receipt ID. Does not access email or start background scanning.

get_invoice_out

ChatGPT
Read an outgoing invoice, exact integer minor-unit totals, payment state and current workspace version.

get_ledger_summary

ChatGPT
Summarize the selected Receipta cloud ledger, inclusive date range and optional exact merchant or currency. Totals remain separate per currency. Includes all matching records up to 1000; larger sets are rejected, never silently truncated. Missing tax is unknown; customer-confirmed estimates are separated from recorded tax and never presented as original receipt amounts. Local-only App entries are excluded.

get_receipt

ChatGPT
Get one committed cloud receipt owned by this member.

get_receipt_entry_guidance

ChatGPT
Use the returned member regionalPreferences only as defaults; explicit receipt currency and tax take precedence. If timeZone is null, ask for timezone before resolving relative dates. Regional defaults, email and file host are not tax evidence. Explicitly confirmed estimates need a recorded explanation and must remain labelled estimates. Before creating or correcting a receipt from a photo, PDF, email, spoken or text description, check missing fields and evidence rules. Returns clarification questions; it does not read images itself or save anything. Extract the actual merchant from supplied evidence, never expand a location into an invented merchant. A missing merchant can stay pending. To correct a saved receipt use update_receipt, not a new save.

get_receipt_upload

ChatGPT
Read one uploaded original owned by this Receipta member. Returns metadata plus the actual persisted JPEG or PNG as MCP image content, or the actual PDF as an embedded MCP resource for OCR and inspection. It never substitutes a URL or extracted text for the original bytes.

get_report_file

ChatGPT
Read the actual bytes of this member’s unexpired report as an authenticated MCP binary resource. Authorization is checked again; another member cannot read it. No public URL is returned.

get_spending_analysis

ChatGPT
Read the selected Receipta cloud ledger Personal Analyze metrics, top merchant, folder spending/composition, current and previous trends. Choose one ISO currency. Periods mirror the App: Monday week, five month buckets, fiscal quarter/year, inclusive custom range, or all time. If anchorDate is absent the latest receipt in that currency anchors the period BEFORE folder/tag filtering; disclose the returned anchor. Missing fiscal settings require explicit fiscalStartMonth; never assume Australia. All-time totals cover all dates but trends compare the anchor financial year. Folder IDs and case-insensitive exact tag are optional. At most 1000 current/comparison records in the date/currency/folder scope before Unicode tag filtering; no partial summary.

list_deleted_invoice_out

ChatGPT
List this member recoverable deleted outgoing invoices. Follow nextCursor for remaining history. Use prepare_invoice_out_restore and confirm_invoice_out_restore after explicit confirmation to restore an unchanged snapshot; supplier must still exist.

list_folders

ChatGPT
List the selected member ledger categories: ten built-in folders and up to ten active custom folders. Include deleted custom folders when locating one to restore. IDs are authoritative; identical labels across ledgers do not grant access.

list_invoice_out

ChatGPT
List outgoing customer invoices and supplier/client/item catalogs in this member cloud InvoiceOut workspace. Separate from expenses and never included in expense totals. Local-only invoices are excluded. Use returned workspace version for edits. Account identity comes from Receipta, not the ChatGPT login.

list_receipt_uploads

ChatGPT
List this authenticated member’s portable receipt upload sessions and their confirmed checksums. This does not list another member’s sessions, reveal capability tokens, or return ledger records.

list_receipts

ChatGPT
List this authenticated member’s committed cloud receipts, newest purchase date then ID first. Optional dateFrom/dateTo include both endpoints; currency filters one currency. folderIds and tag filter the same cloud classifications/tags visible in the App. Continue with nextCursor and the same filters until nextCursor is null. Pages are live, not a frozen snapshot.

list_warranties

ChatGPT
Read this ledger warranty tracking and alerts as of an explicitly supplied local calendar date. Confirm relative dates using member timezone; never use a guessed UTC date. attention includes expired and due within 30 days; includeDismissed false matches App reminder list. Expiry day is still dueSoon, next day expired. Continue with nextCursor and identical filters. This does not send notifications.

prepare_email_intake_batch

ChatGPT
Import a preview of up to ten invoice candidates from email content or attachments the user has already supplied. No email connector is required. This tool does not access any inbox, search email, or verify email-account ownership. Confirm the intended Receipta owner and the supplied mailbox/date/search scope first. Supply real message IDs and received dates from the provided email evidence; if these are unavailable, use the ordinary receipt intake tools without inventing email metadata. Connect top-level uploaded files through each candidate receipt.fileIds. Extract separate invoices with explicit invoiceBoundary and never infer payment from an email alone. Classify unpaid bills and refunds correctly: they remain needs_handling and add no paid expense. Show every preview item and ask the user which candidate IDs to save. This stores a private batch preview and confirmation record, but adds no expense totals. No original URLs appear in the preview.

prepare_folder_delete

ChatGPT
First get_account_context and confirm the intended Receipta owner; never use ChatGPT login or an ambiguous folder label as identity. Preview deletion of one custom folder. Show its name, owner and affectedReceiptCount, and ask the user to confirm moving these receipts to Other. No receipts are deleted. Preview is bound to the folder version and full receipt ID/version set; any new or edited receipt invalidates it.

prepare_invoice_out_amend

ChatGPT
Preview only the requested edits to this already-issued or paid invoice. Show every before/after change, currency, total, paid amount and balance. A paid invoice remains recorded as fully paid at the amended total; the user must approve that amount. Stores a private 10-minute preview token bound to this invoice, ledger and workspace revision; invoice records are not changed. Show the preview and ask for approval before confirm_invoice_out_amend. No email or payment is sent.

prepare_invoice_out_cancel

ChatGPT
Preview cancelling this invoice. The optional effectiveDate records its cancellation date. Stores a private 10-minute preview token bound to this invoice, ledger and workspace revision; invoice records are not changed. Show the preview and ask for approval before confirm_invoice_out_cancel. No email or payment is sent.

prepare_invoice_out_delete

ChatGPT
Preview moving this invoice to recoverable deleted history. This does not permanently erase its snapshot. Stores a private 10-minute preview token bound to this invoice, ledger and workspace revision; invoice records are not changed. Show the preview and ask for approval before confirm_invoice_out_delete. No email or payment is sent.

prepare_invoice_out_issue

ChatGPT
Preview issuing this draft invoice as unpaid. The optional effectiveDate records its issue date; this does not send the invoice. Stores a private 10-minute preview token bound to this invoice, ledger and workspace revision; invoice records are not changed. Show the preview and ask for approval before confirm_invoice_out_issue. No email or payment is sent.

prepare_invoice_out_mark_paid

ChatGPT
Preview recording this issued invoice as fully paid. Optional effectiveDate and paymentMethod record the actual payment date and bookkeeping label; this does not collect or transfer funds. Stores a private 10-minute preview token bound to this invoice, ledger and workspace revision; invoice records are not changed. Show the preview and ask for approval before confirm_invoice_out_mark_paid. No email or payment is sent.

prepare_invoice_out_mark_unpaid

ChatGPT
Preview recording this issued invoice as unpaid, clearing its paid date and payment label. This does not reverse a real payment. Stores a private 10-minute preview token bound to this invoice, ledger and workspace revision; invoice records are not changed. Show the preview and ask for approval before confirm_invoice_out_mark_unpaid. No email or payment is sent.

prepare_invoice_out_restore

ChatGPT
Preview restoring this recoverably deleted invoice unchanged. Its saved supplier must still exist. Stores a private 10-minute preview token bound to this invoice, ledger and workspace revision; invoice records are not changed. Show the preview and ask for approval before confirm_invoice_out_restore. No email or payment is sent.

prepare_receipt_delete

ChatGPT
Read the exact receipt and generate a short-lived deletion confirmation. First identify the authorized Receipta owner with get_account_context. Show the returned owner, receipt merchant, amount, date and version to the user and ask them to confirm deletion. This preview does not delete anything. Never call delete_receipt without their explicit confirmation of this preview.

prepare_receipt_enrichment

ChatGPT
Preview evidence-based merchant and tax enrichment for one existing receipt in the confirmed Receipta ledger. If your web-search tool is available, prefer official registries and the actual merchant website, match the specific outlet/legal entity and country, and supply the source URL, registered name and matching explanation. Do not substitute a chain headquarters for a franchise. If search is unavailable or ambiguous, ask the user; this server never searches or verifies URLs. Receipt evidence takes precedence. Never invent invoice numbers or transaction dates. Registry/GST registration alone does not establish transaction tax. A customer-approved estimate must explain the evidence, assumptions and calculation and stay estimate_confirmed. Show the full preview, overwritten fields and owner, then ask for explicit confirmation.

prepare_receipt_intake

ChatGPT
Before recording an expense from a photo, PDF or authorized email, confirm the Receipta owner with get_account_context and preview duplicate candidates. Reference numbers remain case-sensitive. Merchant/date/amount similarity is only a candidate. Show exact existing receipt and differences. Ask whether this is the same expense or a separate transaction. A ready result is only a preview; saving rechecks atomically. File matching is checked on actual ingestion; only declare invoiceBoundary when the supplied evidence proves one invoice or exact pages. This tool does not read any inbox or add expense totals.

purge_receipt

ChatGPT
Permanently delete ONE receipt and its stored original files from the explicitly confirmed Receipta ledger. First call prepare_receipt_delete, show the owner, merchant, amount, date and version, and obtain explicit confirmation that this is irreversible. Pass the exact confirmationToken, expectedVersion, a new idempotencyKey and userConfirmed=true. Success requires purged:true and restorable:false; unfinished original cleanup returns an error and remains retryable.

rename_folder

ChatGPT
First get_account_context and confirm the intended Receipta owner; never use ChatGPT login or an ambiguous folder label as identity. Rename a custom category using its latest version. Receipts retain their folder ID and amounts; their displayed folder name changes. Built-in categories cannot be renamed.

resolve_receipt_intake

ChatGPT
Only after the user answers a specific duplicate preview, submit exactly the reviewed receipt fields/files and duplicateResolution token. same_receipt requires an exact candidate ID and returns that existing receipt without another expense total; separate_expense explicitly records another transaction. Tokens expire and bind input, candidate versions and ledger changes. Never invent a decision, reuse an unrelated confirmation, or remove the token after a conflict. Unpaid bills and refunds require separate handling and are not paid expense entries. Report created versus already_exists and the returned owner.

restore_folder

ChatGPT
First get_account_context and confirm the intended Receipta owner; never use ChatGPT login or an ambiguous folder label as identity. Restore an explicitly requested deleted custom folder, using its current version. Existing receipts remain in Other; never silently reassign them. The ten-folder quota and unique active name still apply.

restore_receipt

ChatGPT
Restore one deleted receipt to the same authorized owner ledger, using receiptId and version returned by delete_receipt. Requires an explicit user restore request. Reuse same idempotencyKey on retries. Never create a second receipt as recovery.

save_invoice_out_business

ChatGPT
Create or edit one saved invoice issuer business profile. Supply its ID and only the profile fields the user requested; a new profile also needs businessName, countryCode and currencyCode. Business contact details identify the issuer on invoices, and optional recipient bank instructions tell customers where to remit payment. Use those display fields only when supplied for that invoice purpose. Omitted fields and existing invoice snapshots remain unchanged. No email or payment is sent. Returns the saved profile ID and revision; read it with list_invoice_out.

save_invoice_out_catalogs

ChatGPT
Upsert only the requested reusable invoice catalog entries by ID. Omitted arrays and entries remain unchanged. Existing entries need ID and changed fields only. New businesses/customers need name, country and currency; new line items need businessProfileId, description, quantity, unitPrice and explicit tax treatment. Optional contact, business-registration and recipient payment fields are invoice display settings. Remove entries only by exact IDs in remove with userConfirmed=true after the user approves them; removal never changes invoice snapshots. No email or payment is sent. Returns only affected IDs/revision; use list_invoice_out for full records.

save_receipt

ChatGPT
Use get_receipt_entry_guidance to check missing fields. Use list_folders for classification IDs; folderId and tags mirror the App. Set warranty tracking only when supported by the receipt or explicit user statements; an unknown expiry must stay unknown. Extract the actual merchant only from supplied receipt evidence or explicit user statements. Never infer a merchant from a suburb (South Melbourne does not imply South Melbourne Market); omit an unknown merchant and mark merchantPending instead. For corrections use update_receipt with the existing receipt ID, never create a duplicate. First call get_account_context for candidate connections and select the explicitly named or user-confirmed Receipta owner. If the owner is ambiguous, including "my ledger", ask before saving. Never infer ownership from ChatGPT login/email, speaking style, or Primary. Pass the selected ledgerId; it must match this connection. Report the returned ownerName and ledgerLabel after success, e.g. Saved to Tony’s Receipta ledger. Do not save another receipt just to add ownership context; use get_account_context or get_receipt. Persist a new structured receipt with its uploaded original files. Use attachmentPolicy required for uploads; none only for an explicitly requested manual text-only entry. Reuse the same idempotency key when retrying. The service independently checks cross-source duplicates. Report outcome created or already_exists accurately. already_exists does not add another expense or automatically append this upload; use append_receipt_attachments for requested extra evidence. If duplicate_review_required, present the specific candidates and use prepare_receipt_intake / resolve_receipt_intake after the user decides. Unpaid bills and refunds need separate handling; never label them a paid expense.

save_receipt_from_uploads

ChatGPT
Save a new paid expense using one or more server-owned portable upload session IDs (pass the uploadSessionId values returned by create_receipt_upload). The uploadIds are required and the service persists the originals exactly before committing the structured receipt. Reauthorize live before commit and on retry. Reuse the same idempotencyKey for replay. If duplicate_review_required is returned, show its candidates and confirmation token, then retry this tool with the exact duplicateResolution after the user decides; never silently text-save or append to an existing receipt.

save_receipt_with_attachments

ChatGPT
Preferred entry for a NEW expense from a ChatGPT-uploaded photo, image, PDF or email attachment. The files parameter is REQUIRED and must contain the actual uploaded file, not extracted text, a file name or an invented URL. If ChatGPT cannot provide the file, explain that evidence was not saved; do not fall back to text-only saving without explicit user permission. If the expense was already saved, use append_receipt_attachments on that receipt ID instead. Use get_receipt_entry_guidance to check missing fields. Use list_folders for classification IDs; folderId and tags mirror the App. Set warranty tracking only when supported by the receipt or explicit user statements; an unknown expiry must stay unknown. Extract the actual merchant only from supplied receipt evidence or explicit user statements. Never infer a merchant from a suburb (South Melbourne does not imply South Melbourne Market); omit an unknown merchant and mark merchantPending instead. For corrections use update_receipt with the existing receipt ID, never create a duplicate. First call get_account_context for candidate connections and select the explicitly named or user-confirmed Receipta owner. If the owner is ambiguous, including "my ledger", ask before saving. Never infer ownership from ChatGPT login/email, speaking style, or Primary. Pass the selected ledgerId; it must match this connection. Report the returned ownerName and ledgerLabel after success, e.g. Saved to Tony’s Receipta ledger. Do not save another receipt just to add ownership context; use get_account_context or get_receipt. Persist a new structured receipt with its uploaded original files. Use attachmentPolicy required for uploads; none only for an explicitly requested manual text-only entry. Reuse the same idempotency key when retrying. The service independently checks cross-source duplicates. Report outcome created or already_exists accurately. already_exists does not add another expense or automatically append this upload; use append_receipt_attachments for requested extra evidence. If duplicate_review_required, present the specific candidates and use prepare_receipt_intake / resolve_receipt_intake after the user decides. Unpaid bills and refunds need separate handling; never label them a paid expense.

set_receipt_folder

ChatGPT
First get_account_context and confirm the intended Receipta owner; never use ChatGPT login or an ambiguous folder label as identity. Move exactly one receipt to a listed built-in or custom folder in the same ledger. Read current receipt version first. Does not change amounts, originals, or warranty settings.

set_receipt_tags

ChatGPT
First get_account_context and confirm the intended Receipta owner; never use ChatGPT login or an ambiguous folder label as identity. Replace receipt tags only with the labels explicitly requested by the user; maximum twenty distinct tags of up to 64 characters. Read the receipt first to retain existing tags unless the user asks to remove them. Empty tags removes all tags; no expense is deleted.

set_receipt_warranty

ChatGPT
First get_account_context and confirm the intended Receipta owner; never use ChatGPT login or an ambiguous folder label as identity. Set warranty tracking and the explicitly confirmed expiry date for one receipt. Unknown expiry may stay null. Do not invent duration or extend warranty based on assumptions; clarify dates derived from a duration. Expiry cannot precede purchase. Turning tracking off clears expiry; changing tracking/expiry resets dismissal. App alerts cover expired warranties and expiry within 30 days, including expiry day. This changes stored tracking only; it does not promise push/email delivery.

set_warranty_alert_dismissed

ChatGPT
First get_account_context and confirm the intended Receipta owner; never use ChatGPT login or an ambiguous folder label as identity. Dismiss or re-enable an existing dated warranty alert only on user request. Dismissal is tied to the current expiry date; an expiry change automatically makes alerts eligible again. Read the latest receipt version. This does not change the warranty or schedule a notification.

update_invoice_out

ChatGPT
Edit only requested fields of an existing DRAFT invoice. Omitted fields preserve saved values; supplied lineItems replace its lines. Optional customer/issuer details are changes to the printed invoice, not a request for unrelated profile information. For an already issued or paid invoice use prepare_invoice_out_amend to review exact before/after values and confirm_invoice_out_amend after approval. Status/payment events have their own prepare and confirm tools. No email or payment is sent. Returns invoice ID/revision; use get_invoice_out for readback.

update_receipt

ChatGPT
Correct an existing receipt in the explicitly selected Receipta ledger. Identify owner with get_account_context, fetch receipt and use current version as expectedVersion. Change only user-requested fields; keep ID and original files. Preserve exact referenceNumber and merchantTaxId (ABN in Australia). taxAmountMinor is the explicitly printed or user-confirmed tax amount in minor units; unknown is null, explicit zero is 0. Never silently derive GST from the total or merchant registration. For an evidence-based estimate, use prepare_receipt_enrichment/apply_receipt_enrichment with the calculation explanation and explicit user confirmation; retain taxEvidence.kind estimate_confirmed. countryCode and taxLabel also require evidence. Changing tax context clears stale evidence; changing the basis of an existing estimate may clear its amount to unknown. Merchant must come from receipt/PDF/image, explicit user narration, or a specific official registry match shown and confirmed through enrichment; never invent a venue from a suburb/location. If merchant unknown set merchantPending true. New idempotencyKey per correction, reuse for retries. On version_conflict read again and verify intent. Report updated fields and returned ledger owner. Do not create a replacement receipt for a correction.

Capabilities

Writes

Example Prompts

Click any prompt to copy it.

Similar Apps

Listed on MCP App Store

Listed on MCP App Store

Add this badge to your site or README. It links to this page.

HTML

<a href="https://mcp-app-store.keenethics-labs.com/app/receipta"><img src="https://mcp-app-store.keenethics-labs.com/badges/listed-on-mcp-app-store.svg" alt="Listed on MCP App Store" width="220" height="44"></a>

Markdown

[![Listed on MCP App Store](https://mcp-app-store.keenethics-labs.com/badges/listed-on-mcp-app-store.svg)](https://mcp-app-store.keenethics-labs.com/app/receipta)