# list_windows

Source: https://libtmux.org/en/cxx/latest/mcp/tools/list_windows/

> List windows through an exact owning session. Inspect tmux metadata; accepts no client-supplied executable input.

MCP is in development

Server behavior and tool contracts may change. Tool availability depends on the server configuration.

List windows through an exact owning session. Inspect tmux metadata; accepts no client-supplied executable input.

[All C++ tools](https://libtmux.org/en/cxx/latest/mcp/tools/) · [JSON](https://libtmux.org/en/cxx/latest/mcp/tools/list_windows.json) · [Source](https://github.com/libtmux/libtmux-cxx/blob/96f367a6fe247e4e5ebddd4a52ca5d5f9d07c0ec/apps/mcp/src/tool_catalog.cpp#L1708)

## Arguments

* `session` required · string

  Stable session ID or name.

## Schemas

The schema defines required fields, nested values, defaults, and validation constraints.

Input schema

```json
{
  "additionalProperties": false,
  "properties": {
    "session": {
      "description": "Stable session ID or name.",
      "maxLength": 512,
      "type": "string"
    }
  },
  "required": [
    "session"
  ],
  "type": "object"
}
```

Output schema

```json
{
  "additionalProperties": false,
  "properties": {
    "windows": {
      "items": {
        "additionalProperties": false,
        "properties": {
          "active": {
            "type": "boolean"
          },
          "height": {
            "minimum": 0,
            "type": "integer"
          },
          "id": {
            "pattern": "^@[0-9]+$",
            "type": "string"
          },
          "index": {
            "type": "integer"
          },
          "layout": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "pane_count": {
            "minimum": 0,
            "type": "integer"
          },
          "session_id": {
            "pattern": "^\\$[0-9]+$",
            "type": "string"
          },
          "width": {
            "minimum": 0,
            "type": "integer"
          }
        },
        "required": [
          "active",
          "height",
          "id",
          "index",
          "layout",
          "name",
          "pane_count",
          "session_id",
          "width"
        ],
        "type": "object"
      },
      "type": "array"
    }
  },
  "required": [
    "windows"
  ],
  "type": "object"
}
```

Tool annotations

```json
{
  "destructiveHint": true,
  "idempotentHint": false,
  "openWorldHint": true,
  "readOnlyHint": false,
  "title": "List tmux windows"
}
```