# Invoicebox

> Invoicebox is an open-source MCP server for finance and payments. MCP server letting AI assistants issue Invoicebox invoices, check payments and process. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, API, Self-hosted
- **Website:** https://docs.invoicebox.ru/mcp/
- **Repository:** https://github.com/invoicebox/invoicebox-mcp-server
- **MCP Registry name:** ru.invoicebox/mcp-server
- **Categories:** [finance and payments](https://ai-powered.com/categories/finance-and-payments)
- **Listing updated:** 2026-11-21

## About

The Invoicebox MCP server connects assistants such as Claude Desktop, Cursor and VS Code to the Invoicebox billing API, so an invoice can be drafted, sent as a payment link and tracked from inside a chat instead of the merchant dashboard. Every money-moving action goes through a two-step flow: the first call returns a summary and a one-time token valid for 15 minutes, and only the second call executes it. Amounts above a configurable threshold trigger a separate human confirmation.

Access is read-only by default. Invoice creation, cancellation and shipment confirmation sit in a write toolset, and refunds in a separate refund toolset, both enabled explicitly through configuration. The README recommends starting against the public demo store, which is shared and should not receive real customer data.

The server is aimed at merchants and developers who already use Invoicebox and want assistant-driven billing for business buyers and individuals. It does not send invoices to buyers itself, manage subscriptions, charge saved cards, or list incoming payments, according to the product documentation.

## Features

- **Two-step confirmation:** Each write action first returns a summary and a short-lived token, and only a second call with that token runs it.
- **Read-only default:** Only lookup and listing tools are active until the write or refund toolsets are switched on.
- **Large-amount approval:** Transactions above a set threshold require the human operator to confirm rather than accepting the model's figure.
- **Duplicate protection:** Operation identifiers are derived from the request content so a repeated call returns the earlier result instead of creating a second invoice.
- **Company lookup by tax ID:** Buyer company details can be pulled from the Russian tax identifier (INN) when issuing an invoice.
- **Stdio and HTTP transports:** Runs as a local stdio process by default, or as a Streamable HTTP server when a port is set.

## Good for

- Issue an invoice to a business buyer from a chat and send the payment link in the same conversation
- Check whether a specific invoice has been paid using the merchant's own order number
- List unpaid invoices for a period to review amounts and due dates
- Confirm a shipment against an invoice so closing documents are generated
- Start a refund for a paid order, in full or for selected items, with explicit approval

## Install

### Claude Code (Terminal)

```sh
claude mcp add mcp-server --env INVOICEBOX_API_TOKEN='<INVOICEBOX_API_TOKEN>' --env INVOICEBOX_MERCHANT_ID='<INVOICEBOX_MERCHANT_ID>' -- npx -y @invoicebox/mcp-server
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@invoicebox/mcp-server"
      ],
      "env": {
        "INVOICEBOX_API_TOKEN": "<INVOICEBOX_API_TOKEN>",
        "INVOICEBOX_MERCHANT_ID": "<INVOICEBOX_MERCHANT_ID>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@invoicebox/mcp-server"
      ],
      "env": {
        "INVOICEBOX_API_TOKEN": "<INVOICEBOX_API_TOKEN>",
        "INVOICEBOX_MERCHANT_ID": "<INVOICEBOX_MERCHANT_ID>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "mcp-server": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@invoicebox/mcp-server"
      ],
      "env": {
        "INVOICEBOX_API_TOKEN": "<INVOICEBOX_API_TOKEN>",
        "INVOICEBOX_MERCHANT_ID": "<INVOICEBOX_MERCHANT_ID>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@invoicebox/mcp-server"
      ],
      "env": {
        "INVOICEBOX_API_TOKEN": "<INVOICEBOX_API_TOKEN>",
        "INVOICEBOX_MERCHANT_ID": "<INVOICEBOX_MERCHANT_ID>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@invoicebox/mcp-server"
      ],
      "env": {
        "INVOICEBOX_API_TOKEN": "<INVOICEBOX_API_TOKEN>",
        "INVOICEBOX_MERCHANT_ID": "<INVOICEBOX_MERCHANT_ID>"
      }
    }
  }
}
```

## Tools

- `lookup_company_by_inn`: Company or sole trader details by INN
- `get_order`: Invoice by identifier or merchant order number
- `find_orders`: Invoice list filtered by number, status, dates and amounts
- `find_shipments`: Shipments for an order and their status
- `create_order`: Issues an invoice and returns a payment link
- `cancel_order`: Cancels an unpaid invoice
- `create_shipment`: Confirms a shipment; generates act, invoice and UPD documents
- `create_refund`: Refunds a payment in full or by item

## FAQ

### Which assistants can use Invoicebox?

The README and documentation name Claude Desktop, Claude Code, Cursor, VS Code, Cline and Continue.dev as MCP clients, and note that LangChain and LangGraph agents can connect through an MCP adapter.

### Are write operations enabled by default?

No. The default toolset is read only; write and refund toolsets must be enabled explicitly through the INVOICEBOX_TOOLSETS setting.

### What does the server not do?

According to the documentation it does not keep a register of incoming payments, send invoices to buyers, manage subscriptions, charge saved cards or manage Витрина storefronts.

### Is there a way to try Invoicebox without a contract?

The README describes a public demo store configured with ENV set to demo, which is shared among all readers and should not be used with real data.

### Is Invoicebox free?

Yes. Invoicebox is open source, so you can use and self-host it for free.

### How do I add Invoicebox to Claude Code?

Run this command in your terminal: claude mcp add mcp-server --env INVOICEBOX_API_TOKEN='<INVOICEBOX_API_TOKEN>' --env INVOICEBOX_MERCHANT_ID='<INVOICEBOX_MERCHANT_ID>' -- npx -y @invoicebox/mcp-server

### What are the best alternatives to Invoicebox?

The closest alternatives to Invoicebox are QuickBooks Online MCP Server, QuickBooks Online, BTCPay Server MCP, Alternative Payments and Money Magician.

## Where this comes from

- Description: written from the project's README, the project's website and its MCP Registry entry.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [QuickBooks Online MCP Server](https://ai-powered.com/mcp/quickbooks-online-mcp-server): QuickBooks Online MCP Server is an open-source MCP server for finance and payments.
- [QuickBooks Online](https://ai-powered.com/mcp/quickbooks-online-3): QuickBooks Online is an open-source MCP server for finance and payments.
- [BTCPay Server MCP](https://ai-powered.com/mcp/btcpay-server-mcp): BTCPay Server MCP is an open-source MCP server for finance and payments.
- [Alternative Payments](https://ai-powered.com/mcp/alternative-payments-2): Alternative Payments is an open-source MCP server for finance and payments.
- [Money Magician](https://ai-powered.com/mcp/money-magician): Money Magician is an MCP server for finance and payments.
- [Paas Build MCP](https://ai-powered.com/mcp/paas-build-mcp): Paas Build MCP is a paid MCP server for finance and payments.
- [Steady Dues](https://ai-powered.com/mcp/steady-dues): Steady Dues is a freemium MCP server for finance and payments.
- [FoxyInvoice](https://ai-powered.com/mcp/foxyinvoice-2): FoxyInvoice is a freemium MCP server for finance and payments.

---
Source: https://ai-powered.com/mcp/invoicebox
