Receiptor MCP
Receiptor connects AI agents to your bookkeeping workspace so they can find, review, and organize financial documents such as receipts, bills, and invoices. Use it to inspect workspace context, monitor intake sources, review extracted document data, check integrations, and prepare accountant-ready workflows through secure OAuth access to Receiptor AI.
How to connect
https://receiptor-mcp.run.tools
tools/list returns the expected tools before relying on them in production.Tools
(50)-
get_server_infoGet information about the Receiptor MCP server
-
workspace_get_contextGet the current workspace context (user, org, role, and effective ownership scope).
-
workspace_switchValidate a target workspace and switch the active workspace for this MCP OAuth session.
-
activity_searchSearch past source activity logs across email, WhatsApp, and uploads. For email sources, this first searches connected providers, then cross-checks matching message IDs against stored activity logs and returns any saved processing reasoning.
-
approvals_getGet the details of a pending or resolved approval request by ID.
-
approvals_approveApprove a pending approval request and execute the stored capability input.
-
approvals_rejectReject a pending approval request without executing the stored capability input.
-
documents_searchSearch, filter, and retrieve user's documents. Supports text search, filtering by document type, export status, date ranges, sorting, and semantic similarity. Use documents.count for totals or grouped summaries across all matching documents.
-
documents_getRetrieve a single document by ID with full details. Returns all extracted fields including merchant info, line items, amounts, file URL, and source.
-
documents_updateUpdate a single document by ID. Use this for precise corrections to extracted document fields that should not be applied through bulk edit.
-
documents_list-duplicatesList existing duplicate document groups for the current workspace.
-
documents_scan-duplicatesScan active unresolved documents in the current workspace for likely duplicate groups. Read-only: returns candidate groups and recommended canonical documents without mutating data.
-
documents_inspectInspect the original document file (image/PDF) with a vision model and compare visible values against currently stored extracted fields.
-
documents_countCount documents and aggregate data. Use for spending totals and financial analysis. Supports grouping by merchant, category, date, export status, etc. Gets ALL matching documents.
-
documents_bulk-editBulk edit documents. Supports dry-run preview (default) and execute modes. Preview returns matching documents with proposed changes and available merchants/categories for context.
-
documents_resolve-duplicatesAnalyze a selected set of documents as possible duplicates. Use dryRun=true (default) to preview the recommended canonical/master document first. Use dryRun=false with masterId to apply the duplicate grouping and archive the non-master duplicates.
-
documents_deleteSoft-delete a document (receipt, invoice, etc.). The document is archived and can be recovered. Also archives any duplicate documents and cleans up cross-references.
-
documents_unarchiveRestore a previously archived document so it is active again.
-
currency_convertConvert amounts between different currencies. Uses current rates by default, or historical rates for a specific date.
-
integrations_listList available integrations for the user. Can filter by category (email, accounting, storage, social, banking) and status. Returns integration IDs needed for sendToIntegration, reconcileWithIntegration, and other operations.
-
integrations_sendSend a document (receipt/invoice) to a supported accounting integration (Xero or QuickBooks). Requires integrationId. targetId is required for Xero/QuickBooks. Set dryRun=true (default) to preview, dryRun=false to queue for sending.
-
integrations_reconcileReconcile a document (receipt/invoice) with a supported banking integration such as Mercury. Requires integrationId. targetId is optional for Mercury. Set dryRun=true (default) to preview, dryRun=false to queue for reconciliation.
-
integrations_unlinkUnlink a document from an integration (supports Xero and QuickBooks). Set dryRun=true (default) to preview, including invoice details and orphaned attachments. Set dryRun=false to execute. This action is IRREVERSIBLE.
-
rules_listList automation rules for the user. In Receiptor, rules, automations, and workflows refer to the same concept. Shows rule information including name, status, trigger type, and execution stats.
-
rules_executeCreate an automation rule from a natural language description. In Receiptor, rules, automations, and workflows refer to the same concept. Approval includes the generated rule details before creation.
-
rules_deleteDelete an automation rule permanently. Use this when a rule, automation, or workflow should be removed entirely.
-
rules_disableDisable an automation rule without deleting it. Use this when a rule should stop running but remain available for later re-enabling.
-
views_listList saved document views for the current workspace. These saved views can be reused by rules, automations, and workflows.
-
views_createCreate a saved document view from document filters. Saved views are reusable inputs for rules, automations, and workflows.
-
views_deleteDelete a saved document view. Use this when a saved filter preset is no longer needed.
-
workspaces_listList available workspaces (organizations) for the authenticated user.
-
chartOfAccounts_listAccountsList or search accounts from the active chart of accounts for the current workspace so the agent can ground categorization decisions.
-
exports_listList export records with filters (document, integration, date range) for the current workspace.
-
exports_getGet one export record by ID for the current workspace.
-
sources_email_enable-monitoringEnable monitoring for an email source to resume automatic document ingestion.
-
sources_email_deleteDelete an email source from the account and stop monitoring it permanently.
-
sources_email_disable-monitoringDisable monitoring for an email source without removing the connection.
-
sources_mobile-scanners_activateActivate a mobile scanner so documents from that number are processed again.
-
sources_mobile-scanners_enable-aiEnable AI extraction for a mobile scanner without changing the source registration.
-
sources_mobile-scanners_deleteDelete a mobile scanner from the account permanently.
-
sources_mobile-scanners_deactivateDeactivate a mobile scanner without deleting it.
-
sources_mobile-scanners_disable-aiDisable AI extraction for a mobile scanner without removing the source.
-
entities_cleanupAnalyze and clean up the user's own business entities: enrich with Google Places data, find duplicates via place_id and embedding similarity, and merge them. This is for companies/legal entities/subsidiaries, not merchant or document duplicates.
-
entities_listList and search business entities with pagination.
-
entities_upsertCreate a new business entity or update an existing one.
-
entities_deleteDelete a business entity and unlink associated documents.
-
entities_mergeMerge multiple business entities into one. Reassigns all linked documents to the kept entity, adds merged entity names as aliases, and deletes the duplicates.
-
memories_saveSave an explicit long-term memory or preference for the current user, workspace, or document.
-
memories_archiveArchive a stored long-term memory so it is no longer used at runtime.
-
memories_listList current long-term memories stored for the current user/workspace.