wefact-mcp
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@wefact-mcp list all debtors created this month"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
wefact-mcp
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-mcp2. 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-mcpClaude 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
whoamitool.
Related MCP server: AbraFlexi MCP Server
Tools
Generic escape hatch
Tool | Purpose |
| Call any WeFact endpoint. |
| 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 |
| Walk through migrating a WeFact administration to a Frappe/ERPNext successor. |
| 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
listendpoints 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 towefact_requestand 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 toolscreate_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
Scored across 18 tools
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.
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.
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.
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
Related MCP Connectors
Connect Exact Online to your AI assistant via MCP. Manage Exact Online with natural language.
Invoicing you drive by talking to your AI: log time, raise invoices and track what's owed via MCP.
Fakturownia.pl (Polish invoicing) via MCP: invoices, clients, products, warehouse. Full read-write.
Create, send and track invoices from a conversation in Claude, ChatGPT or any MCP client that supports OAuth. Draft an invoice from one sentence or from last month's invoice for the same client, finalize it, email it to your client and send payment reminders for overdue ones. See revenue by month and by client, download PDFs and e-invoices (ZUGFeRD, XRechnung), and export DATEV packages for your tax advisor. Invoices follow the tax rules of 25 countries, including reverse charge and the small-business VAT exemption. New invoices are drafts, and nothing is emailed until you ask. Pay per invoice with no subscription: the first invoice is free.
Related MCP Servers
- AlicenseAqualityCmaintenanceMCP server for the bol.com Retailer API that enables managing orders, offers, shipments, returns, invoices, and commissions via natural language.7667 npm5MIT
- AlicenseBqualityBmaintenanceProvides a comprehensive MCP interface to the AbraFlexi ERP REST API, enabling management of invoices, contacts, products, bank transactions, and other evidence through natural language.683MIT
- AlicenseBqualityDmaintenanceMCP server to interact with the Cuéntica accounting API, allowing users to manage invoices, expenses, income, clients, providers, and bank accounts via natural language.592MIT

docnova-mcpofficial
AlicenseAqualityDmaintenanceMCP server for e-invoice platforms. Enables natural language querying of invoices, partners, company data, and financial reports.1810 npm6MIT