# mcp-sap-gui

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.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 40
- Author: kts982
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/kts982/mcp-sap-gui
- Updated: 2026-10-24
- HTML: https://affpapa.org/en/nevibecode/mcp/mcp-sap-gui

## What it 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.

## Requirements
- Needs: Python and uv (commands run via uvx)

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add mcp-sap-gui -- uvx mcp-sap-gui
```
uvx runs the command named after the package; if the README names another one, use uvx --from mcp-sap-gui <command>

### Codex

**Platform CLI**
```bash
codex mcp add mcp-sap-gui -- uvx mcp-sap-gui
```
uvx runs the command named after the package; if the README names another one, use uvx --from mcp-sap-gui <command>

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "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>

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "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>

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add mcp-sap-gui uvx mcp-sap-gui
```
uvx runs the command named after the package; if the README names another one, use uvx --from mcp-sap-gui <command>

## When to use it
- 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
- 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.

## Similar
- [Scrapling MCP Server](https://affpapa.org/en/nevibecode/mcp/scrapling-mcp-server.md) — MCP server · ★ 89433
- [browser-use](https://affpapa.org/en/nevibecode/mcp/browser-use.md) — MCP server · ★ 119160
- [AIHawk](https://affpapa.org/en/nevibecode/mcp/aihawk.md) — MCP server · ★ 32221
- [Skyvern](https://affpapa.org/en/nevibecode/mcp/skyvern.md) — MCP server · ★ 23263
- [SeleniumBase MCP](https://affpapa.org/en/nevibecode/mcp/seleniumbase-mcp.md) — MCP server · ★ 13169
- [Inbox Zero](https://affpapa.org/en/nevibecode/mcp/inbox-zero.md) — MCP server · ★ 12791

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md