recite-mcp 0.1.1

Local MCP server for Recite receipt processing

recite-mcp

recite-mcp is a local MCP server for receipt processing with the Recite API. It provides tools for single/batch receipt processing, ledger writes, corrections, memory instructions, and health/status resources.

Install

End users

uvx recite-mcp

Alternative:

python -m pip install recite-mcp

Contributors

python -m pip install -e .[dev]
pytest -q
python -m recite_mcp.server

Required Environment

Set API key:

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

# macOS/Linux
export RECITE_HOME="$HOME/.config/recite"

MCP Client Config

Use uvx for the cleanest user install path:

{
  "mcpServers": {
    "recite": {
      "command": "uvx",
      "args": ["recite-mcp"],
      "env": {
        "RECITE_API_KEY": "re_live_xxx"
      }
    }
  }
}

Main Features

• Single receipt processing and optional file rename
• Batch processing with dry-run preview
• Local CSV ledger append and audit-safe correction entries
• Memory instruction store for categorization rules
• Resource providers for ledger, memory, and health status

Release and Distribution

For post-publish checklist, discoverability, and install guidance for end users:

• docs/publishing_guide.md

Documentation

• Implementation and operations walkthrough: docs/walkthrough.md