SAP Business One MCP Server

English · Deutsch

Connect SAP Business One to Claude, ChatGPT and Copilot: business partners, items, sales documents, supplier invoices, payments and journal entries as MCP tools. Powered by AnythingMCP.

SAP Business One MCP Server gives Claude, ChatGPT, Copilot and Cursor 24 tools for SAP Business One: business partners, items, sales documents, supplier invoices, payments and journal entries. 23 tools read and 1 can change data. It runs on AnythingMCP: one click on AnythingMCP Cloud, or self-hosted with Docker. Credentials are stored encrypted and every call is audited.

Last verified: 2026-10-09 against a production SAP Business One company database on SQL Server, through AnythingMCP Cloud (read traffic on business partners, items, A/R and A/P invoices, payments, journal entries and the chart of accounts).
Adapter synced: 2026-10-09

Maintained by helpcode.ai, the team that builds and maintains AnythingMCP.

Quick start (AnythingMCP Cloud)

1. Sign in at cloud.anythingmcp.com and open the install link.
2. Enter SAP_B1_HOST, SAP_B1_PORT, SAP_B1_COMPANY_DB, SAP_B1_USERNAME, SAP_B1_PASSWORD (see Authentication).
3. Copy the URL of your MCP server under MCP Servers and add it to your AI client (below).

AnythingMCP Cloud is the same open-source code, operated by helpcode.ai in Frankfurt, Germany.

Self-hosted (Docker)

Needs Docker 24+, openssl and Node 18+.

git clone https://github.com/HelpCode-ai/sap-business-one-mcp-server.git
cd sap-business-one-mcp-server
./scripts/install.sh

install.sh writes .env with fresh secrets, starts AnythingMCP, creates the first admin, installs the connector if SAP_B1_HOST and SAP_B1_PORT and SAP_B1_COMPANY_DB and SAP_B1_USERNAME and SAP_B1_PASSWORD are set in .env and creates an MCP API key. Without credentials it prints the install link instead: http://localhost:3000/connectors/store?install=sap-business-one. Then check the whole chain:

npm install && node scripts/smoke.mjs

Connect Claude, ChatGPT, Copilot or Cursor

• Claude (claude.ai, Desktop, mobile): Customize → Connectors → Add custom connector, paste your MCP server URL and sign in. Claude connects from Anthropic's cloud, so the URL must be public HTTPS: your AnythingMCP Cloud URL, or your own instance behind TLS.

• Claude Code:

  claude mcp add --transport http sap-business-one-mcp-server http://localhost:4000/mcp --header "X-API-Key: <MCP_API_KEY>"

• Cursor (.cursor/mcp.json) and VS Code / GitHub Copilot (.vscode/mcp.json, key servers instead of mcpServers, plus "type": "http"):

  { "mcpServers": { "sap-business-one-mcp-server": { "url": "http://localhost:4000/mcp", "headers": { "X-API-Key": "<MCP_API_KEY>" } } } }

• ChatGPT: add the public HTTPS URL as a connector (app) in ChatGPT's settings. A localhost URL does not work there.

Tools

24 tools, generated from adapter/sap-business-one.json. read tools cannot change anything in the source system.

Tool	What it does	Access
b1_list_business_partners	List business partners (customers, suppliers, leads) with their code, name, type and balance.	read
b1_get_business_partner	Read one business partner by CardCode: addresses, contacts, payment terms and balance.	read
b1_list_items	List inventory items with their code, name, prices and stock per warehouse (ItemWarehouseInfoCollection).	read
b1_get_item	Read one item by ItemCode: prices, units, groups and stock in each warehouse.	read
b1_list_orders	List sales orders with their customer, dates, totals and status (bost_Open / bost_Close).	read
b1_get_order	Read one sales order by DocEntry (integer key, not DocNum), with all its lines.	read
b1_create_order	Create a new sales order.	write
b1_list_invoices	List A/R invoices (sales invoices to customers).	read
b1_get_invoice	Read one A/R invoice by DocEntry (integer key, not DocNum), with lines and taxes.	read
b1_list_quotations	List sales quotations with their customer, validity date, totals and status.	read
b1_list_delivery_notes	List delivery notes (goods shipped to customers) with their customer, date and lines.	read
b1_list_credit_notes	List A/R credit memos (credit notes issued to customers) with their totals and status.	read
b1_list_purchase_invoices	List A/P invoices (supplier invoices).	read
b1_get_purchase_invoice	Read one A/P invoice in full, with its lines, taxes and withholding tax.	read
b1_list_purchase_credit_notes	List A/P credit memos (credit notes received from suppliers).	read
b1_list_vendor_payments	List outgoing payments to suppliers, with the invoices each one settles (PaymentInvoices).	read
b1_list_incoming_payments	List incoming payments from customers, with the invoices each one settles (PaymentInvoices).	read
b1_list_journal_entries	List journal entries with their lines (JournalEntryLines: account, debit, credit).	read
b1_get_journal_entry	Read one journal entry by JdtNum (TransId) with all its lines: account, debit and credit.	read
b1_list_chart_of_accounts	List G/L accounts of the chart of accounts with their code, name, type and balance.	read
b1_list_bank_statements	List imported bank statements with their account, date and balances.	read
b1_list_external_reconciliations	List external (bank) reconciliations of G/L or business partner accounts in a date or number range.	read
b1_get_external_reconciliation	Read one external (bank) reconciliation: amount, date, type and the journal entry and bank statement lines it matched.	read
b1_get_company_info	Sanity check: returns company metadata (admin info).	read

Example prompts

• Which sales orders from this week are still open, and for which customers?
• Show business partner C20000 with their balance and contact details.
• What is the stock of item A00001 in each warehouse?
• Which A/R invoices are overdue by more than 30 days?
• Which quotations did we send last month that have not turned into orders?
• What did we deliver to customer C20000 this month?

More in examples/prompts.md.

Authentication

Setup:

1. Identify your Service Layer host (on HANA it usually runs on the database server; SQL Server installs and hosting partners run it on a separate host). Default HTTPS port is 50000.
2. Create or pick a B1 user that has API access for the company database you want to expose. A user without write authorizations is a safe start: every tool except b1_create_order only reads.
3. Find the CompanyDB name in Choose Company dialog of the B1 client (looks like SBODEMOGB).
4. Set the five env vars below. The adapter logs in once per session (~25 min TTL) and re-uses the B1SESSION cookie.

OData: this adapter targets the v2 / OData v4 Service Layer endpoint at /b1s/v2/. Older /b1s/v1/ (OData v3) deployments are not covered — upgrade to FP 2405+ first.

Filtering: use standard OData $filter syntax, e.g. CardCode eq 'C20000' or DocDate ge '2026-01-01'.

Paging: the Service Layer returns 20 rows per call unless the client asks for more, whatever $top says. Every list tool asks for pages of up to 100 rows (Prefer: odata.maxpagesize=100); when a response carries @odata.nextLink, call the same tool again with skip raised by the rows already read. Use select to keep wide documents (journal entries with their lines, invoices) small.

Keys and enums: documents are read by DocEntry (internal key), not by DocNum (the number printed on the document). Booleans are tYES / tNO, document status is bost_Open / bost_Close, and OriginalJournal tells what created a journal entry (ttJournalEntry for manual entries, ttAPInvoice, ttARInvoice, ttVendorPayment, ttReceipt…).

Finance: A/P invoices, A/P and A/R credit memos, outgoing and incoming payments, journal entries, the chart of accounts and bank statements each have a list tool. Bank reconciliations are not a list in the Service Layer: b1_list_external_reconciliations calls its reconciliation service (a POST that only reads) and returns account and number pairs for b1_get_external_reconciliation; open items are the documents whose PaidToDate is below DocTotal.

Permissions: a 403 with SAP error -6006 ("Modifying this object is not permitted for current user") means the login works but the B1 user lacks the authorization for that object. Grant it in Administration → System Initialization → Authorizations, or keep the user read-only on purpose.

Self-host caveat: Business One is on-premise. The Service Layer is reachable from inside the customer network. To use the AnythingMCP Cloud, expose Service Layer via a reverse proxy + TLS cert; otherwise self-host the adapter on the same network.

Security

• Read or write is your choice. 23 of the tools only read; b1_create_order can change data. Assign the connector to an MCP server whose role whitelists only the tools you want, and the rest are invisible to that client.
• Credentials are encrypted with AES-256-GCM and never shown to the model.
• Response mapping drops or reshapes fields per tool before they reach the model, e.g. bank details or personal data.
• Audit log: every call is recorded with input, output, duration and status, in your own database when self-hosted.
• SSO, RBAC and SCIM are included in the self-hosted build.

FAQ

Is there an SAP Business One MCP server?

Yes, this one. It connects the SAP Business One Service Layer to Claude, ChatGPT and Copilot through AnythingMCP: 24 tools for business partners, items, sales documents, A/P invoices and credit memos, incoming and outgoing payments, journal entries, the chart of accounts, bank statements and reconciliations, plus creating a sales order.

What do I need to connect it?

The Service Layer host and port (usually 50000), the company database name and a B1 user with API access. The connector logs in and reuses the session cookie.

Can the AI create or change documents in SAP B1?

It can create sales orders with b1_create_order; everything else only reads. Leave that tool off the MCP server's role if the AI should only read.

Does it work with SAP B1 on HANA and on SQL Server?

Yes, as long as the Service Layer runs: it ships with SAP Business One on HANA and, in current 10.0 releases, on SQL Server too. Installations without a Service Layer can be connected through their SQL database instead, read-only.

Has this been tested against a live SAP B1 system?

Yes. In October 2026 it read a production company database on SQL Server through AnythingMCP Cloud: business partners, items, A/R and A/P invoices, payments, journal entries and the chart of accounts. The reconciliation tools follow SAP's Service Layer reference.

Troubleshooting

Problem	Fix
401 / 403 from the vendor	The credentials are wrong or lack rights. Re-enter them on the connector page; the import runs a test call and shows the result.
Tools missing in the AI client	The connector is not assigned to the MCP server the client uses. Check MCP Servers, then run node scripts/smoke.mjs.
The host is on your internal network	Self-host AnythingMCP on that network and add the hostname to SSRF_ALLOWED_HOSTS, or the outbound guard blocks the call.
Works locally, fails on AnythingMCP Cloud	The system must be reachable from the internet with a valid TLS certificate.

Related

• sap-mcp-server: SAP MCP server: connect SAP Business One, S/4HANA (Cloud, on-premise via OData or HANA SQL) and Concur to Claude & ChatGPT.
• odoo-mcp-server: Odoo MCP server: connect Odoo ERP to Claude & ChatGPT. Search, read, create and update any model: partners, orders, invoices.
• weclapp-mcp-server: weclapp MCP server: connect weclapp Cloud ERP to Claude & ChatGPT. Customers, orders, invoices, quotes and opportunities.
• AnythingMCP: the open-source MCP server and gateway this repository is built on.

License

AGPL-3.0-only. The adapter definition in adapter/ comes from AnythingMCP (AGPL-3.0).