# list_sessions

Source: https://libtmux.org/en/py/latest/mcp/tools/list_sessions/

> List tmux sessions (terminal workspaces) on a tmux server.

MCP is in development

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

List tmux sessions (terminal workspaces) on a tmux server.

Use for tmux multiplexer sessions — ‘this session’, ‘my workspace’, ‘the dev session’ — not login sessions or HTTP sessions. The starting point for discovery — call this before targeting specific sessions, windows, or panes.

[All Python tools](../) · [JSON](../list_sessions.json) · [Source](https://github.com/tmux-python/libtmux-mcp/blob/4daddc0dfca96c43bf521d818bf91564e1434760/src/libtmux_mcp/tools/server_tools.py#L362)

## Arguments

* `filters` optional

  Django-style filters as a dict (e.g. \`\`{"session\_name\_\_contains": "dev"}\`\`) or as a JSON string. Some MCP clients require the string form.

  Default: `null`.

* `socket_name` optional

  tmux socket name. Defaults to LIBTMUX\_SOCKET env var.

  Default: `null`.

## Schemas

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