Skip to content
MCP server

Invoicebox

MCP server letting AI assistants issue Invoicebox invoices, check payments and process

Runs locally
Install

Invoicebox is an open-source MCP server for finance and payments. It runs locally on your machine and is started by your AI client.

Pricing
Open source
Platforms
CLI, API, Self-hosted
Runs
Locally
Version
0.2.1
Listing updated

Similar MCP servers

Install

Run in a 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

Add to claude_desktop_config.json

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

Add to ~/.cursor/mcp.json

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

Add to .vscode/mcp.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>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Using several servers? Build one config file with the MCP config generator.

Configuration

  • INVOICEBOX_API_TOKENТокен API Инвойсбокса. Выпускается в личном кабинете; правами токена ограничивается то, что сервер вообще может сделатьRequired
  • INVOICEBOX_MERCHANT_IDИдентификатор магазина, от имени которого работает серверRequired
  • INVOICEBOX_ENVКонтур: demo или prod. По умолчанию demo — боевой включается явно
  • INVOICEBOX_TOOLSETSНаборы инструментов через запятую: read по умолчанию, write и refund включаются явно
  • INVOICEBOX_STATE_DIRКаталог состояния: без него защита от дублей действует только в пределах одного запуска

About Invoicebox

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.

Tools this server provides (8)

Taken from the project documentation; the running server may differ.

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

What it does

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

Pricing

Open source

Open-source MCP server; it uses the Invoicebox API, which is a commercial service.

Prices change. Check docs.invoicebox.ru before you buy.

Invoicebox 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.

How AIPoweredBot checks servers