receiptconverter-mcp

MCP server for ReceiptConverter — parse any receipt or invoice into structured JSON with a single tool call.

Connects Claude Desktop, Cursor, Windsurf, and any Model Context Protocol client directly to the ReceiptConverter API. No HTTP setup required — just drop in your API key and your AI assistant can scan receipts natively.

Quick start

1. Get an API key

Sign in at receiptconverter.com, open Dashboard → API Keys, and generate a key.

2. Add to Claude Desktop

Edit ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "receiptconverter": {
      "command": "npx",
      "args": ["receiptconverter-mcp"],
      "env": {
        "RECEIPTCONVERTER_API_KEY": "sk_live_your_key_here"
      }
    }
  }
}

Restart Claude. You'll see receiptconverter appear in the tools panel.

3. Add to Cursor

Open Cursor Settings → MCP and add:

{
  "receiptconverter": {
    "command": "npx",
    "args": ["receiptconverter-mcp"],
    "env": {
      "RECEIPTCONVERTER_API_KEY": "sk_live_your_key_here"
    }
  }
}

Tools

convert_receipt

Parse a receipt or invoice image/PDF into structured JSON.

| Parameter | Type | Description | |---|---|---| | url | string | Public URL of a receipt image or PDF | | file_path | string | Absolute path to a local file | | file_name | string | Optional filename hint |

One of url or file_path is required.

Supported formats: JPG, PNG, WEBP, HEIC, TIFF, BMP, PDF (text-based)

Returns:

{
  "vendor": "Starbucks",
  "date": "2024-03-15",
  "total": 12.50,
  "subtotal": 11.00,
  "tip": 1.50,
  "currency": "USD",
  "payment_method": "Visa",
  "category": "Food & Drink",
  "taxes": [{ "label": "Sales Tax", "rate": 8.875, "amount": 0.98 }],
  "items": [
    { "name": "Oat Latte", "quantity": 1, "unit_price": 6.50, "total_price": 6.50 },
    { "name": "Croissant",  "quantity": 1, "unit_price": 4.50, "total_price": 4.50 }
  ]
}

Example prompts:

• "Parse the receipt at https://example.com/receipt.jpg"
• "Convert /Users/me/Downloads/expense.pdf to JSON"
• "Extract all line items from this receipt and add them to my expense spreadsheet"

check_usage

Check your remaining conversions for the current billing period.

No parameters required.

Example — Claude workflow

You: Parse this receipt and add the total to my expenses spreadsheet
     [attaches receipt.jpg]

Claude: I'll use the convert_receipt tool to parse this.

        Vendor:    Whole Foods Market
        Date:      2024-03-20
        Total:     USD 47.83
        Items (6): Organic Milk × 1 @ $5.99 ...
        Category:  Groceries

        I've extracted 6 line items. Want me to format these for your spreadsheet?

Pricing

The MCP server uses your ReceiptConverter API key. See receiptconverter.com/pricing for plan details.

• Free tier: limited conversions/month
• Pro plan: 100 conversions/month
• API plan: higher limits

Links

• API Docs
• Quickstart
• MCP Integration Guide
• Dashboard

License

MIT