recite-mcp 0.1.3

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

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

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

Copy-paste this config:

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

If installed via pipx or pip, use:

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

Troubleshooting

MCP Registry ownership validation failed

• Symptom: Registry publish returns a PyPI ownership/README validation error.
• Fix: keep this exact line in packaged README: mcp-name: io.github.rivradev/recite-mcp, then bump version and upload new PyPI release before publishing to Registry.

RECITE_API_KEY missing or invalid

• Symptom: setup validation fails or API requests are rejected.
• Fix: set RECITE_API_KEY in MCP client env config (preferred) or shell environment.

uvx command not found

• Symptom: terminal says uvx is not recognized.
• Fix: install uv first, or use one of the alternatives:
  • pipx install recite-mcp
  • python -m pip install recite-mcp

recite-mcp command not found after install

• Symptom: command not recognized after pipx/pip install.
• Fix:
  • For pipx: run pipx ensurepath, then reopen terminal.
  • For pip: run with module entrypoint: python -m recite_mcp.server

MCP client starts but tools are unavailable

• Symptom: server appears configured but no tools/resources are listed.
• Fix:
  • Confirm MCP config JSON is valid.
  • Confirm command and args match your install method (uvx vs recite-mcp).
  • Restart MCP client after config changes.

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

• User guide: docs/user_guide.md
• Publishing and adoption guide: docs/publishing_guide.md