mcp-sap-gui — Claude Code MCP server: features and setup
Connect an AI agent to SAP GUI for Windows to run transactions, inspect screens, and write fields behind an approval gate. Useful for handling SAP tasks from an agent chat.
claude mcp add mcp-sap-gui -- uvx mcp-sap-guiWhat mcp-sap-gui does
This local MCP server connects an agent to SAP GUI through the SAP GUI Scripting API. It can launch transactions, read screen fields and tables, navigate menus, use F4 value help, and capture screenshots. The agent can also show the values it plans to enter before a write.
You can configure approval checkpoints for write operations; the server pauses until you approve. Log in through SAP GUI first, then attach to the open session: sap_connect does not take a password. The server communicates over local stdio.
You need Windows, SAP GUI for Windows, SAP GUI Scripting enabled, Python 3.10+, and uv. Windows is required because SAP GUI runs only on that platform.
What it helps with
- run an SAP transaction and retrieve a field
- read rows from an ALV grid or table control
- find editable fields on the current screen
- review values before writing them to SAP
- capture an SAP GUI window
Example prompts for the agent
- Connect to my open SAP session and identify the system.
- Find the fields I can edit on the current screen.
- Show me the values you plan to enter before writing them to SAP.
How to install mcp-sap-gui
Platform CLI
claude mcp add mcp-sap-gui -- uvx mcp-sap-guiuvx runs the command named after the package; if the README names another one, use uvx --from mcp-sap-gui <command>
Platform CLI
codex mcp add mcp-sap-gui -- uvx mcp-sap-guiuvx runs the command named after the package; if the README names another one, use uvx --from mcp-sap-gui <command>
Config file
{
"mcpServers": {
"mcp-sap-gui": {
"command": "uvx",
"args": [
"mcp-sap-gui"
]
}
}
}uvx runs the command named after the package; if the README names another one, use uvx --from mcp-sap-gui <command>
Config file
{
"servers": {
"mcp-sap-gui": {
"type": "stdio",
"command": "uvx",
"args": [
"mcp-sap-gui"
]
}
}
}uvx runs the command named after the package; if the README names another one, use uvx --from mcp-sap-gui <command>
Platform CLI
gemini mcp add mcp-sap-gui uvx mcp-sap-guiuvx runs the command named after the package; if the README names another one, use uvx --from mcp-sap-gui <command>
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about mcp-sap-gui
How do I install mcp-sap-gui in Claude Code?
Add the server with claude mcp add mcp-sap-gui -- uvx mcp-sap-gui. Install uv and start SAP Logon Pad or open an SAP GUI session first.
What does mcp-sap-gui do?
It gives an AI agent access to SAP GUI screens and transactions, including tools for reading data and writing fields. You can require approval before writes go through.
What do I need to run mcp-sap-gui?
Use Windows with SAP GUI for Windows and SAP GUI Scripting enabled, plus Python 3.10+ and uv. Sign in through the SAP GUI, then connect the server to that session.
