Desktop & apps
List desktop windows
exza_desktop_windows #
Inspect visible application windows on the approved desktop. Window titles may be private, so the operation requires elevated authorization.
- Permission
computer:write- Platforms
- macOS, Windows, Linux (where supported)
View parameters
No input parameters required.
Original technical API description
List names of visible GUI windows or application processes on the connected computer. Requires computer:write OAuth.
Security reminder: Review permission and possible effects before use. Changes require appropriate owner approval.
Desktop & apps
Focus an application window
exza_desktop_focus #
Bring an explicitly identified app window to the front. Changes keyboard focus and requires owner authorization.
- Permission
computer:write- Platforms
- macOS, Windows, Linux (where supported)
View parameters
Original technical API description
Bring one explicitly named installed application window to the foreground. Requires computer:write OAuth and ChatGPT tool permission.
Security reminder: Review permission and possible effects before use. Changes require appropriate owner approval.
Desktop & apps
Type into desktop app
exza_desktop_type #
Enter supplied text into the currently focused application. This may change documents or submit forms, so review both target and text before approval.
- Permission
computer:write- Platforms
- macOS, Windows, Linux (where supported)
View parameters
Original technical API description
HIGH RISK: Type supplied text into the current focused application on the connected desktop. May submit or change data. Requires computer:write OAuth and host permission.
Security reminder: Review permission and possible effects before use. Changes require appropriate owner approval.
Desktop & apps
Send keyboard shortcut
exza_desktop_shortcut #
Send one named keyboard shortcut to the foreground app. A shortcut may save, switch focus or trigger consequential actions.
- Permission
computer:write- Platforms
- macOS, Windows, Linux (where supported)
View parameters
Original technical API description
HIGH RISK: Send one keyboard shortcut to current application. May trigger irreversible UI actions. Requires computer:write OAuth and host permission.
Security reminder: Review permission and possible effects before use. Changes require appropriate owner approval.
Desktop & apps
Read clipboard text
exza_clipboard_read #
Read a bounded amount of clipboard text. Clipboard contents can hold sensitive data, so extra authorization is required.
- Permission
computer:write- Platforms
- macOS, Windows, Linux (where supported)
View parameters
No input parameters required.
Original technical API description
SENSITIVE: Read up to 12 KB of the computer clipboard. It may contain personal text or secrets. computer:write OAuth and host-controlled native permission required.
Security reminder: Review permission and possible effects before use. Changes require appropriate owner approval.
Desktop & apps
Write clipboard text
exza_clipboard_write #
Place a chosen text into the system clipboard, replacing its previous contents. Review the text and approve the replacement.
- Permission
computer:write- Platforms
- macOS, Windows, Linux (where supported)
View parameters
Original technical API description
CHANGE: Put up to 12 KB text in the computer clipboard; replaces its previous text. computer:write OAuth and host-controlled native permission required.
Security reminder: Review permission and possible effects before use. Changes require appropriate owner approval.
Desktop & apps
List installed Mac apps
exza_desktop_apps #
List detected macOS applications. This legacy tool is not a guaranteed all-platform software inventory.
- Permission
computer:read- Platforms
- macOS (platform-specific)
View parameters
No input parameters required.
Original technical API description
List installed macOS applications.
Security reminder: Read access can still reveal private information from authorized areas.
Desktop & apps
Launch an approved desktop app
exza_desktop_launch #
Open a selected, approved desktop application. Availability depends on local platform support and permission; it changes the user's desktop state.
- Permission
computer:write- Platforms
- macOS, Windows, Linux (where supported)
View parameters
Original technical API description
Launch approved desktop application.
Security reminder: Review permission and possible effects before use. Changes require appropriate owner approval.
Desktop & appsNew on MCP server
Focus a window by process ID
exza_desktop_focus_window #
Focus a visible macOS or Windows application by its exact process ID and verify foreground activation. Operating-system permissions still apply.
- Permission
computer:write- Platforms
- macOS, Windows, Linux (where supported)
View parameters
Original technical API description
DESKTOP ACTION: Focus a visible macOS or Windows app window using the PID from exza_desktop_windows. macOS requires Accessibility; Windows may deny focus under secure desktop or process integrity restrictions. Requires owner approval.
Security reminder: Review permission and possible effects before use. Changes require appropriate owner approval.
Desktop & appsNew on MCP server
Inspect monitors and screen coordinates
exza_desktop_display_info #
Read virtual desktop boundaries and monitor count on macOS and Windows, including negative coordinates in multi-monitor setups. No display settings are changed.
- Permission
computer:read- Platforms
- macOS, Windows, Linux (where supported)
View parameters
No input parameters required.
Original technical API description
Read macOS or Windows virtual desktop bounds and monitor count. Coordinates may be negative on multi-monitor setups.
Security reminder: Read access can still reveal private information from authorized areas.
Desktop & appsNew on MCP server
Move the desktop mouse pointer
exza_desktop_mouse_move #
Move the cursor to validated screen coordinates on macOS or Windows after explicit device-owner authorization. No click is performed by this tool.
- Permission
computer:write- Platforms
- macOS, Windows, Linux (where supported)
View parameters
Original technical API description
MAC/WINDOWS ACTION: Move the owner desktop cursor to physical screen coordinates. Requires operating-system Accessibility/Input permission and explicit owner approval.
Security reminder: Review permission and possible effects before use. Changes require appropriate owner approval.
Desktop & appsNew on MCP server
Click or double-click on desktop
exza_desktop_mouse_click #
Perform approved left clicks, right clicks or double clicks at the pointer or validated coordinates. Clicks can change application state and require owner approval.
- Permission
computer:write- Platforms
- macOS, Windows, Linux (where supported)
View parameters
Original technical API description
HIGH RISK: Click or double-click at the current pointer or optional x/y coordinates on macOS or Windows. May submit or modify data; requires explicit owner approval.
Security reminder: Review permission and possible effects before use. Changes require appropriate owner approval.
Desktop & appsNew on MCP server
Scroll the desktop wheel
exza_desktop_mouse_scroll #
Scroll vertically or horizontally with bounded wheel steps on an authorized macOS or Windows desktop. Results depend on the active window and local permissions.
- Permission
computer:write- Platforms
- macOS, Windows, Linux (where supported)
View parameters
Original technical API description
MAC/WINDOWS ACTION: Scroll vertically or horizontally on the owner desktop using signed wheel steps, maximum 15 per call.
Security reminder: Review permission and possible effects before use. Changes require appropriate owner approval.
Desktop & appsNew on MCP server
Drag an item using the mouse
exza_desktop_mouse_drag #
Drag between validated screen positions using the left mouse button. This can move files or controls, so explicit approval is required before execution.
- Permission
computer:write- Platforms
- macOS, Windows, Linux (where supported)
View parameters
Original technical API description
HIGH RISK: Drag across two macOS or Windows screen positions with the left mouse button. Can move UI items/files; explicit host approval mandatory.
Security reminder: Review permission and possible effects before use. Changes require appropriate owner approval.
Desktop & appsNew on MCP server
Read current mouse position
exza_desktop_mouse_position #
Read the cursor coordinates without moving the mouse on macOS or Windows.
- Permission
computer:read- Platforms
- macOS, Windows, Linux (where supported)
View parameters
No input parameters required.
Original technical API description
Read physical cursor coordinates on the connected macOS or Windows desktop. No mouse movement.
Security reminder: Read access can still reveal private information from authorized areas.
Desktop & appsNew on MCP server
Inspect active window
exza_desktop_active_window #
Read the title, PID, position and dimensions of the current foreground window. Titles may contain private data.
- Permission
computer:read- Platforms
- macOS, Windows, Linux (where supported)
View parameters
No input parameters required.
Original technical API description
Read PID, title, dimensions and state of the foreground macOS or Windows window. Window titles may contain private information.
Security reminder: Read access can still reveal private information from authorized areas.
Desktop & appsNew on MCP server
Inspect window geometry
exza_desktop_window_geometry #
Inspect the size, position and min/max state of a visible application by PID without changing it.
- Permission
computer:read- Platforms
- macOS, Windows, Linux (where supported)
View parameters
Original technical API description
Read the title, size, position and min/max state of an explicitly selected macOS or Windows application PID.
Security reminder: Read access can still reveal private information from authorized areas.
Desktop & appsNew on MCP server
Manage window state
exza_desktop_window_action #
Minimize, maximize or restore a specified window by PID. System permissions and host approval still apply.
- Permission
computer:write- Platforms
- macOS, Windows, Linux (where supported)
View parameters
Original technical API description
CHANGE: Minimize, maximize or restore one listed macOS or Windows app window by PID. Requires owner authorization; protected or elevated windows may refuse.
Security reminder: Review permission and possible effects before use. Changes require appropriate owner approval.
Desktop & appsNew on MCP server
Wait for an app window
exza_desktop_window_wait #
Wait up to eight seconds for a matching window title or application name without modifying the desktop.
- Permission
computer:read- Platforms
- macOS, Windows, Linux (where supported)
View parameters
Original technical API description
Wait up to 8 seconds for a matching macOS or Windows visible window title or application process; never opens or modifies the app.
Security reminder: Read access can still reveal private information from authorized areas.
Desktop & appsNew on MCP server
Choose browser for a URL
exza_desktop_browser_choose #
Open an HTTP/HTTPS URL in the selected installed browser, such as Chrome, Edge, Firefox or Safari where available.
- Permission
computer:write- Platforms
- macOS, Windows, Linux (where supported)
View parameters
Original technical API description
ACTION: Open an owner-provided HTTP/HTTPS page in an installed browser (default, Chrome, Edge, Firefox, Safari where supported). Does not visit file or privileged URL schemes.
Security reminder: Review permission and possible effects before use. Changes require appropriate owner approval.
Desktop & appsNew on MCP server
Run a keyboard shortcut sequence
exza_desktop_keyboard_sequence #
Send up to eight ordered keyboard shortcuts to the focused macOS or Windows app with explicit authorization.
- Permission
computer:write- Platforms
- macOS, Windows, Linux (where supported)
View parameters
Original technical API description
HIGH RISK: Send 1-8 ordered keyboard shortcuts to the currently focused macOS or Windows app. Each may change UI, submit, or close data; requires explicit owner approval.
Security reminder: Review permission and possible effects before use. Changes require appropriate owner approval.
Desktop & appsNew on MCP server
Capture an approved screenshot
exza_screenshot #
Capture a PNG into the local EXZA workspace only with full computer approval and OS screen permission. Screen content may contain private information.
- Permission
computer:write- Platforms
- macOS, Windows, Linux (where supported)
View parameters
Original technical API description
SENSITIVE: Capture the owner desktop once into a NEW PNG file inside the EXZA workspace. Requires physical full-computer scope, computer:write OAuth and native ChatGPT permission; macOS screen recording, Windows interactive desktop or Linux screenshot utility and OS authorization are also required. Screen content may contain secrets; never share without approval.
Security reminder: Review permission and possible effects before use. Changes require appropriate owner approval.