Skip to content
All tools

pdf_read

Documents · macOS · Windows

Effect: read (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

Reads and extracts text from a PDF document (.pdf file). Reads the PDF's text layer only — a scanned or image-only PDF returns little or no text, since this tool does not run OCR. Reads up to 50 pages and ~100 KB of text by default (max_pages changes the page cap); when a cap truncates the result, the header says how many of the total pages were included.

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": {
    "force_download": {
      "description": "If the file is stored in the cloud and evicted from this Mac (dataless), request the download and wait for it instead of failing. Off by default: a download can take minutes and use metered data, so it is the caller's decision.",
      "type": "boolean"
    },
    "max_pages": {
      "description": "Max pages to extract (default: all)",
      "type": "integer"
    },
    "path": {
      "description": "Absolute path to the PDF file",
      "type": "string"
    }
  },
  "required": [
    "path"
  ],
  "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.

{
  "path": "/Users/demo/Documents/launch-checklist.pdf"
}

Windows

Purpose

Reads and extracts text from a PDF file. Best-effort extraction — works well with text-based PDFs.

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": {
    "max_pages": {
      "description": "Maximum pages to read (default: 20)",
      "type": "number"
    },
    "path": {
      "description": "Path to .pdf file",
      "type": "string"
    }
  },
  "required": [
    "path"
  ],
  "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.

{
  "path": "C:\\Users\\demo\\Documents\\launch-checklist.pdf"
}