Google Docs: Insert a page or section break — MCP tool
Google Docs MCP tool: Inserts a page break or starts a new section at a chosen position.
Technical name: insert_break
What task it solves
I want to start a new page or section.
Inserts a page break or starts a new section at a chosen position.
When to use it
Use kind=page to push following content to a new page; section_next_page / section_continuous start a new section (sections carry their own margins and column settings, editable via raw_request updateSectionStyle).
What to provide
document_id— required.kind— required:page,section_next_page,section_continuous.index— optional insertion point; omit to append at the end of the body.tab_id,segment_id— optional addressing.
What it returns
The batchUpdate reply with the new revisionId.
What changes in Google Docs
A break element is inserted, occupying one index position; later indexes shift by one.
Example request
Insert a page break before the appendix heading.
Errors and limitations
Breaks cannot go into headers, footers, footnotes or table cells. Remove a break by deleting its one-index range with delete_range.
Access also depends on token permissions, quotas, and upstream API limits.
Related MCP tools
- Delete a text range —
delete_range - Raw Google Docs API call —
raw_request
Technical details
- Impact: changes data
- Group: Structure
- Description source:
insert_breakregistration insrc/tools/structure.ts - Full technical reference
- All MCP capabilities