SAP Business One MCP Server
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 ServerList 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.
SAP Business One MCP Server
English · Deutsch
Connect SAP Business One to Claude, ChatGPT and Copilot: business partners, items, sales orders, invoices, quotations and deliveries as MCP tools. Powered by AnythingMCP.
SAP Business One MCP Server gives Claude, ChatGPT, Copilot and Cursor 12 tools for SAP Business One: business partners, items, sales orders, invoices, quotations and deliveries. 11 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.
Status: not yet verified against a live system. The adapter follows the vendor's API documentation; please report what you find.
Adapter synced: 2026-09-26
Maintained by helpcode.ai, the team that builds and maintains AnythingMCP.
Quick start (AnythingMCP Cloud)
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
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.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.mjsConnect 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, keyserversinstead ofmcpServers, 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
localhostURL does not work there.
Tools
12 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). | read |
| Get one business partner by CardCode. | read |
| List inventory items (articles). | read |
| Get one item by ItemCode. | read |
| List sales orders. | read |
| Get one sales order by DocEntry (integer primary key). | read |
| Create a new sales order. | write |
| List A/R invoices. | read |
| Get one A/R invoice by DocEntry. | read |
| List sales quotations. | read |
| List delivery notes (outgoing goods movements). | read |
| 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:
Identify your Service Layer host (typically the same machine that runs HANA + SAP B1). Default HTTPS port is
50000.Create or pick a B1 user that has API access for the company database you want to expose.
Find the
CompanyDBname in Choose Company dialog of the B1 client (looks likeSBODEMOGB).Set the five env vars below. The adapter logs in once per session (~25 min TTL) and re-uses the
B1SESSIONcookie.
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'.
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. 11 of the tools only read;
b1_create_ordercan 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: 12 tools for business partners, items, sales orders, A/R invoices, quotations and delivery notes, 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?
It talks to the Service Layer, which ships with SAP Business One on HANA. 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?
Not yet. The adapter follows SAP's Service Layer documentation; please report what you find.
Troubleshooting
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. |
Related
sap-mcp-server: SAP MCP server: connect SAP Business One, S/4HANA Cloud and Concur to Claude & ChatGPT. Orders, partners, invoices as AI tools.
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).
This server cannot be deployed
Maintenance
Related MCP Connectors
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
- ZapierOAuthcom.zapier.mcp
Zapier MCP connects AI tools like Claude, ChatGPT, and Cursor to over 8,000 apps and 30,000+ actions, enabling AI to perform real-world tasks such as sending messages, searching data, scheduling events, and updating records. It acts as a translator between AI tools and apps, handling authentication, rate limits, and retries automatically, transforming AI from a conversational tool into a functional extension of your business stack.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceTransforms SAP S/4HANA or ECC systems into conversational AI interfaces by exposing all OData services as dynamic MCP tools. Enables natural language interactions with ERP data for querying, creating, updating, and deleting business entities through SAP BTP integration.22 npm132MIT
- AlicenseCqualityDmaintenanceTransforms SAP S/4HANA or ECC systems into conversational AI interfaces by exposing all OData services as dynamic MCP tools. Enables natural language interactions with ERP data including querying, creating, updating, and deleting entities through SAP BTP integration.1922 npm6MIT
- AlicenseNot gradedqualityDmaintenanceTransforms SAP S/4HANA or ECC systems into conversational AI interfaces by exposing OData services as dynamic MCP tools. Enables natural language interactions with ERP data for querying, creating, updating, and deleting business entities.22 npm1MIT
- FlicenseNot gradedqualityDmaintenanceEnables interaction with SAP Business One via Service Layer REST API to retrieve and create business data such as partners, orders, invoices, items, and stock levels through natural language.1-