All tools

web_type

Web automation · macOS · Windows

Effect: write (strongest supported action). Status: gated.

Gated means the tool requires an installed app, a connected account, permission, or runtime availability. Check those requirements on the listed platform before using it.

macOS

Purpose

Types text into a form field (input/textarea) on the current page. `target` is a CSS selector or the field's visible label/placeholder. Does NOT submit — use web_click on the submit button afterwards (that step is gated). SPECIAL CASE — file inputs: if `target` resolves to an <input type="file">, `text` is instead treated as a LOCAL FILE PATH on this Mac and the file is attached (JS can't set a file input's value directly; this answers the native file panel programmatically without ever showing it).

Required inputs

Permissions and confirmation

No explicit confirmation parameter is exposed in this snapshot. This does not grant permission to act: obtain user authorization before any real action.

Full input schema — macOS
{
  "properties": {
    "session": {
      "description": "Session name (default 'default').",
      "type": "string"
    },
    "target": {
      "description": "CSS selector or visible label/placeholder of the field.",
      "type": "string"
    },
    "text": {
      "description": "The text to type. For an input[type=file], this is instead the LOCAL FILE PATH to upload.",
      "type": "string"
    }
  },
  "required": [
    "target",
    "text"
  ],
  "type": "object"
}

Documentation example

Do not execute this example. These concrete inputs refer to a fictional demonstration dataset. Resolve real handles and obtain user authorization before any real call.

{
  "session": "demo-browser",
  "target": "input[name='search']",
  "text": "launch checklist"
}

Windows

Purpose

Types text into a form field (input/textarea) on the current page. `target` is a CSS selector or the field's visible label/placeholder. Does NOT submit — use web_click on the submit button afterwards (that step is gated).

Required inputs

Permissions and confirmation

No explicit confirmation parameter is exposed in this snapshot. This does not grant permission to act: obtain user authorization before any real action.

Full input schema — Windows
{
  "properties": {
    "session": {
      "description": "Session name (default 'default').",
      "type": "string"
    },
    "target": {
      "description": "CSS selector or visible label/placeholder of the field.",
      "type": "string"
    },
    "text": {
      "description": "The text to type.",
      "type": "string"
    }
  },
  "required": [
    "target",
    "text"
  ],
  "type": "object"
}

Documentation example

Do not execute this example. These concrete inputs refer to a fictional demonstration dataset. Resolve real handles and obtain user authorization before any real call.

{
  "session": "demo-browser",
  "target": "input[name='search']",
  "text": "launch checklist"
}