mcp-sap-gui

MCP.Pizza Chef: mario-andreschak

Seven tools drive the SAP desktop program the way a person would: open a transaction code, click at exact pixel coordinates, move the mouse, type, scroll, close the session, and save the last screenshot. Your assistant only ever sees pictures, so it has to guess coordinates from the image. Windows and a local SAP install are required, plus your real SAP username and password in a plain text file. There is no view-only mode and no built-in confirmation step, and the project has been quiet since February 2025.

Unmaintained · No commits in 19 months.
Data
Other

Use This MCP server To

Open a SAP transaction and see what is on screen Fill in a SAP form field by field from chat Capture screenshots of a SAP process for documentation Walk through a test script in a sandbox SAP system Read back the error message SAP just showed

README

MCP SAP GUI Server

A Model Context Protocol (MCP) server for SAP GUI automation. This server provides tools to automate interactions with SAP GUI, enabling programmatic control of SAP transactions.

image

Requirements

  • Python 3.8 or higher
  • SAP GUI installed and configured
  • Valid SAP credentials (system, client, user, password)
  • Node.js (for npx)

Installation

  1. Clone github folder and run the automated Install using setup script:
setup.bat

This will guide you through the build process and will integrate this directly in Cline or Roo, if you select so.

  1. OR Manual Install using build script..:
build.bat
  1. Configure SAP credentials:
  • Copy .env.example to .env
  • Update the values with your SAP credentials
  1. Test server using mcp inspector:
run.bat debug
  1. Use the integration script to automatically configure MCP settings:
integrate.bat cline  # Configure for Cline
integrate.bat roo    # Configure for Roo

The script will:

  • Automatically determine the correct settings file path
  • Create a backup before making any changes
  • Safely update the MCP configuration
  • Validate changes to prevent corruption

Manual Configuration (if needed):

    "mcp-sap-gui": {
      "command": "python",
      "args": [
        "-m",
        "sap_gui_server.server"
      ],
      "cwd": "PATH_TO_YOUR_FOLDER/mcp-sap-gui",
      "disabled": false,
      "autoApprove": []
    }

mcp-sap-gui FAQ

Is this still being worked on?
The last change landed in February 2025, so treat it as dormant. It is not archived and no replacement is named.
Do I need a key or an account?
Not a key, but your real SAP system, client, username and password go into a plain text file on your computer.
Is my SAP password handled safely?
Be careful. The password is handed to SAP's launcher on the command line, where any other program on the machine can read it in the process list, and if you turn logging up to its most detailed level the whole command including the password is written into the log file.
Can it change real business data?
Yes. It clicks and types inside whatever transaction it opens, so it can create, edit or post real documents. There is no view-only mode and nothing asks you to confirm first. The safety warning in the project's notes is just text you paste to the model, not something the tool enforces.
Will it interfere with a SAP session I already have open?
Yes. Every launch force-closes any running SAP window first, so unsaved work is lost without a prompt.
What do I need before it will run?
A Windows PC, the SAP desktop program already installed and working, Python, and a Node install for the guided setup.
Can I use this to pull a report out of SAP?
Yes, in principle, though it reads the screen from pictures rather than the underlying records, so a different screen size, resolution or colour theme can throw its clicks off.
Which apps does it work in?
The guided setup targets Cline, and there is a small config block you can paste into other MCP-compatible assistants.