Waindow

AI & automation

Let your existing tools ask Waindow for a Mac action.

Waindow does not contain an AI model. It provides the same small, typed set of local actions to a person through the app and to external tools through Shortcuts, compatible MCP clients, or CLI.

Three paths

Use the connection that fits the job.

Apple Shortcuts

Best for visible, reusable personal automations. Waindow actions are available directly without turning on the MCP/CLI local connection.

MCP

Best for Claude Code, Codex, Cursor, or another compatible tool that can call typed tools. Turn on AI & Automation only while you want the local connection available.

CLI

Best for scripts and explicit terminal workflows. It uses the signed Waindow executable and the same action and permission rules as the app.

Connect MCP

Copy the configuration Waindow generates for this Mac.

The app writes the exact executable path for you. The example below assumes Waindow is installed in Applications; use the copy button in Waindow if you keep it somewhere else.

1

Enable local control

Open Settings → AI & Automation and turn on local control.

2

Copy MCP config

Paste the generated configuration into your compatible MCP client.

3

Keep Waindow running

Turn local control off whenever you want the socket removed.

{
  "mcpServers": {
    "waindow": {
      "command": "/Applications/Waindow.app/Contents/MacOS/Waindow",
      "args": ["mcp", "serve"]
    }
  }
}
waindow_list_actionswaindow_list_targetswaindow_statuswaindow_run_actionwaindow_undowaindow_cancel

The server uses stdio and a user-only local socket. It opens no network port, and turning local control off removes the socket.

Action boundary

What an external tool can and cannot do.

Available typed actions

  • arrange, move, focus, save, and restore windows;
  • create a window memo without reading existing memo text;
  • start or stop standard Keep Awake modes;
  • start Blackout Mode;
  • request long-page capture with confirmation;
  • start or stop Presentation Tools with the same confirmation rules;
  • open Studio, stop an active recording, or open Shelf and Mac Status;
  • cancel supported work and undo reversible actions.

Not exposed

  • window titles, document contents, prompts, or screen images;
  • existing memo contents;
  • process or app activity monitoring;
  • voice recording or speech recognition;
  • payments, accounts, remote network control, or cloud storage;
  • closed-lid Keep Awake, which remains a human-facing control.

Examples

Ask for an outcome in plain language.

“Arrange every open window on this display.”
“Create a Safari memo titled Review with these checks.”
“Keep my Mac awake for 90 minutes and let the display turn off.”
“Capture the full current page.”

The AI client decides how to translate a request into an available tool call. Waindow validates the typed request locally and applies its own permission, confirmation, cancellation, and undo rules.

Human-first

Every core feature remains usable without AI.

Get WaindowRead product facts