# paste_text

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

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

MCP is in development

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

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

Uses tmux’s load-buffer and paste-buffer for clean multi-line input, avoiding the issues of sending text line-by-line via [send\_keys](https://libtmux.org/en/py/latest/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/latest/mcp/tools/load_buffer/) + [paste\_buffer](https://libtmux.org/en/py/latest/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/latest/mcp/tools/load_buffer/) + [`paste_buffer`](https://libtmux.org/en/py/latest/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/latest/mcp/tools/show_buffer/) before pasting.

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

## Arguments

* `bracket` optional · boolean

  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".

  Default: `true`.

* `pane_id` optional

  Pane ID (e.g. '%1').

  Default: `null`.

* `session_id` optional

  Session ID for pane resolution.

  Default: `null`.

* `session_name` optional

  Session name for pane resolution.

  Default: `null`.

* `socket_name` optional

  tmux socket name.

  Default: `null`.

* `text` required · string

  The text to paste.

* `window_id` optional

  Window ID for pane resolution.

  Default: `null`.

## Schemas

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