# list_windows

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

> List every window on the server. A window linked into several sessions appears once per link, so an id can repeat with a different session_id. 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 every window on the server. A window linked into several sessions appears once per link, so an id can repeat with a different session_id. Inspect tmux metadata; accepts no client-supplied executable input.

[All Rust tools](https://libtmux.org/en/rs/latest/mcp/tools/) · [JSON](https://libtmux.org/en/rs/latest/mcp/tools/list_windows.json) · [Source](https://github.com/libtmux/libtmux-rs/blob/2cef1aa642182dd1970c3688feb6a568ff666e64/crates/tmux-mcp/src/tools/inspect.rs#L125)

## Arguments

This tool has no top-level named arguments. Consult its schema below.

## Schemas

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

Input schema

```json
{
  "additionalProperties": false,
  "properties": {},
  "type": "object"
}
```

Output schema

```json
{
  "$defs": {
    "WindowView": {
      "description": "One window, as the protocol sees it.",
      "properties": {
        "active": {
          "description": "Whether this is the session's active window.",
          "type": "boolean"
        },
        "id": {
          "description": "The `@`-prefixed tmux identity.",
          "type": "string"
        },
        "index": {
          "description": "The window's index within that session.",
          "format": "int32",
          "type": "integer"
        },
        "linked": {
          "description": "Whether more than one session links this window.",
          "type": "boolean"
        },
        "name": {
          "description": "The window name.",
          "type": "string"
        },
        "panes": {
          "description": "How many panes the window holds.",
          "minimum": 0,
          "type": "integer"
        },
        "session_id": {
          "description": "The session this window was reached through.",
          "type": "string"
        }
      },
      "required": [
        "id",
        "session_id",
        "index",
        "name",
        "panes",
        "active",
        "linked"
      ],
      "type": "object"
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "windows": {
      "description": "The windows, in tmux's own order.",
      "items": {
        "$ref": "#/$defs/WindowView"
      },
      "type": "array"
    }
  },
  "required": [
    "windows"
  ],
  "type": "object"
}
```

Tool annotations

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