# smallinvoice MCP by usefulapi

> smallinvoice MCP by usefulapi is an MCP server. Read smallinvoice contacts, invoices, offers, projects and hours; create contacts and invoices. It runs as a hosted remote server, so there is nothing to install locally.

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

## About

Read smallinvoice contacts, invoices, offers, projects and hours; create contacts and invoices.

## Install

### Claude Code (Terminal)

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

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

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

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

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

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

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

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

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

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

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

## Tools

- `smallinvoice_get_owner`: The smallinvoice account the API client belongs to (the owner's id and details). A cheap check that the connection works. GET /auth/owner.
- `smallinvoice_list_contacts`: List contacts (customers and suppliers): name, type (company or person), relation, e-mail, currency. Add with=main_address for the address. Needs the "contact" scope. GET /contacts. Returns count, total, next_offset (pass it as offset for the next page) and the items.
- `smallinvoice_get_contact`: One contact by id, with its fields. Add with=main_address for the main address. Needs the "contact" scope. GET /contacts/{id}.
- `smallinvoice_list_contact_addresses`: All addresses of one contact. Needs the "contact" scope. GET /contacts/{contactId}/addresses.
- `smallinvoice_list_contact_people`: The contact persons of one company contact. Needs the "contact" scope. GET /contacts/{contactId}/people.
- `smallinvoice_list_contact_groups`: List the contact groups. Needs the "contact" scope. GET /contacts/configuration/groups. Returns count, total, next_offset (pass it as offset for the next page) and the items.
- `smallinvoice_list_invoices`: List invoices: number, contact, dates, total, currency, status. Filter by contact_id or a JSON filter. Needs the "invoice" scope. GET /receivables/invoices. Returns count, total, next_offset (pass it as offset for the next page) and the items.
- `smallinvoice_get_invoice`: One invoice by id with its positions, totals and status. Needs the "invoice" scope. GET /receivables/invoices/{id}.
- `smallinvoice_list_invoice_payments`: The payments recorded on one invoice. Needs the "invoice" scope. GET /receivables/invoices/{invoiceId}/payments.
- `smallinvoice_list_offers`: List offers (quotes). Filter by contact_id or a JSON filter. Needs the "offer" scope. GET /receivables/offers. Returns count, total, next_offset (pass it as offset for the next page) and the items.
- `smallinvoice_get_offer`: One offer (quote) by id with its positions and totals. Needs the "offer" scope. GET /receivables/offers/{id}.
- `smallinvoice_list_order_confirmations`: List order confirmations. Filter by contact_id or a JSON filter. Needs the "order_confirmation" scope. GET /receivables/order-confirmations. Returns count, total, next_offset (pass it as offset for the next page) and the items.
- `smallinvoice_get_order_confirmation`: One order confirmation by id. Needs the "order_confirmation" scope. GET /receivables/order-confirmations/{id}.
- `smallinvoice_list_delivery_notes`: List delivery notes. Filter by contact_id or a JSON filter. Needs the "delivery_note" scope. GET /receivables/delivery-notes. Returns count, total, next_offset (pass it as offset for the next page) and the items.
- `smallinvoice_get_delivery_note`: One delivery note by id. Needs the "delivery_note" scope. GET /receivables/delivery-notes/{id}.
- `smallinvoice_list_products`: List the catalog's products (articles). Needs the "catalog" scope. GET /catalog/products. Returns count, total, next_offset (pass it as offset for the next page) and the items.
- `smallinvoice_list_services`: List the catalog's services. Needs the "catalog" scope. GET /catalog/services. Returns count, total, next_offset (pass it as offset for the next page) and the items.
- `smallinvoice_list_units`: List the units (piece, hour, ...) with their ids, which an invoice position's unit_id refers to. Needs the "configuration" scope. GET /catalog/configuration/units. Returns count, total, next_offset (pass it as offset for the next page) and the items.
- `smallinvoice_list_bank_accounts`: List the account's bank accounts (as printed on documents). Needs the "configuration" scope. GET /configuration/bank-accounts. Returns count, total, next_offset (pass it as offset for the next page) and the items.
- `smallinvoice_list_projects`: List projects. Needs the "project" scope. GET /reporting/projects. Returns count, total, next_offset (pass it as offset for the next page) and the items.
- `smallinvoice_get_project`: One project by id. Needs the "project" scope. GET /reporting/projects/{id}.
- `smallinvoice_list_working_hours`: List recorded working hours (time tracking entries). Needs the "working_hours" scope. GET /reporting/working-hours. Returns count, total, next_offset (pass it as offset for the next page) and the items.
- `smallinvoice_list_efforts`: List efforts (expenses and services recorded against projects). Needs the "effort" scope. GET /reporting/efforts. Returns count, total, next_offset (pass it as offset for the next page) and the items.
- `smallinvoice_list_activities`: List activities (the kinds of work that hours are booked on). Needs the "activity" scope. GET /reporting/activities. Returns count, total, next_offset (pass it as offset for the next page) and the items.
- `smallinvoice_list_cost_units`: List cost units. Needs the "cost_unit" scope. GET /reporting/cost-units. Returns count, total, next_offset (pass it as offset for the next page) and the items.
- `smallinvoice_create_contact`: WRITE: creates a new company contact (customer) in smallinvoice, with its main address. Needs the "contact" scope. POST /contacts. Nothing is sent to anyone. Private persons are not supported here (smallinvoice needs more fields for them): create those in smallinvoice. Check smallinvoice_list_contacts first so you do not create a duplicate.
- `smallinvoice_create_invoice`: WRITE: creates a new invoice for a contact. Needs the "invoice" scope. POST /receivables/invoices. It is only created: it is NOT sent by e-mail or post and its status is not changed; the user reviews it in smallinvoice. Not idempotent: calling it twice creates two invoices. Use smallinvoice_list_contacts / smallinvoice_list_units first for the ids.

## FAQ

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

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

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