kill_window

Python

Python
Ruby Unavailable
Lua Unavailable
TypeScript
Rust
Go
Java
.NET
C++
Swift

Kill (close) a tmux window. Requires exact window_id (e.g. ‘@3’).

Destroys the window and all its panes. Use kill_pane to remove a single pane instead. Self-kill protection prevents killing the window containing this MCP process.

All Python tools · JSON · Source

Arguments

socket_name optional: tmux socket name.
Default: null.
window_id required · string: Window ID (e.g. '@1'). Required — no fallback resolution.

Schemas

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

Input schema

{
  "additionalProperties": false,
  "properties": {
    "socket_name": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "tmux socket name."
    },
    "window_id": {
      "description": "Window ID (e.g. '@1'). Required — no fallback resolution.",
      "type": "string"
    }
  },
  "required": [
    "window_id"
  ],
  "type": "object"
}

Output schema

{
  "properties": {
    "result": {
      "type": "string"
    }
  },
  "required": [
    "result"
  ],
  "type": "object",
  "x-fastmcp-wrap-result": true
}

Tool annotations

{
  "destructiveHint": true,
  "idempotentHint": false,
  "openWorldHint": true,
  "readOnlyHint": false
}