list

list

List running applications, open windows, or server status on macOS to enable automation and situational awareness for AI agents.

Lists various system items on macOS, providing situational awareness.

Capabilities:

Running Applications: Get a list of all currently running applications (names and bundle IDs).
Application Windows: For a specific application (identified by name or bundle ID), list its open windows.
- Details: Optionally include window IDs, bounds (position and size), and whether a window is off-screen.
- Multi-window apps: Clearly lists each window of the target app.
Server Status: Provides information about the PeepIt MCP server itself (version, configured AI providers).

Use Cases:

Agent needs to know if 'Photoshop' is running before attempting to automate it. { "item_type": "running_applications" } // Agent checks if 'Photoshop' is in the list.
Agent wants to find a specific 'Notes' window to capture. { "item_type": "application_windows", "app": "Notes", "include_window_details": ["ids", "bounds"] } The agent can then use the window title or ID with the 'image' tool. PeepIt MCP 1.0.0-beta.1 using openai/gpt-4o, ollama/llava:latest

TableJSON Schema

Name	Required	Description
`item_type`	Yes	Specifies the type of items to list. If omitted or empty, it defaults to 'application_windows' if 'app' is provided, otherwise 'running_applications'. Valid options are: - `running_applications`: Lists all currently running applications. - `application_windows`: Lists open windows for a specific application. Requires the `app` parameter. - `server_status`: Returns information about the PeepIt MCP server.
`app`	No	Required when `item_type` is `application_windows`. Specifies the target application by its name (e.g., "Safari", "TextEdit"), bundle ID, or process ID (e.g., "PID:663"). Fuzzy matching is used for names, so partial names may work.
`include_window_details`	Yes	Optional, only applicable when `item_type` is `application_windows`. Specifies additional details to include for each window. Provide an array of strings. Example: `["bounds", "ids"]`. - `ids`: Include window ID. - `bounds`: Include window position and size (x, y, width, height). - `off_screen`: Indicate if the window is currently off-screen.

PeepIt MCP