rivradev avatar

Recite MCP

rivradev/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 tools

Public 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*secret

Recite API key used for receipt processing requests.

RECITE_HOME

Optional 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"

View the full README on GitHub

Details

Repository
github.com/rivradev/recite-mcp
Category
AI & LLM Tools
Package
recite-mcp
Transport
STDIO
Auth
Required
Registry
MCP registry, active

Related AI & LLM Tools MCP servers

View all
1rjandino avatarZopafrjandino/zopafNegotiation math engine. Pareto frontier, counteroffer generation, zero LLM tokens.0stars
2rocnubie avatarMeigen AI MCProcnubie/meigenai-mcpMeigen AI is a curated meigen ai image prompt library.0stars
3rocnubie avatarNano Banana 2 MCProcnubie/nanobanana-2-mcpNano Banana 2 exposes the Nano Banana 2 image generation model online with prompt presets and quick0stars
4rocnubie avatarNano Banana Pro AI MCProcnubie/nanobanana-mcpNano Banana Pro AI image editor free online. Create, edit, and enhance images by Google Gemini AI0stars
5samethoughts avatarHippoDid MCP Serversamethoughts/hippodid-mcp-serverPersistent, structured cloud memory for AI agents. BYOK — bring your own AI key.0stars
6seunghan91 avatarAinoteseunghan91/ainoteAgent-native notes, tasks, dev-docs, vaults, sync & handoffs. MCP + OpenAPI dual surface.0stars