Skip to main content
Glama

wefact-mcp

PyPI version Python License: AGPL-3.0

An MCP server for the Dutch invoicing platform WeFact. Lets any MCP-compatible client (Claude Desktop, Claude Code, Cursor, Zed, …) read and modify your WeFact administration via natural language.

Stop typing in WeFact. Just tell Claude what to do.

Looking for the polished install + EULA + email support? Buy a commercial license: https://easeo.nl/diensten/wefact-mcp.

Quick start

1. Install

pip install wefact-mcp

2. Get a WeFact API key

In WeFact: Instellingen → API. Generate a key and whitelist your machine's IPv4 address (the API does not yet support IPv6).

3. Configure your MCP client

Claude Code

claude mcp add wefact -e WEFACT_API_KEY=your-key-here -- wefact-mcp

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "wefact": {
      "command": "wefact-mcp",
      "env": { "WEFACT_API_KEY": "your-key-here" }
    }
  }
}

Restart your MCP client and the WeFact tools should appear. Try:

Use the wefact-mcp whoami tool.

Related MCP server: AbraFlexi MCP Server

Tools

Generic escape hatch

Tool

Purpose

wefact_request(controller, action, params)

Call any WeFact endpoint.

whoami()

Sanity-check the connection.

Debtors (klanten)

list_debtors, get_debtor, create_debtor, update_debtor

Invoices (verkoopfacturen)

list_invoices, get_invoice, create_invoice, send_invoice, credit_invoice, mark_invoice_paid

Products

list_products, get_product

Subscriptions (abonnementen)

list_subscriptions, get_subscription

Credit invoices (inkoopfacturen)

list_credit_invoices, get_credit_invoice

Prompts

Prompt

Purpose

export_to_nixfact

Walk through migrating a WeFact administration to a Frappe/ERPNext successor.

feature_audit

Inventory which WeFact features your account actually uses.

Field names

Tools that take fields or params use the WeFact field names verbatim (DebtorCode, InvoiceLines, PriceExcl, …). The docs at developer.wefact.com stay directly applicable — copy parameter names from the docs without translation.

Pagination & filtering

List tools fetch all pages by default. Pass limit_pages=1 for the first page only (useful while exploring). Pass modified_since="2026-01-01" for incremental sync.

Limitations

  • WeFact's API is IPv4 only. Hosting this MCP behind an IPv6-only proxy will fail.

  • WeFact rate-limits the API. The client retries on transient failures with exponential backoff; persistent 429s surface as errors.

  • The API is not RESTful: every call is a POST to a single endpoint.

  • Some list endpoints return a flat list rather than the controller-plural key; the client falls back to the first list-valued field. If you hit an oddity, fall back to wefact_request and parse the response yourself.

Security model

  • The MCP server runs on your machine. No data passes through external servers.

  • The WeFact API key stays in your local environment (or your MCP client's config) — never in our hands.

  • No telemetry, no usage tracking, no phone-home.

  • Source available for audit (see Repository).

  • Independently reviewed for SQL injection, auth bypass, and credential leak vectors.

License

wefact-mcp is dual-licensed:

  • AGPL-3.0-or-later — free for AGPL-compatible use. If you run a modified version on a server that interacts with users over a network, you must offer those users the source code (per AGPL §13).

  • Commercial license — €197/year or €497 lifetime, ex VAT. For proprietary integrations, closed-source products, or hosted services that don't meet AGPL §13. Includes email support and 12 months of updates. Buy at https://easeo.nl/diensten/wefact-mcp.

For agency, white-label or platform partnerships — including a WeFact-side official integration — email nick@easeo.nl.

Disclaimer

This project is not affiliated with or endorsed by WeFact B.V. "WeFact" is a trademark of WeFact B.V. Use of this MCP server requires a valid WeFact account and API key, and is bound by WeFact's terms of service.

Available Tools

18 tools
create_debtorA

Create a new debtor.

Args: fields: Dict of WeFact debtor fields. Common ones: CompanyName, Initials, SurName, EmailAddress, Address, ZipCode, City, Country, TaxNumber, Sex. See developer.wefact.com for the full list.

Inputs: fields (required). Returns: result

create_invoiceB

Create a draft invoice.

Args: debtor_code: e.g. 'DB10000'. invoice_lines: list of line dicts. Each can have ProductCode, or free-form Description + PriceExcl + Number + TaxCode etc. extra_fields: any other invoice-level fields (Date, Term, Discount, ReferenceNumber, Comment, ...).

Inputs: debtor_code (required), invoice_lines (required), extra_fields. Returns: result

credit_invoiceC

Credit (reverse) an existing invoice.

Inputs: identifier, invoice_code. Returns: result

get_credit_invoiceC

Fetch a single purchase invoice.

Inputs: identifier, credit_invoice_code. Returns: result

get_debtorA

Fetch a single debtor by DebtorCode (e.g. 'DB10000') or Identifier.

Inputs: identifier, debtor_code. Returns: result

get_invoiceB

Fetch one invoice by InvoiceCode (e.g. '202401001') or Identifier.

Inputs: identifier, invoice_code. Returns: result

get_productC

Fetch a single product.

Inputs: identifier, product_code. Returns: result

get_subscriptionC

Fetch a single subscription.

Inputs: identifier, subscription_code. Returns: result

list_credit_invoicesC

List purchase invoices (inkoopfacturen).

Inputs: limit_pages, creditor_code, modified_since. Returns: result

list_debtorsA

List all debtors (customers).

Args: search_at: Field to search in (e.g. "EmailAddress", "CompanyName", "DebtorCode"). Optional. search_for: Value to search for. Required if search_at is given. modified_since: ISO date or datetime. Only return debtors modified after this point. Critical for incremental sync. limit_pages: If set, fetch at most this many pages (each ~100 items). Default fetches all pages.

Inputs: search_at, search_for, limit_pages, modified_since. Returns: result

list_invoicesB

List invoices.

Args: status: WeFact invoice status (0=concept, 1=sent, 2=partly paid, 3=paid, 4=expired, 5=summation, 6=collection). Optional filter. debtor_code: Filter to a specific debtor. modified_since: ISO date for incremental sync. limit_pages: Cap on pages (1 = first page only).

Inputs: status, debtor_code, limit_pages, modified_since. Returns: result

list_productsC

List all products.

Inputs: limit_pages, modified_since. Returns: result

list_subscriptionsD

List subscriptions.

Inputs: debtor_code, limit_pages, modified_since. Returns: result

mark_invoice_paidA

Mark an invoice as paid.

Args: invoice_code: e.g. '202401001'. pay_date: ISO date. Defaults to today. payment_method: WeFact code, e.g. 'wire' for bank transfer ('banktransfer' is rejected as an invalid payment method).

Inputs: invoice_code (required), pay_date, payment_method. Returns: result

send_invoiceA

Send an existing draft invoice to the debtor.

Args: invoice_code: e.g. '[concept]0001' for a draft. send_method: optional, e.g. 'email' or 'mail'. Omit for the debtor's default.

Inputs: invoice_code (required), send_method. Returns: result

update_debtorA

Update an existing debtor. Only fields you provide are changed.

Inputs: fields (required), debtor_code (required). Returns: result

wefact_requestA

Call any WeFact controller/action directly.

Use this for endpoints not covered by the dedicated tools below, or to pass parameters that the dedicated tools don't expose.

Args: controller: WeFact controller name (e.g. "debtor", "invoice", "subscription", "creditinvoice", "product", "ticket", "group"). action: Action on that controller (e.g. "list", "show", "add", "edit", "delete", "send", "credit", "markaspaid"). params: Extra parameters as a dict. Field names match the WeFact docs at developer.wefact.com (e.g. "DebtorCode", "Identifier", "InvoiceLines"). Do NOT include the api_key.

Returns: JSON-encoded response from WeFact.

Inputs: action (required), controller (required), params. Returns: result

whoamiA

Sanity-check the API connection. Returns a tiny debtor list response.

Inputs: no named parameters. Returns: result

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3/5.0

    Scored across 18 tools

    Disambiguation4/5

    Most tools map cleanly to distinct resource/action pairs, especially for debtors and invoices. The main confusion is the `credit_invoice` action versus `list_credit_invoices`/`get_credit_invoice` purchase-invoice tools, plus the generic `wefact_request` escape hatch, but descriptions largely clarify intended use.

    Naming Consistency4/5

    The surface is mostly consistent snake_case verb_noun naming (`get_invoice`, `list_debtors`, `create_debtor`, `update_debtor`, `send_invoice`). Exceptions are `wefact_request` and `whoami`, and the `credit_invoice` vs `credit_invoices` naming is potentially confusing.

    Tool Count4/5

    At 18 tools, the set is slightly above the typical 3-15 range but reasonable for a WeFact accounting wrapper covering debtors, invoices, products, subscriptions, and credit invoices. Each tool maps to a recognisable endpoint, though the generic fallback plus many dedicated tools makes the surface somewhat heavier than ideal.

    Completeness4/5

    Core workflows are covered for invoices and debtors, but dedicated CRUD is uneven: debtors lack delete, invoices lack update/delete, and products, subscriptions, and credit invoices are only list/get. The generic `wefact_request` tool explicitly covers missing endpoints, so agents have a workaround rather than a hard dead end.

    Maintenance

    ActivityNo data
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      C
      maintenance
      MCP server for the bol.com Retailer API that enables managing orders, offers, shipments, returns, invoices, and commissions via natural language.
      76
      67 npm
      5
      MIT
    • A
      license
      B
      quality
      B
      maintenance
      Provides a comprehensive MCP interface to the AbraFlexi ERP REST API, enabling management of invoices, contacts, products, bank transactions, and other evidence through natural language.
      68
      3
      MIT
    • A
      license
      B
      quality
      D
      maintenance
      MCP server to interact with the Cuéntica accounting API, allowing users to manage invoices, expenses, income, clients, providers, and bank accounts via natural language.
      59
      2
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      MCP server for e-invoice platforms. Enables natural language querying of invoices, partners, company data, and financial reports.
      18
      10 npm
      6
      MIT