Skip to content
MCP server

smallinvoice MCP by usefulapi

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

Install
Runs
Remotely
Version
1.17.0
Listing updated
4 days ago

About smallinvoice MCP by usefulapi

smallinvoice MCP by usefulapi is an MCP server. It runs as a hosted remote server, so there is nothing to install locally.

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

Install

Run in a terminal

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

Add to Settings → Connectors → Add custom connector

https://smallinvoice.usefulapi.io/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "smallinvoice": {
      "url": "https://smallinvoice.usefulapi.io/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

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

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

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

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

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

Tools this server provides (27)

Read directly from the server.

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.

smallinvoice MCP by usefulapi 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