guides_append_item
ChatGPTAppend a new section or page only when it does not already exist. If guides_get shows a page with the same title, use guides_update_item instead—do not create duplicates.
Productivity
Overview
Guides is a collaborative editor for living personal notebooks in ChatGPT. Read structure, scaffold outlines, fill and revise pages over time—preference profiles, meal plans, learning journeys. OAuth to the user's account; the guide is the primary artifact, not chat history.
Tools
guides_append_item
ChatGPTAppend a new section or page only when it does not already exist. If guides_get shows a page with the same title, use guides_update_item instead—do not create duplicates.
guides_catalog
ChatGPTList notebooks on the user's account. Start here before editing—find slugs for guides to read or evolve.
guides_catalog
ChatGPTList notebooks on the user's account. Start here before editing—find slugs for guides to read or evolve.
guides_create
ChatGPTCreate a new guide from a top-level GDF 1.0 document (not wrapped in {document:...}). Required: gdf_version "1.0", guide.id, guide.title, assets: [], items[] with unique id+type per item. Page parent_id must reference a section defined earlier. Defaults to draft with ai_readable enabled.
guides_create
ChatGPTCreate a new guide from a top-level GDF 1.0 document (not wrapped in {document:...}). Required: gdf_version "1.0", guide.id, guide.title, assets: [], items[] with unique id+type per item. Page parent_id must reference a section defined earlier. Defaults to draft with ai_readable enabled.
guides_delete_item
ChatGPTRemove one section or page by item_id. Use to delete duplicate pages, outdated sections, or scaffold mistakes. Same as remove_item / delete_item. Call guides_get first to identify the correct item_id.
guides_delete_item
ChatGPTRemove one section or page by item_id. Use to delete duplicate pages, outdated sections, or scaffold mistakes. Same as remove_item / delete_item. Call guides_get first to identify the correct item_id.
guides_fill_page
ChatGPTPrimary tool to write markdown into an existing page by item_id. Call guides_outline first to find empty pages. Replaces placeholder content in place—do not append duplicates. Same PATCH as guides_update_item but content is required.
guides_fill_page
ChatGPTPrimary tool to write markdown into an existing page by item_id. Call guides_outline first to find empty pages. Replaces placeholder content in place—do not append duplicates. Same PATCH as guides_update_item but content is required.
guides_get
ChatGPTRead a guide's structure and content (GDF JSON). Each item has id (item-42) and title—use ids with guides_update_item and guides_delete_item. The guide is the artifact you edit.
guides_get
ChatGPTRead a guide's structure and content (GDF JSON). Each item has id (item-42) and title—use ids with guides_update_item and guides_delete_item. The guide is the artifact you edit.
guides_get_item
ChatGPTExport a single section or page by item id (e.g. item-42).
guides_get_item
ChatGPTExport a single section or page by item id (e.g. item-42).
guides_import
ChatGPTReplace an entire guide with a GDF document. Prefer guides_patch_item for small edits.
guides_import
ChatGPTReplace an entire guide with a GDF document. Prefer guides_patch_item for small edits.
guides_merge_items
ChatGPTCombine source page markdown into target page, then delete source. Use when consolidating duplicate or overlapping pages.
guides_merge_items
ChatGPTCombine source page markdown into target page, then delete source. Use when consolidating duplicate or overlapping pages.
guides_move_item
ChatGPTMove a section or page before the start or immediately after another item. Simpler than full reorder when moving one block.
guides_move_item
ChatGPTMove a section or page before the start or immediately after another item. Simpler than full reorder when moving one block.
guides_outline
ChatGPTCompact structure view: sections, pages, item ids (item-42), and whether each page has content. Prefer over guides_get when you need item_ids for guides_fill_page—works on large scaffolded guides without downloading full GDF.
guides_outline
ChatGPTCompact structure view: sections, pages, item ids (item-42), and whether each page has content. Prefer over guides_get when you need item_ids for guides_fill_page—works on large scaffolded guides without downloading full GDF.
guides_patch_item
ChatGPTAlias for guides_update_item. Edit an existing page/section by item_id from guides_get. Replace placeholder content in place—do not append duplicates.
guides_patch_item
ChatGPTAlias for guides_update_item. Edit an existing page/section by item_id from guides_get. Replace placeholder content in place—do not append duplicates.
guides_remove_item
ChatGPTAlias for guides_delete_item. Remove a duplicate or unwanted page/section by item_id from guides_get.
guides_remove_item
ChatGPTAlias for guides_delete_item. Remove a duplicate or unwanted page/section by item_id from guides_get.
guides_reorder_items
ChatGPTSet the full item order for a guide. item_ids must list every item exactly once in desired order (from guides_outline or guides_get).
guides_reorder_items
ChatGPTSet the full item order for a guide. item_ids must list every item exactly once in desired order (from guides_outline or guides_get).
guides_scaffold
ChatGPTEditor: create many sections and empty pages in one operation from an outline. New guide (title) or append to slug (e.g. on-buddhism). First-class alternative to dozens of append calls. Then fill pages with guides_fill_page. For large outlines (40+ pages), scaffold in 2–3 batches by section group.
guides_scaffold
ChatGPTEditor: create many sections and empty pages in one operation from an outline. New guide (title) or append to slug (e.g. on-buddhism). First-class alternative to dozens of append calls. Then fill pages with guides_fill_page. For large outlines (40+ pages), scaffold in 2–3 batches by section group.
guides_update_item
ChatGPTEdit an existing page or section in place: replace markdown body and/or title by item_id. Use to populate scaffold placeholders (Eightfold Path, etc.). Same as update_item / replace_content. Call guides_get first to find item_id—never append_item for pages that already exist.
guides_update_item
ChatGPTEdit an existing page or section in place: replace markdown body and/or title by item_id. Use to populate scaffold placeholders (Eightfold Path, etc.). Same as update_item / replace_content. Call guides_get first to find item_id—never append_item for pages that already exist.
Capabilities
Writes
