Billogram MCP by usefulapi

io.usefulapiPublished by usefulapi.ioOfficial publisherv1.0.0Updated Nov 8, 2026

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

The publisher's own server: Ably MCP by usefulapi

VerifiedStreamable HTTPWeb executableFinanceBusiness & Commerce

Overview

AI-generated overview

Hosted MCP server for Billogram billing: read invoices, customers, items and balances, and create invoices, customers and items.

What you can do
  • List and fetch invoices with items, totals, state, dates and registered payments
  • List invoice events such as sent, paid or reminded
  • List and fetch customers, and read a customer's outstanding balance
  • List and fetch saved items (products and services) with prices, VAT and bookkeeping accounts
  • Read account settings: company details, due days, currency and invoice defaults
  • Create customers, items and invoices (creation only; sending is not exposed)
When to use it
Useful when you want an assistant to answer questions about Billogram invoices, customers and outstanding balances, or to draft new customers, items and invoices from a conversation without opening the Billogram dashboard.
Requirements
Remote endpoint connected by URL; no local install. Sign-in uses OAuth, and the login page asks for a Billogram API User ID, API Password and an environment choice (Production or Sandbox). The API user is created in Billogram under Company Settings, API, API Users. A free plan allows 50 tool calls per month; paid plans are billed per user.
Before you install
The server asks for Billogram API credentials on its own login page and stores them per user. Create tools write new records and are not idempotent, so repeated calls make duplicates; confirm before creating. Created invoices are not sent. Paid plans involve Stripe checkout and charges, and cancelling does not refund the current period. Usage is metered against a monthly call limit.

Installation

In SourceWeft

  1. Open Billogram MCP by usefulapi in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.usefulapi%2Fbillogram/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

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

README

Billogram MCP by usefulapi

Use your Billogram account from Claude, Cursor, or any MCP client. Read invoices, customers, items and balances, and create invoices, customers and items. Hosted, no local install: connect with your own credentials.

Live endpoint: https://billogram.usefulapi.io/mcp · Homepage: https://usefulapi.io

Connect

  • Claude (claude.ai, Desktop): open Customize → Connectors, click + Add → Add custom connector, and paste https://billogram.usefulapi.io/mcp.
  • Claude Code: claude mcp add --transport http billogram https://billogram.usefulapi.io/mcp, then run /mcp to log in.
  • VS Code: Add to VS Code.
  • Cursor and other clients: add the URL as a remote MCP server:
json
{  "mcpServers": {    "billogram": {      "url": "https://billogram.usefulapi.io/mcp"    }  }}

Add only the URL. Do not add an Authorization header or an API key to the client config: the server signs you in with OAuth, and the login page asks for your Billogram credentials.

Step-by-step setup, where to find your credentials, and FAQ: https://usefulapi.io/billogram/

On first connect you provide your API User ID and API Password, and choose the Environment (Production or Sandbox). Create the API user in Billogram under Company Settings → API → API Users. The server validates it and stores it per user. No keys go in config files.

Tools

ToolTypeWhat it does
billogram_list_invoicesreadList invoices
billogram_get_invoicereadGet invoice
billogram_list_invoice_eventsreadList invoice events
billogram_list_customersreadList customers
billogram_get_customerreadGet customer
billogram_get_customer_balancereadGet customer balance
billogram_list_itemsreadList items
billogram_get_itemreadGet item
billogram_get_settingsreadGet settings
billogram_create_customerwriteCreate customer
billogram_create_itemwriteCreate item
billogram_create_invoicewriteCreate invoice
billogram_usage_statusmetaUsage status (free-tier meter)
billogram_request_featuremetaRequest a missing feature
billogram_upgrademetaUpgrade to Pro or Pro+
billogram_cancel_subscriptionmetaCancel the Pro subscription

read tools are read-only; write tools mutate data (clients should confirm them); meta tools report usage, manage your subscription or send a feature request.

Pricing

PlanPriceLimit
Free$050 tool calls / month
Pro (per user)$9/mo or $90/yr (2 months free)10,000 tool calls / month
Pro+ (per user)$39/mo or $390/yr (2 months free)100,000 tool calls / month

Each paid plan covers this server only. Ask your AI to run billogram_upgrade and choose Pro or Pro+, billed monthly or yearly (it returns a Stripe Checkout link). If you already have Pro, ask to change it to Pro+. The change requires your confirmation, keeps your billing interval and charges the price difference for the rest of the period immediately. Cancel any time with billogram_cancel_subscription: your paid plan continues to the end of the paid period, with no refund for the current period, and asking to resume the same plan with billogram_upgrade before then undoes the cancel. Or write to [email protected].

License

MIT — see LICENSE. Documentation only; the server is hosted.

Source: servers/billogram/README.md at commit 0be0869

Tools

12

billogram_list_invoices

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.

Parameterspagepage_sizefilter_typeorder_fieldfilter_fieldfilter_valueorder_direction

billogram_get_invoice

Get invoice

Fetch one invoice with its customer, items, totals, state, dates and registered payments. GET /billogram/{id}.

Parametersidrequired

billogram_list_invoice_events

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.

Parameterspagepage_sizefilter_typeorder_fieldfilter_fieldfilter_valueorder_direction

billogram_list_customers

List customers

List customers with number, name, organisation and VAT number, contact, addresses and payment settings. Optional filter and sort. GET /customer.

Parameterspagepage_sizefilter_typeorder_fieldfilter_fieldfilter_valueorder_direction

billogram_get_customer

Get customer

Fetch one customer by customer number: contact, addresses, e-invoice details and payment settings. GET /customer/{customer_no}.

Parameterscustomer_norequired

billogram_get_customer_balance

Get customer balance

Fetch the balance of one customer by customer number (the amount they owe). GET /customer/{customer_no}/balance.

Parameterscustomer_norequired

billogram_list_items

List items

List saved items (products and services) with item number, title, price, VAT, unit and bookkeeping accounts. Optional filter and sort. GET /item.

Parameterspagepage_sizefilter_typeorder_fieldfilter_fieldfilter_valueorder_direction

billogram_get_item

Get item

Fetch one saved item by item number. GET /item/{item_no}.

Parametersitem_norequired

billogram_get_settings

Get settings

Fetch the account settings: company details, default due days, currency and invoice defaults. GET /settings.

Takes no parameters.

billogram_create_customer

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.

Parameterscitynamerequiredemailphoneorg_novat_nocountryzipcodecontact_namestreet_address

billogram_create_item

Create item

Create a saved item (product or service) for later invoices. Creates a new item each time (it is not idempotent). POST /item.

Parametersvatrequiredunitrequiredpricerequiredtitlerequireditem_nodescription

billogram_create_invoice

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.

Parametersitemsrequiredcurrencydue_datedue_dayscustomer_norequiredinvoice_date

Version history

1
  1. v1.0.0LatestNov 8, 2026

Score

100% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

Other Usefulapi integrations