# Fakturowo MCP by usefulapi

> Fakturowo MCP by usefulapi is an MCP server. Read invoices, clients and products in Fakturowo; create documents and update payment status. It runs as a hosted remote server, so there is nothing to install locally.

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

## About

Read invoices, clients and products in Fakturowo; create documents and update payment status.

## Install

### Claude Code (Terminal)

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

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

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

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

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

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

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

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

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

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

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

## Tools

- `fakturowo_list_documents`: List invoices and other documents on the account, 100 per page: id (api_numer), type, number, issue and sale date, currency, net/VAT/gross value, seller and buyer, payment status, due date and KSeF number. Filter by document type or by seller/buyer tax number. Values are the vendor's own (dates DD-MM-YYYY; dokument_rodzaj is the type code with a readable name for common types). Fakturowo api_zadan
- `fakturowo_get_document`: One document by its id (api_numer, from fakturowo_list_documents or the id returned when it was created): the header fields and every line item (name, unit, quantity, net/gross price, discount, VAT rate and amount, gross value). Fakturowo api_zadanie=3 with api_numer.
- `fakturowo_get_next_document_number`: The running number Fakturowo will give the next document of a type (the sequence counter saved on the account). Nothing is created. Fakturowo api_zadanie=8.
- `fakturowo_list_clients`: List the saved clients (contractors), 100 per page: id (api_numer), name, address, tax number, contact details, account number and notes. PESEL and ID-card numbers are never returned. Fakturowo api_zadanie=4.
- `fakturowo_get_client`: One saved client by id (api_numer, from fakturowo_list_clients). PESEL and ID-card numbers are never returned. Fakturowo api_zadanie=4 with api_numer.
- `fakturowo_list_products`: List the saved products and services (the catalogue used on documents), 100 per page: id (api_numer), name, unit, VAT rate, net price, gross value, currency, comment, GTU code and discount. Fakturowo api_zadanie=6.
- `fakturowo_get_product`: One saved product by id (api_numer, from fakturowo_list_products). Fakturowo api_zadanie=6 with api_numer.
- `fakturowo_create_document`: WRITE: issue a new document (invoice, proforma, receipt...) on the account. It is saved immediately and takes the next number in its sequence; this tool cannot delete it again, and calling it twice issues two documents. Issue documents one at a time and wait for each reply: Fakturowo says overlapping saves can get the same number when the account's numbering check is off. Needs a buyer and at leas
- `fakturowo_set_document_payment_status`: WRITE: change the payment status of an existing document (unpaid, paid, partially_paid) and optionally the amount already paid. Only those fields are sent; Fakturowo edits the document in place. Fakturowo api_zadanie=1 with api_numer.

## FAQ

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

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

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