io.github.kts982/mcp-sap-gui

Click a hyperlink in a tree node item. For SPRO/customizing trees, click on the execute icon column (typically item_name='2') to run an activity. Use sap_read_tree to see which columns have link-type items.

Collapse a folder node in a tree control (e.g. SPRO/customizing tree).

Connect to an SAP system by its name in SAP Logon Pad. Credentials are resolved from a .env file (SAP_USER, SAP_PASSWORD, SAP_CLIENT, SAP_LANGUAGE) so passwords never appear in MCP tool calls. Parameters provided here override the .env values (except password). If SAP is already open and logged in, use sap_connect_existing instead.

Connect to an already open SAP session. Use this when SAP is already logged in. This is the most common starting point. connection_index=0 and session_index=0 connect to the first open session. Also attaches to SAP Business Client / embedded SAP GUI sessions. Indexes come from sap_list_connections; a connection with scripting_disabled=true cannot be attached. system: pass it only when the user named the SAP system, as 'DEV' or 'DEV/100' (system/client). One open session on it is attached; several, or none, return an error that lists what is open. The indexes are then ignored. With the 'attach' confirmation point on, the user picks the session in a dialog unless `system` names exactly one open session. The response says how it was chosen (`chosen_by`: named, dialog or index).

Disconnect from the current SAP session and release the binding. Closes only the sessions this MCP session opened: the one sap_connect logged on in and any /o window opened from it. Sessions that were attached (via sap_connect_existing), and /o windows opened from them, are detached but left open so the user can continue working manually.

Double-click a cell in a table/grid (often opens details or drills down). Row is zero-based. Column is the column name (from sap_read_table or sap_get_column_info). Works on both ALV and TableControl.

Double-click a specific item (column cell) in a tree node row. item_name is the column name (e.g., 'Column1', 'Column2'). Use sap_read_tree to discover column names for the tree.

Double-click a node in a tree control (often opens details or drills down). In SPRO/customizing trees, this may open documentation (hypertext) rather than executing the activity. Use sap_click_tree_link on the execute column (typically column '2') for SPRO activities.

Execute (start/run) an SAP transaction code (tcode), e.g. MM03, VA01, SM30. Navigates to the transaction's initial screen. Always check the screen info in the response to understand what screen you landed on. Some transactions require /n prefix for SCWM (e.g., /n/SCWM/MON). A bare /n leaves the current transaction (unsaved data is lost). Subject to transaction blocklist/allowlist. Use sap_get_session_info to see the current transaction before navigating away.

Expand a folder node in a tree control to reveal its children. After expanding, use sap_get_tree_node_children or sap_read_tree to see the newly visible child nodes.

Find a tree node key by its path. E.g., '2\1\2' = 2nd child of root, then 1st child, then 2nd.

Get all toolbar buttons from an ALV grid. Returns button IDs, texts, and types. Use this to discover available actions (sort, filter, export, etc.) before pressing them with sap_press_alv_toolbar_button. Only works on GuiGridView (ALV), not GuiTableControl.

Get detailed cell metadata from an ALV grid. Returns value, changeable, cell_type (Normal, CheckBox, ValueList, Button, ...), state (Normal, Error, Warning, Info: why a cell was rejected), f4_help, hotspot, color, tooltip, max_length; plus checked for a checkbox and list_box_count (entries) for a dropdown cell. Does NOT work on GuiTableControl.

Get detailed column info from an ALV grid or table control. Returns column names, titles and tooltips; for an ALV grid also each column's data_type (string, date, decimal, ...) and key flag, for a table control each column's cell_type and cell_id template. For a lighter alternative, use sap_read_table with columns_only=true.

List all entries in a combobox/dropdown. Returns key-value pairs so you know which values are valid.

Get the currently focused cell position in an ALV grid or table control.

Check if a popup/modal dialog is open (wnd[1], wnd[2], etc.). Returns the popup's title, text content, and available buttons so you know how to respond. Also classifies the popup and suggests a safe next action. Returns {popup_exists: false} if no popup. The popup's text is in `texts`: labels and display-only fields (a message popup's lines). A popup whose body is a classic list (an F4 hit list, a note, a message's long text) has `list` (`cells`, `rows`, `hint`) instead: its lines are never in `texts` or `interactive_elements`; read them with sap_read_list. Radio buttons and checkboxes in interactive_elements carry selected. `texts`, `buttons` and `interactive_elements` are left out when empty.

Discover all elements on the current SAP screen. Useful for finding field IDs when working with a new screen. Use type_filter and changeable_only to reduce response size on complex screens (e.g. type_filter="GuiTextField,GuiCTextField" to find only input fields). max_depth controls how deep to recurse into containers (default 2). Use max_depth=1 for a quick overview, max_depth=3+ for deeply nested layouts (splitter containers, tab strips with sub-containers). Pass container_id='wnd[0]/mbar' to discover the menu bar structure. Radio buttons and checkboxes report selected (true/false); a dropdown reports its selected key. A table control (SM30-style) is ONE element here, not one per cell: use sap_read_table(columns_only=true) for its columns and cell_id templates. A classic list (report WRITE output, SE16 standard list, F4 hit list) is left out and reported under 'lists': read it with sap_read_list. expand_tables=true lists every visible cell of both (large). Docking containers sit BESIDE the user area, not inside it: the dialog-structure tree of a view cluster (SM34, most IMG activities) and the SE80 tree are under 'wnd[0]/shellcont'. When the window has any, the response lists them as docking_containers; discover them with that id, or pass container_id='wnd[0]' (max_depth=1) for all top-level areas.

Get current SAP screen info: transaction, program, screen number, window title, and status bar message (success/error/warning text). Reads from ``session.ActiveWindow`` so the response always reflects what the user sees. The ``active_window`` field tells you which window is in focus (e.g. ``wnd[0]`` for the main screen, ``wnd[1]`` for a popup). The ``title`` comes from the active window. Every action tool (press_button, send_key, select_menu, etc.) returns this same screen info, so you always know when a popup appears. Use sap_get_popup_window for full popup content (texts, buttons). Present only when true: message_has_long_text (sap_press_button on 'wnd[0]/sbar' opens it) and message_as_popup (the message also sits in a popup that must be closed first). Present only when set: subscreens, the sub-screens on the active window as "program:dynnr", outer first (program / screen_number name only the main screen, so an RF step, a tab page or a detail area that changes shows only here), and cursor, the ID of the field the cursor is in. A screen redisplayed without a message, e.g. for an empty required field, still moves the cursor to that field.

Get information about the current SAP session (system, client, user, transaction, screen). Also the SAP GUI release (sap_gui_version) and scripting_read_only: when true, the SAP server allows read-only scripting and write tools refuse.

Get row metadata (selectable, selected) from a GuiTableControl. If rows is omitted, queries all visible rows. Does NOT work on ALV grids.

List all buttons on the system toolbar (tbar[0]) and app toolbar (tbar[1]). Returns button IDs, text, tooltip, and enabled state. This is for standard SAP toolbars, NOT ALV (use sap_get_alv_toolbar for ALV).

Return a generic, read-first guide for a supported SAP transaction. Available transactions: - **/SCWM/MON**: EWM Warehouse Monitor with tree navigation and ALV results. - **SM30**: table/view maintenance and view clusters (SM34) - also what most IMG activities open: reading the table, the docked dialog-structure tree, new entries, saving and the customizing request prompt. Aliases accepted: `SCWM/MON`, `warehouse monitor`, `ewm warehouse monitor`, `SM34`, `table maintenance`, `view maintenance`, `view cluster`.

Get direct children of a tree node. Much faster than read_tree for step-by-step navigation of deep trees (e.g., SPRO). Omit node_key or pass empty string for root-level nodes. Set expand=true to expand the node first (requires write permission).

Return step-by-step guidance for a common SAP workflow. Available workflows: - **search_help**: F4 search help on a field. `target` = field ID. - **table_export**: Paginated table export. `target` = table element ID. - **spro_navigate**: SPRO customizing navigation. `target` = activity name.

Read and optionally act on the current popup/modal dialog. Use when active_window shows wnd[1] or higher. Combines popup inspection and response in a single call. Actions: - read: return popup content without acting (default) - confirm: press OK/Yes/Continue/Enter on the popup - cancel: press Cancel (or F12) on the popup; never No, which on a save prompt drops the changes - press: press a specific button by its text or tooltip - auto: take only a clearly safe action; otherwise return the popup read-only A press that may save (a Save button, or Yes/OK on a popup about saving, e.g. "Save the changes first?") asks the user first, like F11 in sap_send_key. So does any answer but Cancel when the popup's question cannot be read (question_readable: false; SAP GUI's Edge browser control). On such a popup, confirm never falls back to Enter, and auto only reads. An accepted press reports confirmed_by_user: true. Returns the popup contents plus classification, requested action, and post-action screen/popup state when something was pressed.

List all open SAP connections and sessions. Covers SAP Logon plus SAP Business Client / embedded SAP GUI sessions (`host`: saplogon | sapguiserver). A connection with no sessions and `scripting_disabled: true` means the server parameter sapgui/user_scripting is off, so no session can be read. Each session has its system, client, user, transaction, `session_number` (the "(2)" in "DEV(2)") and window `title`.

Modify the value of a cell in an ALV grid or table control. Only works on editable cells. Use sap_get_cell_info to check if a cell is changeable before attempting to modify it.

Press a toolbar button on an ALV grid (e.g., sort, filter, export). Use sap_get_alv_toolbar to find button IDs. A menu button (Menu / ButtonAndMenu) opens its menu and the response lists menu_items (text and function_code); pick one with sap_select_alv_context_menu_item.

Press (click) a pushbutton or toolbar button on the current SAP screen. Returns screen info after the press so you can detect navigation or popups. Use sap_get_toolbar_buttons to discover toolbar button IDs. Use sap_get_screen_elements to find on-screen button IDs. When screen info has message_has_long_text, pressing 'wnd[0]/sbar' opens that long text (Diagnosis / Procedure), usually as a list popup: read it with sap_read_list(window_id='wnd[1]'). A popup button is checked like sap_handle_popup's press: a press that may save, or any answer but Cancel to a popup question the tool cannot read, asks the user first (confirmed_by_user: true when accepted).

Click a column header in an ALV grid (triggers sort). Does NOT work on GuiTableControl.

Render a preview card of the current SAP screen for the user: screenshot, session/transaction info, status bar, and the values the agent is about to write (pending_fields). Call before significant writes (batch fills, F11 save) or whenever the user asks to see what's about to happen. Read-only: nothing is written or saved.

Read the value of a field on the current SAP screen. Returns value, type, changeable status, and labels (left/right). For a dropdown, value is the selected entry's text and key its key. For a radio button or checkbox, value is its label and selected says whether it is selected. Use sap_get_screen_elements to discover field IDs on unknown screens.

Read a classic ABAP list (WRITE output of a report) as lines of text. Use it when a report shows a plain list rather than an ALV grid (program SAPMSSY0, screen 120), and for F4 hit lists in a popup (window_id= 'wnd[1]'). Such a list has no table object: every word is its own label, so sap_get_screen_elements leaves the cells out and reports it under 'lists'. This returns the page as the lines the user sees, with no screenshot needed. - colors: rows whose text has a semantic list colour, e.g. 'negative' (red, errors), 'positive' (green), 'total', 'heading' - scroll: present when the list is longer than the page; pass scroll_to=position+page_size to read the next page - with_ids=true adds the ID of each line's first label, to set the focus on a line (sap_set_focus) before F2 / double-click - is_list=false means this screen has no list: use sap_read_table

Read content from a GuiShell subtype (e.g., HTMLViewer). An HTML viewer's page text and URL are readable only with the Internet Explorer browser control; with the Edge control (SAP GUI 7.70+ default, e.g. the F1 Performance Assistant) the response says so in `note`. Use sap_get_screen_elements first to find shell element IDs.

Read rows from a table on the current screen — ALV grid (report/list output) or TableControl (SM30 maintenance view, customizing screens). Auto-detects the table type. The response includes a 'table_type' field ('GuiGridView' for ALV or 'GuiTableControl') so you know which type-specific tools to use next (e.g., sap_get_alv_toolbar for ALV, sap_scroll_table_control for TableControl). Use columns_only=true for schema discovery (returns column metadata only, no data). For a TableControl it also gives each column's cell_type and a cell_id template ({row} = zero-based visible row) for sap_set_batch_fields. Use columns to fetch only specific columns (CSV). Use start_row to paginate through large tables. On a TableControl a start_row (0 included) scrolls there first; without one the read starts where the table is scrolled now (e.g. after Position...). first_visible_row says which row is on top. A TableControl read returns at most the visible rows: page with start_row=next_start_row while has_more is true. start_row_note explains a clamped or failed scroll. total_rows counts its empty lines too (SM30 pads the view). When the read reaches the first empty row, the response has empty_rows_from, that row's absolute index: the data ends there.

Read the content of a multiline text editor (GuiTextedit) — long texts, notes, comments, document text. Returns full text and line count. Use max_lines to cap output for large text editors (0 = all lines).

Read data from a tree control (TableTreeControl, ColumnTreeControl, etc.). Returns node hierarchy with texts and column values. For large trees (e.g., SPRO with 1000+ nodes), use sap_get_tree_node_children for step-by-step navigation instead. Use sap_search_tree_nodes to find specific nodes by text. total_nodes is the number of nodes read; truncated=true means the tree has more loaded nodes (available_nodes) than max_nodes allowed.

Take a screenshot of the current SAP window. Use as a fallback when structured tools (sap_get_screen_elements, sap_read_field, sap_read_table) return empty or confusing results, e.g., on Web Dynpro screens where the element tree is non-standard. To put a screenshot into a document, pass save_path (must end in .png, directory must exist, existing files are never overwritten). The file keeps SAP GUI's full resolution; the inline image is capped at 1920px. The response then also reports the absolute path and pixel size. Set inline=False to skip the image when only the file is needed.

Scroll a GuiTableControl to a specific row position. Does NOT work on ALV grids (they handle scrolling internally). For reading data at a specific offset, prefer sap_read_table with start_row parameter — it handles scrolling automatically. position in the response is the row SAP actually put at the top, which can differ from the one asked for (then requested_position and a note say so). Cell IDs ([col,row]) count visible rows from that row.

Search for tree nodes by text. Returns matches with full ancestor paths. Useful for finding nodes in deep trees where the same label appears in multiple branches. Case-insensitive substring match. Optionally pass column to search in a specific column instead of node text. **Important limitation**: Only searches nodes that are already loaded (expanded) in the tree. Collapsed subtrees are not searched. If you don't find what you expect, expand parent nodes first using sap_get_tree_node_children with expand=true, then search again. total_matches counts the matches returned. stopped_early=true means the search reached max_results before the last loaded node, so more matches are possible.

Select all rows in an ALV grid. Does NOT work on GuiTableControl.

Select or deselect all columns in a GuiTableControl. Does NOT work on ALV grids.

Select an item from an opened ALV context menu. First use sap_press_alv_toolbar_button on a Menu button to open it, then use this to select an item. Alternatively, pass toolbar_button_id to open the menu and select in one atomic call (recommended). `menu_item_id` can be a technical function code (for example `@M00006`), visible menu text (for example `Confirm WT in Foreground`), or a position descriptor. You can pass human-readable menu text directly. The menu_items of sap_press_alv_toolbar_button list what a menu offers. `select_by` controls how selection is performed: - `auto` (default): heuristic based on whether `menu_item_id` has spaces - `id`: function code - `text`: visible menu text - `position`: position descriptor

Select or deselect a checkbox on the current SAP screen. Set selected=false to uncheck. Use sap_get_screen_elements with type_filter='GuiCheckBox' to find checkbox IDs.

Select an entry in a combobox/dropdown by its key or display value text. Accepts either the technical key or the visible display text. Use sap_get_combobox_entries first to see all valid options. F4 opens nothing on a dropdown; sap_set_field selects entries the same way.

Select a menu item from the menu bar or a submenu. Example: 'wnd[0]/mbar/menu[1]/menu[0]'. Use sap_get_screen_elements on 'wnd[0]/mbar' to discover menu structure. Returns screen info after selection so you can detect navigation.

Select multiple rows at once in an ALV grid or table control. Pass a list of row indices (e.g., [0, 2, 5]).

Select a radio button on the current SAP screen. Use sap_get_screen_elements with type_filter='GuiRadioButton' to find radio button IDs on the current screen.

Select a tab in a tab strip control. Returns screen info after selection (tab content changes). Tab IDs typically look like 'wnd[0]/usr/tabsTABSTRIP/tabpTAB01'.