read_page
Read a Notion page and return it as markdown with metadata. Recursively fetches nested blocks and warns about unsupported block types.
Instructions
Read a page and return metadata plus markdown. Recursively fetches nested blocks and uses the same markdown conventions accepted by create_page. If unsupported block types are omitted from the markdown, they are listed in warnings. Do NOT round-trip markdown through replace_content when omitted_block_types warnings are present; omitted blocks would be deleted.
Notion AI meeting notes are rendered as a synthetic toggle containing the title, an optional recording timestamp callout, and ## Summary / ## Notes heading sections. Transcript sections are included only with include_transcript: true. A read_only_block_rendered warning is emitted whenever such a block is rendered, indicating that round-tripping the markdown through replace_content will replace the native meeting-notes block with ordinary blocks.
Note on max_blocks: the cap counts top-level page blocks only; section descendants of meeting-notes blocks are fetched in full regardless of the cap, consistent with how nested children of normal blocks are fetched.
Long titles are paginated with max_property_items. For markdown conventions, warning shapes, and pagination details, read resources easy-notion://docs/markdown, easy-notion://docs/warnings, and easy-notion://docs/property-pagination.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| page_id | Yes | Page ID | |
| include_metadata | No | Include created_time, last_edited_time, created_by, last_edited_by in response. Default false. | |
| max_blocks | No | Maximum top-level blocks to return. Omit to return all. | |
| max_property_items | No | Max rich_text segments returned when a page title exceeds 25 segments (uncommon in practice). Default 75. Set to 0 for unlimited. Negative values rejected. When the cap is hit, the response includes a truncated_properties warning with a how_to_fetch_all hint. | |
| include_transcript | No | Include Notion AI meeting-notes transcript sections. Default false. Summary and Notes sections are always included when present. |