
Recite MCP
This server connects Claude to the Recite receipt processing API and maintains a local ledger for bookkeeping workflows. You get 41 API tools covering scans (file, URL, or base64), transactions with filters, batch processing for up to 20 receipts at once, webhook subscriptions for async job completion, reconciliation links and auto-matching, vendor and category management, and CSV/JSON exports. The local tools let you scan directly into a ledger file, process entire directories of receipts, store agent instructions in persistent memory, and run dry-run previews before committing changes. Useful if you're building an expense tracking agent that needs both cloud OCR and local-first data control. Requires an API key from recite.rivra.dev, which includes 30 free scans monthly.
- tools
- 32
- auth
- Secret needed
- transport
- STDIO
- env vars
- 2
- last updated
- Feb 25, 2026
Tools
32 toolsPublic tool metadata for what this MCP can expose to an agent.
scan_receiptScan a receipt from a file, URL, base64, or raw text, with an ephemeral mode.
Scan a receipt from a file, URL, base64, or raw text, with an ephemeral mode.
No parameter schema in public metadata yet.
get_scan
No parameter schema in public metadata yet.
import_transactionsImport transactions from a JSON list, CSV text, or a CSV file.
Import transactions from a JSON list, CSV text, or a CSV file.
No parameter schema in public metadata yet.
submit_batch_scansSubmit 1–20 receipt scans asynchronously with webhook notification.
Submit 1–20 receipt scans asynchronously with webhook notification.
No parameter schema in public metadata yet.
get_batch_scan_status
No parameter schema in public metadata yet.
get_batch_scan_results
No parameter schema in public metadata yet.
get_summaryGet a summary by period, date range, or group-by.
Get a summary by period, date range, or group-by.
No parameter schema in public metadata yet.
create_reconciliation_link
No parameter schema in public metadata yet.
list_reconciliation_links
No parameter schema in public metadata yet.
update_reconciliation_link
No parameter schema in public metadata yet.
delete_reconciliation_link
No parameter schema in public metadata yet.
run_auto_match
No parameter schema in public metadata yet.
get_reconciliation_summary
No parameter schema in public metadata yet.
get_reconciliation_recommendations
No parameter schema in public metadata yet.
export_reconciliation
No parameter schema in public metadata yet.
get_categoriesGet the 17 built-in and custom categories.
Get the 17 built-in and custom categories.
No parameter schema in public metadata yet.
create_category
No parameter schema in public metadata yet.
delete_category
No parameter schema in public metadata yet.
get_vendors
No parameter schema in public metadata yet.
create_vendor
No parameter schema in public metadata yet.
delete_vendor
No parameter schema in public metadata yet.
get_usageGet usage by period or breakdown.
Get usage by period or breakdown.
No parameter schema in public metadata yet.
export_transactionsExport transactions as CSV or JSON, with optional file save.
Export transactions as CSV or JSON, with optional file save.
No parameter schema in public metadata yet.
process_receiptScan a receipt and append it to the ledger in one step.
Scan a receipt and append it to the ledger in one step.
No parameter schema in public metadata yet.
process_receipts_batchScan a directory of images or PDFs, with recursive and dry-run options.
Scan a directory of images or PDFs, with recursive and dry-run options.
No parameter schema in public metadata yet.
summarize_ledgerSummarize the local CSV ledger.
Summarize the local CSV ledger.
No parameter schema in public metadata yet.
export_ledgerExport the local CSV ledger.
Export the local CSV ledger.
No parameter schema in public metadata yet.
add_ledger_correctionAdd a correction to the local CSV ledger.
Add a correction to the local CSV ledger.
No parameter schema in public metadata yet.
update_memoryStore persistent agent instructions.
Store persistent agent instructions.
No parameter schema in public metadata yet.
list_memoryList stored persistent agent instructions.
List stored persistent agent instructions.
No parameter schema in public metadata yet.
get_configInspect configuration.
Inspect configuration.
No parameter schema in public metadata yet.
validate_setupCheck configuration and health.
Check configuration and health.
No parameter schema in public metadata yet.
Sponsors
Configuration
RECITE_API_KEY*secretRecite API key used for receipt processing requests.
RECITE_HOMEOptional local data directory for config, ledger, and memory files.
Readme
recite-mcp
mcp-name: io.github.rivradev/recite-mcp
recite-mcp is an MCP server for the Recite API. It provides the full documented Recite MCP surface for scans, transactions, imports, batch jobs, projects, summaries, webhooks, rules, usage, and exports, while preserving the local ledger/memory workflow for agents that want local-first bookkeeping.
Install
End users
Recommended:
uvx recite-mcp
Alternative (pipx):
pipx install recite-mcp
Alternative (pip):
python -m pip install recite-mcp
Contributors
python -m pip install -e .[dev]
pytest -q
python -m recite_mcp.server
Required Environment
Get an API key at https://recite.rivra.dev/settings/api (includes 30 free scans per month), then set RECITE_API_KEY (required to process receipts; server can still start without it so validate_setup() can report what's missing):
# Windows PowerShell
$env:RECITE_API_KEY="re_live_xxx"
# macOS/Linux
export RECITE_API_KEY="re_live_xxx"
Optional home override:
# Windows PowerShell
$env:RECITE_HOME="C:\path\to\recite-home"
Details
- Repository
- github.com/rivradev/recite-mcp
- Category
- AI & LLM Tools
- Package
recite-mcp- Transport
- STDIO
- Auth
- Required
- Registry
- MCP registry, active