MCP server
smallinvoice MCP by usefulapi
Read smallinvoice contacts, invoices, offers, projects and hours; create contacts and…
- 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/mcpAdd to Settings → Connectors → Add custom connector
https://smallinvoice.usefulapi.io/mcpInstall 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