# Receiptor MCP

Connects an AI agent to your Receiptor AI workspace: receipts, bills, and invoices become searchable, editable, and ready for the accountant. Useful when documents live in Receiptor but you want an agent to handle them.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · 2260 installs
- Author: receiptor-ai
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://smithery.ai/server/receiptor-ai/receiptor-mcp
- Updated: 2026-04-28
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/receiptor-mcp

## What it does

The server exposes the Receiptor workspace to an agent. Tools cover search by text, document type, date range, and semantic similarity; a single-document fetch with all extracted fields; and counting with aggregation by merchant, category, or export status. Fields can be corrected one at a time through `documents_update` or in bulk via `documents_bulk-edit`, which previews changes before applying them.

Duplicate handling is a separate toolset. `documents_scan-duplicates` finds likely duplicate groups without touching data, and `documents_resolve-duplicates` archives non-canonical copies after a dry-run preview. `documents_inspect` lets a vision model read the original scan and compare visible values against stored fields.

Integration tools send documents to Xero or QuickBooks, reconcile them with Mercury, and unlink them when needed. All integration actions default to dry-run preview; actual execution requires `dryRun=false`. Access goes through OAuth and stays scoped to the active workspace, which the agent can switch via `workspace_switch`.

## Requirements
- Remote server: `https://receiptor-mcp.run.tools`

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport http receiptor-mcp https://receiptor-mcp.run.tools
```

### Codex

**Platform CLI: remote server**
```bash
codex mcp add receiptor-mcp --url https://receiptor-mcp.run.tools
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "receiptor-mcp": {
            "url": "https://receiptor-mcp.run.tools"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "receiptor-mcp": {
            "type": "http",
            "url": "https://receiptor-mcp.run.tools"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http receiptor-mcp https://receiptor-mcp.run.tools
```

## When to use it
- find a receipt by merchant name or amount
- group duplicates and archive the extras
- fix a misread field on a single document
- send an invoice to Xero or QuickBooks
- create an automation rule from a plain-language description

## Example prompts
- Find all receipts from Ozon in the last month and sum the totals
- Scan the workspace for duplicates and show which document you recommend as canonical
- Compare visible values on `receipt_0421.pdf` with the stored extracted fields

## Similar
- [HelloBooksAIAgents](https://affpapa.org/en/nevibecode/mcp/hellobooksaiagents.md) — MCP server · 513 installs
- [ap-processor](https://affpapa.org/en/nevibecode/skills/ap-processor.md) — skill · 387 installs
- [xero](https://affpapa.org/en/nevibecode/skills/xero.md) — skill · 346 installs
- [DeepLedger QuickBooks MCP Server for ChatGPT, Claude & AI](https://affpapa.org/en/nevibecode/mcp/deepledger-quickbooks-mcp-server-for-chatgpt-claude-ai.md) — MCP server · ★ 1 repo stars
- [tax-prep](https://affpapa.org/en/nevibecode/skills/tax-prep.md) — skill · 2000 installs
- [QuickBooks Automation](https://affpapa.org/en/nevibecode/skills/quickbooks-automation.md) — skill · 4900 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
