# Invoices Online MCP by usefulapi

> Invoices Online MCP by usefulapi is an MCP server. Read clients, balances, invoices and jobcard status; create clients in Invoices Online. It runs as a hosted remote server, so there is nothing to install locally.

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

## About

Read clients, balances, invoices and jobcard status; create clients in Invoices Online.

## Install

### Claude Code (Terminal)

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

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

```sh
https://invoices-online.usefulapi.io/mcp
```

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

```json
{
  "mcpServers": {
    "invoices-online": {
      "url": "https://invoices-online.usefulapi.io/mcp"
    }
  }
}
```

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

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

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

```json
{
  "mcpServers": {
    "invoices-online": {
      "serverUrl": "https://invoices-online.usefulapi.io/mcp"
    }
  }
}
```

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

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

## Tools

- `invoicesonline_get_business`: Get the id and name of the Invoices Online business this API login belongs to. Read only. Endpoint: getBusinessName.php.
- `invoicesonline_list_clients`: List every client of the business: name, contact, email, VAT number, addresses, active flag, balance and opening balance. Read only. Endpoint: getClients_JSON.php.
- `invoicesonline_get_client`: Get one client by client_id: contact details, active flag, current balance and opening balance. Read only. Endpoint: getClientDetails_JSON.php.
- `invoicesonline_find_client_id`: Look up the client_id from the invoice name, email and branch name. Read only. Endpoint: GetClientID.php. Returns the id, or the vendor's error text when no client matches.
- `invoicesonline_get_client_history`: List a client's invoices, credit notes, pro-forma invoices, payments and payouts with totals and line items, plus the current and opening balance. Read only. Endpoint: getClientHistory_JSON.php.
- `invoicesonline_list_client_documents`: List one client's documents of one type (invoices, quotes, credit notes, jobcards, and so on). Read only. Endpoint: getDocumentsByType_JSON.php.
- `invoicesonline_list_suppliers`: List every supplier of the business with contact details, active flag, balance and opening balance. Read only. Endpoint: getSuppliers_JSON.php.
- `invoicesonline_get_supplier`: Get one supplier by supplier_id: contact details, active flag, balance and opening balance. Read only. Endpoint: getSupplierDetails_JSON.php.
- `invoicesonline_list_inventory_items`: List the inventory and stock items keyed by product code. Read only. Endpoint: InventoryItems.php.
- `invoicesonline_list_inventory_categories`: List the inventory categories keyed by category id. Read only. Endpoint: InventoryCategories.php.
- `invoicesonline_get_document_status_ids`: List the status ids and their names for one document type. Read only. Endpoint: getDocumentStatusIDs.php.
- `invoicesonline_get_document_status`: Get the current status name and status id of one jobcard by its number. Read only. Endpoint: getDocumentStatus.php. Only jobcard is supported.
- `invoicesonline_create_client`: Create a client in the business. Writes data. Only the invoice name and email are required. If the API finds a matching client, it returns that client's id and creates no duplicate. Endpoint: NewClient.php. Sends no email.

## FAQ

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

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

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