# paste_text

Source: https://libtmux.org/en/py/stable/mcp/tools/paste_text/

> Paste multi-line text into a pane using tmux paste buffers.

tool MCPstable

MCP is in development

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

* **paste_text**( [bracket](https://libtmux.org/en/py/stable/mcp/tools/paste_text/#mcp.tool.paste_text.input%2Fproperties%2Fbracket)?: [boolean](https://json-schema.org/understanding-json-schema/reference/boolean "boolean (JSON Schema)"), [pane_id](https://libtmux.org/en/py/stable/mcp/tools/paste_text/#mcp.tool.paste_text.input%2Fproperties%2Fpane_id)?: [string](https://json-schema.org/understanding-json-schema/reference/string "string (JSON Schema)") | [null](https://json-schema.org/understanding-json-schema/reference/null "null (JSON Schema)"), [session_id](https://libtmux.org/en/py/stable/mcp/tools/paste_text/#mcp.tool.paste_text.input%2Fproperties%2Fsession_id)?: [string](https://json-schema.org/understanding-json-schema/reference/string "string (JSON Schema)") | [null](https://json-schema.org/understanding-json-schema/reference/null "null (JSON Schema)"), [session_name](https://libtmux.org/en/py/stable/mcp/tools/paste_text/#mcp.tool.paste_text.input%2Fproperties%2Fsession_name)?: [string](https://json-schema.org/understanding-json-schema/reference/string "string (JSON Schema)") | [null](https://json-schema.org/understanding-json-schema/reference/null "null (JSON Schema)"), [socket_name](https://libtmux.org/en/py/stable/mcp/tools/paste_text/#mcp.tool.paste_text.input%2Fproperties%2Fsocket_name)?: [string](https://json-schema.org/understanding-json-schema/reference/string "string (JSON Schema)") | [null](https://json-schema.org/understanding-json-schema/reference/null "null (JSON Schema)"), [text](https://libtmux.org/en/py/stable/mcp/tools/paste_text/#mcp.tool.paste_text.input%2Fproperties%2Ftext): [string](https://json-schema.org/understanding-json-schema/reference/string "string (JSON Schema)"), [window_id](https://libtmux.org/en/py/stable/mcp/tools/paste_text/#mcp.tool.paste_text.input%2Fproperties%2Fwindow_id)?: [string](https://json-schema.org/understanding-json-schema/reference/string "string (JSON Schema)") | [null](https://json-schema.org/understanding-json-schema/reference/null "null (JSON Schema)"), )

  tool \[[source](https://github.com/tmux-python/libtmux-mcp/blob/4daddc0dfca96c43bf521d818bf91564e1434760/src/libtmux_mcp/tools/pane_tools/__init__.py#L194)][¶](https://libtmux.org/en/py/stable/mcp/tools/paste_text/#mcp.tool.paste_text)

  Paste multi-line text into a pane using tmux paste buffers.

  Uses tmux’s [load-buffer](https://libtmux.org/en/tmux/latest/manual/load-buffer/) and [paste-buffer](https://libtmux.org/en/tmux/latest/manual/paste-buffer/) for clean multi-line input, avoiding the issues of sending text line-by-line via [send_keys](https://libtmux.org/en/py/stable/mcp/tools/send_keys/). Supports bracketed paste mode for terminals that handle it.

  **When to use this vs. [load_buffer](https://libtmux.org/en/py/stable/mcp/tools/load_buffer/) + [paste_buffer](https://libtmux.org/en/py/stable/mcp/tools/paste_buffer/):** `paste_text` is the fire-and-forget path — the buffer is created, pasted, and deleted in one call. Use [`load_buffer`](https://libtmux.org/en/py/stable/mcp/tools/load_buffer/) + [`paste_buffer`](https://libtmux.org/en/py/stable/mcp/tools/paste_buffer/) when you need to stage content first, paste it into multiple panes, or inspect it with [`show_buffer`](https://libtmux.org/en/py/stable/mcp/tools/show_buffer/) before pasting.

  * MCP request method

    `tools/call` Send `paste_text` as the tool name, with the arguments below.

  ## Arguments[#](https://libtmux.org/en/py/stable/mcp/tools/paste_text/#mcp.tool.paste_text.parameters)

  * **[`bracket`](https://libtmux.org/en/py/stable/mcp/tools/paste_text/#mcp.tool.paste_text.input%2Fproperties%2Fbracket)**? = `true` ([boolean](https://json-schema.org/understanding-json-schema/reference/boolean "boolean (JSON Schema)"))

    Whether to use bracketed paste mode. Default True. Bracketed paste wraps the text in escape sequences that tell the terminal “this is pasted text, not typed input”.

  * **[`pane_id`](https://libtmux.org/en/py/stable/mcp/tools/paste_text/#mcp.tool.paste_text.input%2Fproperties%2Fpane_id)**? = `null` ([string](https://json-schema.org/understanding-json-schema/reference/string "string (JSON Schema)") | [null](https://json-schema.org/understanding-json-schema/reference/null "null (JSON Schema)"))

    Pane ID (e.g. ‘%1’).

  * **[`session_id`](https://libtmux.org/en/py/stable/mcp/tools/paste_text/#mcp.tool.paste_text.input%2Fproperties%2Fsession_id)**? = `null` ([string](https://json-schema.org/understanding-json-schema/reference/string "string (JSON Schema)") | [null](https://json-schema.org/understanding-json-schema/reference/null "null (JSON Schema)"))

    Session ID for pane resolution.

  * **[`session_name`](https://libtmux.org/en/py/stable/mcp/tools/paste_text/#mcp.tool.paste_text.input%2Fproperties%2Fsession_name)**? = `null` ([string](https://json-schema.org/understanding-json-schema/reference/string "string (JSON Schema)") | [null](https://json-schema.org/understanding-json-schema/reference/null "null (JSON Schema)"))

    Session name for pane resolution.

  * **[`socket_name`](https://libtmux.org/en/py/stable/mcp/tools/paste_text/#mcp.tool.paste_text.input%2Fproperties%2Fsocket_name)**? = `null` ([string](https://json-schema.org/understanding-json-schema/reference/string "string (JSON Schema)") | [null](https://json-schema.org/understanding-json-schema/reference/null "null (JSON Schema)"))

    tmux socket name.

  * **[`text`](https://libtmux.org/en/py/stable/mcp/tools/paste_text/#mcp.tool.paste_text.input%2Fproperties%2Ftext)** ([string](https://json-schema.org/understanding-json-schema/reference/string "string (JSON Schema)"))

    The text to paste.

  * **[`window_id`](https://libtmux.org/en/py/stable/mcp/tools/paste_text/#mcp.tool.paste_text.input%2Fproperties%2Fwindow_id)**? = `null` ([string](https://json-schema.org/understanding-json-schema/reference/string "string (JSON Schema)") | [null](https://json-schema.org/understanding-json-schema/reference/null "null (JSON Schema)"))

    Window ID for pane resolution.

  No other arguments are accepted.

  ## Result[#](https://libtmux.org/en/py/stable/mcp/tools/paste_text/#mcp.tool.paste_text.result)

  Returns [object](https://json-schema.org/understanding-json-schema/reference/object "object (JSON Schema)")

  * **[`result`](https://libtmux.org/en/py/stable/mcp/tools/paste_text/#mcp.tool.paste_text.output%2Fproperties%2Fresult)** ([string](https://json-schema.org/understanding-json-schema/reference/string "string (JSON Schema)"))

  ## Annotations[#](https://libtmux.org/en/py/stable/mcp/tools/paste_text/#mcp.tool.paste_text.annotations)

  * [`destructiveHint`](https://libtmux.org/en/py/stable/mcp/reference/glossary/#destructiveHint)

    `true`

  * [`idempotentHint`](https://libtmux.org/en/py/stable/mcp/reference/glossary/#idempotentHint)

    `false`

  * [`openWorldHint`](https://libtmux.org/en/py/stable/mcp/reference/glossary/#openWorldHint)

    `true`

  * [`readOnlyHint`](https://libtmux.org/en/py/stable/mcp/reference/glossary/#readOnlyHint)

    `false`

  ## Protocol data[#](https://libtmux.org/en/py/stable/mcp/tools/paste_text/#mcp.tool.paste_text.schemas)

  Use the complete advertised contract for validation and client integration.

  Input schema

  ```json
  {
    "additionalProperties": false,
    "properties": {
      "bracket": {
        "default": true,
        "description": "Whether to use bracketed paste mode. Default True.\nBracketed paste wraps the text in escape sequences that tell\nthe terminal \"this is pasted text, not typed input\".",
        "type": "boolean"
      },
      "pane_id": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "default": null,
        "description": "Pane ID (e.g. '%1')."
      },
      "session_id": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "default": null,
        "description": "Session ID for pane resolution."
      },
      "session_name": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "default": null,
        "description": "Session name for pane resolution."
      },
      "socket_name": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "default": null,
        "description": "tmux socket name."
      },
      "text": {
        "description": "The text to paste.",
        "type": "string"
      },
      "window_id": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "default": null,
        "description": "Window ID for pane resolution."
      }
    },
    "required": [
      "text"
    ],
    "type": "object"
  }
  ```

  Output schema

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