list

Retrieve system information on macOS, including running applications, specific app windows, or server status. Identify apps like 'Photoshop' or capture details of 'Notes' windows for automation tasks.

Instructions

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 Peekaboo 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. Peekaboo MCP 1.1.0 using openai/gpt-4-vision, anthropic/claude-3-opus, google/gemini-pro-vision

Input Schema

Name	Required	Description
`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.
`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 Peekaboo MCP server.

Input Schema (JSON Schema)

{
  "description": "Lists various system items, providing situational awareness. The `item_type` is optional and will be inferred if omitted (defaults to 'application_windows' if 'app' is provided, else 'running_applications'). App identifier uses fuzzy matching for convenience.",
  "properties": {
    "app": {
      "description": "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.",
      "type": "string"
    },
    "include_window_details": {
      "description": "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\"]`.\n- `ids`: Include window ID.\n- `bounds`: Include window position and size (x, y, width, height).\n- `off_screen`: Indicate if the window is currently off-screen.",
      "items": {
        "enum": [
          "off_screen",
          "bounds",
          "ids"
        ],
        "type": "string"
      },
      "type": "array"
    },
    "item_type": {
      "description": "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:\n- `running_applications`: Lists all currently running applications.\n- `application_windows`: Lists open windows for a specific application. Requires the `app` parameter.\n- `server_status`: Returns information about the Peekaboo MCP server.",
      "enum": [
        "running_applications",
        "application_windows",
        "server_status"
      ],
      "type": "string"
    }
  },
  "required": [
    "item_type",
    "include_window_details"
  ],
  "type": "object"
}

Peekaboo MCP

list

Instructions

Input Schema

Input Schema (JSON Schema)

Other Tools from Peekaboo MCP

Related Tools

MCP directory API