# Billogram MCP by usefulapi

> Billogram MCP by usefulapi is an MCP server. Read invoices, customers, items and balances; create invoices, customers and items in Billogram. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Website:** https://usefulapi.io/billogram/
- **Repository:** https://github.com/m190/usefulapi-mcp/tree/HEAD/servers/billogram
- **MCP Registry name:** io.usefulapi/billogram
- **Listing updated:** 2026-11-13

## About

Read invoices, customers, items and balances; create invoices, customers and items in Billogram.

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http billogram https://billogram.usefulapi.io/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://billogram.usefulapi.io/mcp
```

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

```json
{
  "mcpServers": {
    "billogram": {
      "url": "https://billogram.usefulapi.io/mcp"
    }
  }
}
```

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

```json
{
  "servers": {
    "billogram": {
      "type": "http",
      "url": "https://billogram.usefulapi.io/mcp"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "billogram": {
      "serverUrl": "https://billogram.usefulapi.io/mcp"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "billogram": {
      "type": "http",
      "url": "https://billogram.usefulapi.io/mcp"
    }
  }
}
```

## Tools

- `billogram_list_invoices`: List invoices (Billogram calls them billograms): invoice number, customer, dates, state, totals and remaining sum. Optional filter and sort. Use an id from the reply with billogram_get_invoice. GET /billogram.
- `billogram_get_invoice`: Fetch one invoice with its customer, items, totals, state, dates and registered payments. GET /billogram/{id}.
- `billogram_list_invoice_events`: List invoice events (the history of changes, such as sent, paid or reminded) as Billogram returns them. Optional filter and sort. GET /billogram_event.
- `billogram_list_customers`: List customers with number, name, organisation and VAT number, contact, addresses and payment settings. Optional filter and sort. GET /customer.
- `billogram_get_customer`: Fetch one customer by customer number: contact, addresses, e-invoice details and payment settings. GET /customer/{customer_no}.
- `billogram_get_customer_balance`: Fetch the balance of one customer by customer number (the amount they owe). GET /customer/{customer_no}/balance.
- `billogram_list_items`: List saved items (products and services) with item number, title, price, VAT, unit and bookkeeping accounts. Optional filter and sort. GET /item.
- `billogram_get_item`: Fetch one saved item by item number. GET /item/{item_no}.
- `billogram_get_settings`: Fetch the account settings: company details, default due days, currency and invoice defaults. GET /settings.
- `billogram_create_customer`: Create a customer. Only the fields you pass are set. Creates a new customer record each time (it is not idempotent). POST /customer.
- `billogram_create_item`: Create a saved item (product or service) for later invoices. Creates a new item each time (it is not idempotent). POST /item.
- `billogram_create_invoice`: Create an invoice (a Billogram billogram) for an existing customer. The invoice is created only: this server does not send it, and sending is a separate Billogram command that is not exposed. Creates a new invoice each time (it is not idempotent). POST /billogram.

## FAQ

### How do I add Billogram MCP by usefulapi to Claude Code?

Run this command in your terminal: claude mcp add --transport http billogram https://billogram.usefulapi.io/mcp

---
Source: https://ai-powered.com/mcp/billogram-mcp-by-usefulapi
