# list_windows

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

> Inspect tmux metadata; accepts no client-supplied executable input. Lists windows, optionally only those in one named session.

MCP is in development

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

Inspect tmux metadata; accepts no client-supplied executable input. Lists windows, optionally only those in one named session.

[All Go tools](https://libtmux.org/en/go/latest/mcp/tools/) · [JSON](https://libtmux.org/en/go/latest/mcp/tools/list_windows.json) · [Source](https://github.com/libtmux/libtmux-go/blob/aaf86678fe0cbdf56f9e1c9c46b0db0704e15656/mcp/manifest_catalog.go#L135)

## Arguments

* `session` optional · string

  only windows in this session name

## Schemas

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

Input schema

```json
{
  "additionalProperties": false,
  "properties": {
    "session": {
      "description": "only windows in this session name",
      "type": "string"
    }
  },
  "type": "object"
}
```

Output schema

```json
{
  "additionalProperties": false,
  "properties": {
    "serverNote": {
      "type": "string"
    },
    "skipped": {
      "type": "integer"
    },
    "total": {
      "type": "integer"
    },
    "windows": {
      "items": {
        "additionalProperties": false,
        "properties": {
          "active": {
            "type": "boolean"
          },
          "id": {
            "type": "string"
          },
          "index": {
            "type": "integer"
          },
          "name": {
            "type": "string"
          },
          "panes": {
            "type": "integer"
          },
          "session": {
            "type": "string"
          }
        },
        "required": [
          "id",
          "session",
          "name",
          "index",
          "panes",
          "active"
        ],
        "type": "object"
      },
      "type": [
        "array"
      ]
    }
  },
  "required": [
    "windows",
    "total"
  ],
  "type": "object"
}
```

Tool annotations

```json
{
  "destructiveHint": true,
  "openWorldHint": true,
  "title": "List windows"
}
```