mcp-sap-gui

MCP.Pizza Chef: kts982

This server lets your AI assistant interact directly with SAP GUI for Windows, automating tasks like running transactions, reading and writing screen fields, navigating menus, and extracting table data. It works with MCP-compatible apps like Claude Desktop and Cursor, but requires SAP GUI installed on Windows with scripting enabled. Setup involves Python and configuring SAP GUI, so it suits users comfortable with developer tools. No API keys are needed, but you must log in to SAP manually first.

Other

Use This MCP server To

Connect to my open SAP session and retrieve data Execute SAP transactions like MM03 or VA01 Read and write SAP screen fields and controls Extract data from SAP tables and grids Navigate SAP menus and screens via AI commands Take screenshots of SAP windows Discover and list editable fields on SAP screens

README

MCP SAP GUI Server

An MCP (Model Context Protocol) server that enables AI assistants to interact with SAP GUI for Windows through the SAP GUI Scripting API.

It is client-agnostic: if your MCP client can launch a local stdio server, it can use this project. Examples in this README use Claude because the setup is easy to demonstrate, but the same server can be used from Codex, GitHub Copilot, Gemini CLI, and similar MCP-capable tools.

Current release: 0.2.2 for local Windows use over MCP stdio.

CI Docs Release

Status

  • GitHub workflows are included for CI, Docs, and tag-based Release.
  • Forgejo workflows are included for CI and Docs.
  • GitHub is the public mirror: kts982/mcp-sap-gui.

What This Does

This server allows AI assistants to:

  • Connect to SAP systems (like double-clicking in SAP Logon Pad)
  • Execute transactions (MM03, VA01, /SCWM/MON, etc.)
  • Read and write screen fields, checkboxes, radio buttons, comboboxes, and tabs
  • Select menu items from the menu bar (Table View, Edit, Selection, etc.)
  • Navigate through SAP screens using keyboard keys and buttons
  • Extract data from ALV grids (GuiGridView) and classic table controls (GuiTableControl)
  • Interact with ALV toolbar buttons and context menus
  • Read and interact with tree controls (TableTree, ColumnTree, SimpleTree)
  • Take screenshots of SAP windows
  • Discover screen elements for automation

Example Conversation

User: "What's the description for material MAT-001 in system D01?"

Assistant: [connects to D01]
           [executes MM03]
           [enters material number]
           [reads description field]

"The material MAT-001 is described as 'High-Grade Steel Plate 10mm'
in system D01."

Quick Start

  1. Install uv (it ships with uvx), if not already installed:

mcp-sap-gui FAQ

Can I use this to automate SAP GUI tasks like reading material descriptions?
Yes — it lets your AI connect to SAP GUI on Windows, execute transactions, and read screen data.
Does this work with ChatGPT or only Claude?
It works with any MCP-compatible client like Claude Desktop, Cursor, and Cline, not just Claude.
Do I need an SAP account or API key to use this?
You need access to SAP GUI for Windows with scripting enabled, but no separate API key is required.
Is setup difficult for a non-developer?
Setup requires developer skills including Python and Windows SAP GUI configuration.
Can I use this on Mac or Linux?
No — SAP GUI for Windows and this server only run on Windows.
Do I need to install anything special?
You must have SAP GUI for Windows installed and enable scripting, plus Python 3.10+ and the uv package.
Can I automate SAP GUI without logging in manually?
No — you must log in via SAP GUI first; this server attaches to your existing session.