Skip to main content
Glama
HelpCode-ai

SAP Business One MCP Server

by HelpCode-ai

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)

  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.

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.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

12 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).

read

b1_get_business_partner

Get one business partner by CardCode.

read

b1_list_items

List inventory items (articles).

read

b1_get_item

Get one item by ItemCode.

read

b1_list_orders

List sales orders.

read

b1_get_order

Get one sales order by DocEntry (integer primary key).

read

b1_create_order

Create a new sales order.

write

b1_list_invoices

List A/R invoices.

read

b1_get_invoice

Get one A/R invoice by DocEntry.

read

b1_list_quotations

List sales quotations.

read

b1_list_delivery_notes

List delivery notes (outgoing goods movements).

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 (typically the same machine that runs HANA + SAP B1). Default HTTPS port is 50000.

  2. Create or pick a B1 user that has API access for the company database you want to expose.

  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'.

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_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: 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

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.

  • 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).

Related MCP Connectors

Related MCP Servers

  • A
    license
    Not graded
    quality
    D
    maintenance
    Transforms 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 npm
    132
    MIT
  • A
    license
    C
    quality
    D
    maintenance
    Transforms 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.
    19
    22 npm
    6
    MIT
  • A
    license
    Not graded
    quality
    D
    maintenance
    Transforms 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 npm
    1
    MIT
  • F
    license
    Not graded
    quality
    D
    maintenance
    Enables 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
    -