Receiptsapi Mcp

by mail2vimal11-arch

130 downloads Not rated yet
GitHub

About

# ReceiptsAPI MCP Server Use ReceiptsAPI directly inside **Claude Desktop** and any MCP-compatible AI client. Parse receipts, invoices, and documents without leaving your AI assistant. [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT) --- ## What it does Gives…

Explore

- Parse receipts and invoices into structured merchant, totals, and line items.
- Extract arbitrary fields from any document type.
- Check monthly usage and remaining quota.
- Works with Claude Desktop, OpenAI, and Anthropic clients.
- Free tier includes 50 documents per month, no credit card required.
- Direct REST API also available for non‑MCP integration.

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name Receiptsapi Mcp
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

pip install mcp httpx

Once installed, just ask Claude naturally:

> "Parse this receipt: https://example.com/receipt.jpg"

> "Extract the invoice number, vendor name, and total from this PDF: [url]"

> "How many docs have I used this month?"

---

tool = requests.get("https://api.receiptsapi.com/v1/tools/openai").json()

client = openai.OpenAI()
response = client.chat.completions.create(
model="gpt-4o",
tools=[tool],
messages=[{"role": "user", "content": "Parse this receipt: https://example.com/receipt.jpg"}]
)
```

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "receiptsapi mcp": {
            "receiptsapi": {
                "command": "python",
                "args": [
                    "/path/to/mcp_server.py"
                ],
                "env": {
                    "MCP_API_KEY": "your_key_here"
                }
            }
        }
    }
}

McpServers

{
    "receiptsapi": {
        "command": "python",
        "args": [
            "/path/to/mcp_server.py"
        ],
        "env": {
            "MCP_API_KEY": "your_key_here"
        }
    }
}

Use ReceiptsAPI directly inside Claude Desktop and any MCP-compatible AI client.

Parse receipts, invoices, and documents without leaving your AI assistant.

License: MIT

---

What it does

Gives your AI assistant three tools:

| Tool | Description |
|---|---|
| parse_receipt | Extract structured data from a receipt or invoice (merchant, totals, line items, date, payment method) |
| extract_document | Extract data from any document — invoice, ID, contract, form. Optionally specify exact fields. |
| check_usage | Check your monthly usage and remaining quota |

Quick Start

1. Get a free API key

Sign up at receiptsapi.com — free tier includes 50 docs/month, no credit card needed.

2. Install

pip install mcp httpx

3. Download the server

curl -O https://raw.githubusercontent.com/YOUR_USERNAME/receiptsapi-mcp/main/mcp_server.py

4. Add to Claude Desktop

Edit ~/.config/claude/claude_desktop_config.json (Mac/Linux) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "receiptsapi": {
      "command": "python",
      "args": ["/path/to/mcp_server.py"],
      "env": {
        "MCP_API_KEY": "sk_live_your_key_here"
      }
    }
  }
}

Restart Claude Desktop. You'll see the ReceiptsAPI tools available.

---

Usage Examples

Once installed, just ask Claude naturally:

> "Parse this receipt: https://example.com/receipt.jpg"

> "Extract the invoice number, vendor name, and total from this PDF: [url]"

> "How many docs have I used this month?"

---

Use with OpenAI

```python
import openai, requests

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.