Provides tools for reading and creating data in SAP Business One: business partners, items, sales orders, A/R invoices, quotations, and delivery notes.
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., "@SAP Business One MCP Server List open sales orders from this week."
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.
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.
Sign in at cloud.anythingmcp.com and open the install link.
Enter SAP_B1_HOST, SAP_B1_PORT, SAP_B1_COMPANY_DB, SAP_B1_USERNAME, SAP_B1_PASSWORD (see Authentication).
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.
Related MCP server: SAP OData to MCP Server
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.shinstall.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.mjsClaude (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.
24 tools, generated from adapter/sap-business-one.json. read tools cannot change anything in the source system.
Tool | What it does | Access |
| List business partners (customers, suppliers, leads) with their code, name, type and balance. | read |
| Read one business partner by CardCode: addresses, contacts, payment terms and balance. | read |
| List inventory items with their code, name, prices and stock per warehouse (ItemWarehouseInfoCollection). | read |
| Read one item by ItemCode: prices, units, groups and stock in each warehouse. | read |
| List sales orders with their customer, dates, totals and status (bost_Open / bost_Close). | read |
| Read one sales order by DocEntry (integer key, not DocNum), with all its lines. | read |
| Create a new sales order. | write |
| List A/R invoices (sales invoices to customers). | read |
| Read one A/R invoice by DocEntry (integer key, not DocNum), with lines and taxes. | read |
| List sales quotations with their customer, validity date, totals and status. | read |
| List delivery notes (goods shipped to customers) with their customer, date and lines. | read |
| List A/R credit memos (credit notes issued to customers) with their totals and status. | read |
| List A/P invoices (supplier invoices). | read |
| Read one A/P invoice in full, with its lines, taxes and withholding tax. | read |
| List A/P credit memos (credit notes received from suppliers). | read |
| List outgoing payments to suppliers, with the invoices each one settles (PaymentInvoices). | read |
| List incoming payments from customers, with the invoices each one settles (PaymentInvoices). | read |
| List journal entries with their lines (JournalEntryLines: account, debit, credit). | read |
| Read one journal entry by JdtNum (TransId) with all its lines: account, debit and credit. | read |
| List G/L accounts of the chart of accounts with their code, name, type and balance. | read |
| List imported bank statements with their account, date and balances. | read |
| List external (bank) reconciliations of G/L or business partner accounts in a date or number range. | read |
| Read one external (bank) reconciliation: amount, date, type and the journal entry and bank statement lines it matched. | read |
| Sanity check: returns company metadata (admin info). | read |
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.
Setup:
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.
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.
Find the CompanyDB name in Choose Company dialog of the B1 client (looks like SBODEMOGB).
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.
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.
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.
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.
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.
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.
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.
Problem | Fix |
| 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 |
The host is on your internal network | Self-host AnythingMCP on that network and add the hostname to |
Works locally, fails on AnythingMCP Cloud | The system must be reachable from the internet with a valid TLS certificate. |
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.
AGPL-3.0-only. The adapter definition in adapter/ comes from AnythingMCP (AGPL-3.0).
Any REST/SOAP/GraphQL/OData/SQL API as MCP tools for Claude & ChatGPT. 474 connectors: SAP, ERP.
MCP server unifying ERPs, CRMs, APIs and knowledge base for Claude, ChatGPT and Gemini.
Let AI agents query data and act across all your business apps via MCP.
Connect your business apps to your MCP compatible AI in 1 click
