[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M781TP142BTKGMPFCW38KYBY":3,"skill-same:01M781TP142BTKGMPFCW38KYBY":47},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":24,"commitSha":25,"skillDirectory":26,"forksCount":27,"repositoryHtmlUrl":28,"repositoryHomepageUrl":29,"ownerHtmlUrl":30,"ownerBlogUrl":29,"ownerDescription":31,"updatedAt":32,"install":33,"resources":46},"01M781TP142BTKGMPFCW38KYBY","pm-notion",null,"Notion connector knowledge and safe action guide.","polymetrics-ai\u002Fcli","polymetrics-ai","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F177650388?v=4","01M77Z920R1RTP5NXCP1V1HNMS","Polymetrics","01M77Z921DPWZC4DQSSZNWF82B",7,"AGPL-3.0","https:\u002F\u002Fgithub.com\u002Fpolymetrics-ai\u002Fcli\u002Fblob\u002Fmain\u002Fdocs\u002Fskills\u002Fpm-notion\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: pm-notion\ndescription: Notion connector knowledge and safe action guide.\n---\n\n# pm-notion\n\n## Purpose\n\nReads and writes Notion pages, databases, data sources, blocks, comments, views, and file uploads through the Notion REST API.\n\n## Icon\n\n- id: notion\n- asset: icons\u002Fnotion.svg\n- source: upstream_registry\n- review_status: upstream_seeded\n- review_url: https:\u002F\u002Fdevelopers.notion.com\u002Freference\u002Fchanges-by-version\n\n## Capabilities\n\n- check=true catalog=true read=true write=true query=false\n- Integration type: api\n\n## Authentication\n\n- Use pm credentials add with --from-env or --value-stdin for secret fields.\n\n## Configuration\n\n- base_url\n- max_pages\n- page_size\n- token (secret)\n\n## ETL Streams\n\n- databases:\n  - primary key: id\n  - cursor: last_edited_time\n  - fields: archived(boolean), created_time(string), id(string), in_trash(boolean), last_edited_time(string), object(string), parent(object), title(array), url(string)\n- pages:\n  - primary key: id\n  - cursor: last_edited_time\n  - fields: archived(boolean), created_time(string), id(string), in_trash(boolean), last_edited_time(string), object(string), parent(object), properties(object), url(string)\n- users:\n  - primary key: id\n  - fields: avatar_url(string), bot(object), id(string), name(string), object(string), person(object), type(string)\n- custom_emojis:\n  - primary key: id\n  - fields: id(string), name(string), object(string), url(string)\n- file_uploads:\n  - primary key: id\n  - cursor: last_edited_time\n  - fields: content_length(integer), content_type(string), created_time(string), expiry_time(string), filename(string), id(string), last_edited_time(string), number_of_parts(object), object(string), status(string), upload_url(string)\n- views:\n  - primary key: id\n  - cursor: last_edited_time\n  - fields: created_time(string), data_source_id(string), id(string), last_edited_time(string), name(string), object(string), parent(object), type(string)\n\n## Sync Modes\n\n- ETL sync modes: full_refresh_append, full_refresh_overwrite, full_refresh_overwrite_deduped, incremental_append, incremental_append_deduped\n\n## Reverse ETL Actions\n\n- create_meeting_note:\n  - endpoint: POST \u002Fv1\u002Fblocks\u002Fmeeting_notes\n  - optional fields: language, options, title\n  - risk: medium — Notion has no provider idempotency header; keep reverse ETL in plan\u002Fpreview\u002Fapprove\u002Fexecute so each approved record is submitted exactly once.\n- update_block:\n  - endpoint: PATCH \u002Fv1\u002Fblocks\u002F{{ record.block_id }}\n  - required fields: block_id\n  - optional fields: in_trash\n  - risk: medium — Notion has no provider idempotency header; keep reverse ETL in plan\u002Fpreview\u002Fapprove\u002Fexecute so each approved record is submitted exactly once.\n- delete_block:\n  - endpoint: DELETE \u002Fv1\u002Fblocks\u002F{{ record.block_id }}\n  - required fields: block_id\n  - risk: high — Notion has no provider idempotency header; keep reverse ETL in plan\u002Fpreview\u002Fapprove\u002Fexecute so each approved record is submitted exactly once.\n- append_block_children:\n  - endpoint: PATCH \u002Fv1\u002Fblocks\u002F{{ record.block_id }}\u002Fchildren\n  - required fields: block_id, children\n  - optional fields: position\n  - risk: medium — Notion has no provider idempotency header; keep reverse ETL in plan\u002Fpreview\u002Fapprove\u002Fexecute so each approved record is submitted exactly once.\n- create_comment:\n  - endpoint: POST \u002Fv1\u002Fcomments\n  - optional fields: attachments, display_name\n  - risk: medium — Notion has no provider idempotency header; keep reverse ETL in plan\u002Fpreview\u002Fapprove\u002Fexecute so each approved record is submitted exactly once.\n- update_comment:\n  - endpoint: PATCH \u002Fv1\u002Fcomments\u002F{{ record.comment_id }}\n  - required fields: comment_id, rich_text\n  - risk: medium — Notion has no provider idempotency header; keep reverse ETL in plan\u002Fpreview\u002Fapprove\u002Fexecute so each approved record is submitted exactly once.\n- update_comment_markdown:\n  - endpoint: PATCH \u002Fv1\u002Fcomments\u002F{{ record.comment_id }}\n  - required fields: comment_id, markdown\n  - risk: medium — Notion has no provider idempotency header; keep reverse ETL in plan\u002Fpreview\u002Fapprove\u002Fexecute so each approved record is submitted exactly once.\n- delete_comment:\n  - endpoint: DELETE \u002Fv1\u002Fcomments\u002F{{ record.comment_id }}\n  - required fields: comment_id\n  - risk: high — Notion has no provider idempotency header; keep reverse ETL in plan\u002Fpreview\u002Fapprove\u002Fexecute so each approved record is submitted exactly once.\n- create_data_source:\n  - endpoint: POST \u002Fv1\u002Fdata_sources\n  - required fields: parent, properties\n  - optional fields: icon, title\n  - risk: medium — Notion has no provider idempotency header; keep reverse ETL in plan\u002Fpreview\u002Fapprove\u002Fexecute so each approved record is submitted exactly once.\n- update_data_source:\n  - endpoint: PATCH \u002Fv1\u002Fdata_sources\u002F{{ record.data_source_id }}\n  - required fields: data_source_id\n  - optional fields: icon, in_trash, parent, properties, title\n  - risk: medium — Notion has no provider idempotency header; keep reverse ETL in plan\u002Fpreview\u002Fapprove\u002Fexecute so each approved record is submitted exactly once.\n- create_database:\n  - endpoint: POST \u002Fv1\u002Fdatabases\n  - required fields: parent\n  - optional fields: cover, description, icon, initial_data_source, is_inline, title\n  - risk: medium — Notion has no provider idempotency header; keep reverse ETL in plan\u002Fpreview\u002Fapprove\u002Fexecute so each approved record is submitted exactly once.\n- update_database:\n  - endpoint: PATCH \u002Fv1\u002Fdatabases\u002F{{ record.database_id }}\n  - required fields: database_id\n  - optional fields: cover, description, icon, in_trash, is_inline, is_locked, parent, title\n  - risk: medium — Notion has no provider idempotency header; keep reverse ETL in plan\u002Fpreview\u002Fapprove\u002Fexecute so each approved record is submitted exactly once.\n- create_page:\n  - endpoint: POST \u002Fv1\u002Fpages\n  - optional fields: allow_async, children, content, cover, icon, markdown, parent, position, properties, template\n  - risk: medium — Notion has no provider idempotency header; keep reverse ETL in plan\u002Fpreview\u002Fapprove\u002Fexecute so each approved record is submitted exactly once.\n- update_page:\n  - endpoint: PATCH \u002Fv1\u002Fpages\u002F{{ record.page_id }}\n  - required fields: page_id\n  - optional fields: cover, erase_content, icon, in_trash, is_archived, is_locked, properties, template\n  - risk: medium — Notion has no provider idempotency header; keep reverse ETL in plan\u002Fpreview\u002Fapprove\u002Fexecute so each approved record is submitted exactly once.\n- update_page_markdown:\n  - endpoint: PATCH \u002Fv1\u002Fpages\u002F{{ record.page_id }}\u002Fmarkdown\n  - required fields: page_id\n  - optional fields: allow_async\n  - risk: medium — Notion has no provider idempotency header; keep reverse ETL in plan\u002Fpreview\u002Fapprove\u002Fexecute so each approved record is submitted exactly once.\n- move_page:\n  - endpoint: POST \u002Fv1\u002Fpages\u002F{{ record.page_id }}\u002Fmove\n  - required fields: page_id, parent\n  - risk: medium — Notion has no provider idempotency header; keep reverse ETL in plan\u002Fpreview\u002Fapprove\u002Fexecute so each approved record is submitted exactly once.\n- move_page_to_data_source:\n  - endpoint: POST \u002Fv1\u002Fpages\u002F{{ record.page_id }}\u002Fmove\n  - required fields: page_id, parent\n  - risk: medium — Notion has no provider idempotency header; keep reverse ETL in plan\u002Fpreview\u002Fapprove\u002Fexecute so each approved record is submitted exactly once.\n- create_view:\n  - endpoint: POST \u002Fv1\u002Fviews\n  - required fields: data_source_id, name, type\n  - optional fields: configuration, create_database, database_id, filter, placement, position, quick_filters, sorts, view_id\n  - risk: medium — Notion has no provider idempotency header; keep reverse ETL in plan\u002Fpreview\u002Fapprove\u002Fexecute so each approved record is submitted exactly once.\n- update_view:\n  - endpoint: PATCH \u002Fv1\u002Fviews\u002F{{ record.view_id }}\n  - required fields: view_id\n  - optional fields: configuration, filter, name, quick_filters, sorts\n  - risk: medium — Notion has no provider idempotency header; keep reverse ETL in plan\u002Fpreview\u002Fapprove\u002Fexecute so each approved record is submitted exactly once.\n- delete_view:\n  - endpoint: DELETE \u002Fv1\u002Fviews\u002F{{ record.view_id }}\n  - required fields: view_id\n  - risk: high — Notion has no provider idempotency header; keep reverse ETL in plan\u002Fpreview\u002Fapprove\u002Fexecute so each approved record is submitted exactly once.\n- create_view_query:\n  - endpoint: POST \u002Fv1\u002Fviews\u002F{{ record.view_id }}\u002Fqueries\n  - required fields: view_id\n  - optional fields: page_size\n  - risk: medium — Notion has no provider idempotency header; keep reverse ETL in plan\u002Fpreview\u002Fapprove\u002Fexecute so each approved record is submitted exactly once.\n- delete_view_query:\n  - endpoint: DELETE \u002Fv1\u002Fviews\u002F{{ record.view_id }}\u002Fqueries\u002F{{ record.query_id }}\n  - required fields: view_id, query_id\n  - risk: high — Notion has no provider idempotency header; keep reverse ETL in plan\u002Fpreview\u002Fapprove\u002Fexecute so each approved record is submitted exactly once.\n- create_file_upload:\n  - endpoint: POST \u002Fv1\u002Ffile_uploads\n  - optional fields: content_type, external_url, filename, mode, number_of_parts\n  - risk: medium — Notion has no provider idempotency header; keep reverse ETL in plan\u002Fpreview\u002Fapprove\u002Fexecute so each approved record is submitted exactly once.\n- complete_file_upload:\n  - endpoint: POST \u002Fv1\u002Ffile_uploads\u002F{{ record.file_upload_id }}\u002Fcomplete\n  - required fields: file_upload_id\n  - risk: medium — Notion has no provider idempotency header; keep reverse ETL in plan\u002Fpreview\u002Fapprove\u002Fexecute so each approved record is submitted exactly once.\n\n## Security\n\n- read risk: external Notion API read of workspace databases\u002Fpages\u002Fusers\n- approval: none; read-only source connector\n- Never pass secret values in chat, shell arguments, logs, docs, or JSON output.\n\n## Command Surface\n\n- Work with Notion pages, databases, data sources, blocks, comments, views and file uploads from the command line.\n- Usage: pm notion \u003Ccommand> [flags]\n- Source CLI: Notion API (https:\u002F\u002Fdevelopers.notion.com\u002Fopenapi.json)\n- Global flags:\n  - --approval-token-stdin (boolean): Read the approval token as one bounded line from standard input.\n- Databases\n- Pages\n- Users\n- Custom Emojis\n- File Uploads\n- Views\n- Async Task\n- Block\n- Comment\n- Data Source\n- Database\n- File Upload\n- Page\n- User\n- View\n- Meeting Note\n- Other Commands\n  - databases list - List Notion databases as ETL records. [intent=etl availability=implemented stream=databases]\n  - pages list - List Notion pages as ETL records. [intent=etl availability=implemented stream=pages]\n  - users list - List Notion users as ETL records. [intent=etl availability=implemented stream=users]\n  - custom-emojis list - List Notion custom emojis as ETL records. [intent=etl availability=implemented stream=custom_emojis]\n  - file-uploads list - List Notion file uploads as ETL records. [intent=etl availability=implemented stream=file_uploads]\n  - views list - List Notion views as ETL records. [intent=etl availability=implemented stream=views]\n  - async-task get - Retrieve an async task [intent=direct_read availability=implemented operation=notion.retrieve_async_task]; notes: Bounded Notion read; fixed method and path with typed request fields.; flags: --page, --page-cursor\n  - block get - Retrieve a block [intent=direct_read availability=implemented operation=notion.retrieve_block]; notes: Bounded Notion read; fixed method and path with typed request fields.; flags: --page, --page-cursor\n  - block children list - Retrieve block children [intent=direct_read availability=implemented operation=notion.retrieve_block_children]; notes: Bounded Notion read; fixed method and path with typed request fields.; flags: --page, --page-cursor\n  - comment list - List comments [intent=direct_read availability=implemented operation=notion.list_comments]; notes: Bounded Notion read; fixed method and path with typed request fields.; flags: --page, --page-cursor\n  - comment get - Retrieve a comment [intent=direct_read availability=implemented operation=notion.retrieve_comment]; notes: Bounded Notion read; fixed method and path with typed request fields.; flags: --page, --page-cursor\n  - data-source get - Retrieve a data source [intent=direct_read availability=implemented operation=notion.retrieve_data_source]; notes: Bounded Notion read; fixed method and path with typed request fields.; flags: --page, --page-cursor\n  - data-source templates list - List templates in a data source [intent=direct_read availability=implemented operation=notion.list_data_source_templates]; notes: Bounded Notion read; fixed method and path with typed request fields.; flags: --page, --page-cursor\n  - database get - Retrieve a database [intent=direct_read availability=implemented operation=notion.retrieve_database]; notes: Bounded Notion read; fixed method and path with typed request fields.; flags: --page, --page-cursor\n  - file-upload get - Retrieve a file upload [intent=direct_read availability=implemented operation=notion.retrieve_file_upload]; notes: Bounded Notion read; fixed method and path with typed request fields.; flags: --page, --page-cursor\n  - page get - Retrieve a page [intent=direct_read availability=implemented operation=notion.retrieve_page]; notes: Bounded Notion read; fixed method and path with typed request fields.; flags: --page, --page-cursor\n  - page markdown get - Retrieve a page as markdown [intent=direct_read availability=implemented operation=notion.retrieve_page_markdown]; notes: Bounded Notion read; fixed method and path with typed request fields.; flags: --page, --page-cursor\n  - page property get - Retrieve a page property item [intent=direct_read availability=implemented operation=notion.retrieve_page_property]; notes: Bounded Notion read; fixed method and path with typed request fields.; flags: --page, --page-cursor\n  - user me get - Retrieve your token's bot user [intent=direct_read availability=implemented operation=notion.retrieve_bot_user]; notes: Bounded Notion read; fixed method and path with typed request fields.; flags: --page, --page-cursor\n  - user get - Retrieve a user [intent=direct_read availability=implemented operation=notion.retrieve_user]; notes: Bounded Notion read; fixed method and path with typed request fields.; flags: --page, --page-cursor\n  - view get - Retrieve a view [intent=direct_read availability=implemented operation=notion.retrieve_view]; notes: Bounded Notion read; fixed method and path with typed request fields.; flags: --page, --page-cursor\n  - view query results get - Get view query results [intent=direct_read availability=implemented operation=notion.retrieve_view_query_results]; notes: Bounded Notion read; fixed method and path with typed request fields.; flags: --page, --page-cursor\n  - data-source query - Query a data source [intent=direct_read availability=implemented operation=notion.query_data_source]; notes: Bounded Notion read; fixed method and path with typed request fields.; flags: --page-size, --is-archived, --result-type, --page, --page-cursor\n  - meeting-note query - Query meeting notes [intent=direct_read availability=implemented operation=notion.query_meeting_notes]; notes: Bounded Notion read; fixed method and path with typed request fields.; flags: --limit, --page, --page-cursor\n  - meeting-note create - Create a meeting note [intent=reverse_etl availability=implemented write=create_meeting_note]; approval: reverse ETL mutations require plan, preview, explicit approval, and execute; destructive actions require destructive confirmation.; risk: medium — Notion has no provider idempotency header; keep reverse ETL in plan\u002Fpreview\u002Fapprove\u002Fexecute so each approved record is submitted exactly once.; flags: --language, --title\n  - block update - Update a block [intent=reverse_etl availability=implemented write=update_block]; approval: reverse ETL mutations require plan, preview, explicit approval, and execute; destructive actions require destructive confirmation.; risk: medium — Notion has no provider idempotency header; keep reverse ETL in plan\u002Fpreview\u002Fapprove\u002Fexecute so each approved record is submitted exactly once.; flags: --block-id (required), --in-trash\n  - block delete - Delete a block [intent=reverse_etl availability=implemented write=delete_block]; approval: reverse ETL mutations require plan, preview, explicit approval, and execute; destructive actions require destructive confirmation.; risk: high — Notion has no provider idempotency header; keep reverse ETL in plan\u002Fpreview\u002Fapprove\u002Fexecute so each approved record is submitted exactly once.; flags: --block-id (required)\n  - block children append - Append block children [intent=reverse_etl availability=partial write=append_block_children]; approval: reverse ETL mutations require plan, preview, explicit approval, and execute; destructive actions require destructive confirmation.; risk: medium — Notion has no provider idempotency header; keep reverse ETL in plan\u002Fpreview\u002Fapprove\u002Fexecute so each approved record is submitted exactly once.; notes: Reverse ETL from a source record is the supported path: children is an array over Notion's 31-arm block-type union; no typed scalar leaf exists for a flag contract; flags: --block-id (required)\n  - comment create - Create a comment [intent=reverse_etl availability=implemented write=create_comment]; approval: reverse ETL mutations require plan, preview, explicit approval, and execute; destructive actions require destructive confirmation.; risk: medium — Notion has no provider idempotency header; keep reverse ETL in plan\u002Fpreview\u002Fapprove\u002Fexecute so each approved record is submitted exactly once.\n  - comment update - Update a comment [intent=reverse_etl availability=partial write=update_comment]; approval: reverse ETL mutations require plan, preview, explicit approval, and execute; destructive actions require destructive confirmation.; risk: medium — Notion has no provider idempotency header; keep reverse ETL in plan\u002Fpreview\u002Fapprove\u002Fexecute so each approved record is submitted exactly once.; notes: Reverse ETL from a source record is the supported path: rich_text is an array of rich-text objects with no scalar leaf; supply it from a reverse-ETL source record; flags: --comment-id (required)\n  - comment update-markdown - Update a comment [intent=reverse_etl availability=implemented write=update_comment_markdown]; approval: reverse ETL mutations require plan, preview, explicit approval, and execute; destructive actions require destructive confirmation.; risk: medium — Notion has no provider idempotency header; keep reverse ETL in plan\u002Fpreview\u002Fapprove\u002Fexecute so each approved record is submitted exactly once.; flags: --comment-id (required), --markdown (required)\n  - comment delete - Delete a comment [intent=reverse_etl availability=implemented write=delete_comment]; approval: reverse ETL mutations require plan, preview, explicit approval, and execute; destructive actions require destructive confirmation.; risk: high — Notion has no provider idempotency header; keep reverse ETL in plan\u002Fpreview\u002Fapprove\u002Fexecute so each approved record is submitted exactly once.; flags: --comment-id (required)\n  - data-source create - Create a data source [intent=reverse_etl availability=partial write=create_data_source]; approval: reverse ETL mutations require plan, preview, explicit approval, and execute; destructive actions require destructive confirmation.; risk: medium — Notion has no provider idempotency header; keep reverse ETL in plan\u002Fpreview\u002Fapprove\u002Fexecute so each approved record is submitted exactly once.; notes: Reverse ETL from a source record is the supported path: properties is a free-form map of property definitions with no declared required scalar leaf; flags: --parent-database-id (required)\n  - data-source update - Update a data source [intent=reverse_etl availability=implemented write=update_data_source]; approval: reverse ETL mutations require plan, preview, explicit approval, and execute; destructive actions require destructive confirmation.; risk: medium — Notion has no provider idempotency header; keep reverse ETL in plan\u002Fpreview\u002Fapprove\u002Fexecute so each approved record is submitted exactly once.; flags: --data-source-id (required), --in-trash\n  - database create - Create a database [intent=reverse_etl availability=implemented write=create_database]; approval: reverse ETL mutations require plan, preview, explicit approval, and execute; destructive actions require destructive confirmation.; risk: medium — Notion has no provider idempotency header; keep reverse ETL in plan\u002Fpreview\u002Fapprove\u002Fexecute so each approved record is submitted exactly once.; flags: --is-inline, --parent (required)\n  - database update - Update a database [intent=reverse_etl availability=implemented write=update_database]; approval: reverse ETL mutations require plan, preview, explicit approval, and execute; destructive actions require destructive confirmation.; risk: medium — Notion has no provider idempotency header; keep reverse ETL in plan\u002Fpreview\u002Fapprove\u002Fexecute so each approved record is submitted exactly once.; flags: --database-id (required), --in-trash, --is-inline, --is-locked, --parent\n  - page create - Create a page [intent=reverse_etl availability=implemented write=create_page]; approval: reverse ETL mutations require plan, preview, explicit approval, and execute; destructive actions require destructive confirmation.; risk: medium — Notion has no provider idempotency header; keep reverse ETL in plan\u002Fpreview\u002Fapprove\u002Fexecute so each approved record is submitted exactly once.; flags: --allow-async, --markdown\n  - page update - Update page [intent=reverse_etl availability=implemented write=update_page]; approval: reverse ETL mutations require plan, preview, explicit approval, and execute; destructive actions require destructive confirmation.; risk: medium — Notion has no provider idempotency header; keep reverse ETL in plan\u002Fpreview\u002Fapprove\u002Fexecute so each approved record is submitted exactly once.; flags: --erase-content, --in-trash, --is-archived, --is-locked, --page-id (required)\n  - page markdown update - Update a page's content as markdown [intent=reverse_etl availability=implemented write=update_page_markdown]; approval: reverse ETL mutations require plan, preview, explicit approval, and execute; destructive actions require destructive confirmation.; risk: medium — Notion has no provider idempotency header; keep reverse ETL in plan\u002Fpreview\u002Fapprove\u002Fexecute so each approved record is submitted exactly once.; flags: --allow-async, --page-id (required)\n  - page move - Move a page [intent=reverse_etl availability=implemented write=move_page]; approval: reverse ETL mutations require plan, preview, explicit approval, and execute; destructive actions require destructive confirmation.; risk: medium — Notion has no provider idempotency header; keep reverse ETL in plan\u002Fpreview\u002Fapprove\u002Fexecute so each approved record is submitted exactly once.; flags: --page-id (required), --parent-page-id (required)\n  - page move-to-data-source - Move a page [intent=reverse_etl availability=implemented write=move_page_to_data_source]; approval: reverse ETL mutations require plan, preview, explicit approval, and execute; destructive actions require destructive confirmation.; risk: medium — Notion has no provider idempotency header; keep reverse ETL in plan\u002Fpreview\u002Fapprove\u002Fexecute so each approved record is submitted exactly once.; flags: --page-id (required), --parent-data-source-id (required)\n  - view create - Create a view [intent=reverse_etl availability=implemented write=create_view]; approval: reverse ETL mutations require plan, preview, explicit approval, and execute; destructive actions require destructive confirmation.; risk: medium — Notion has no provider idempotency header; keep reverse ETL in plan\u002Fpreview\u002Fapprove\u002Fexecute so each approved record is submitted exactly once.; flags: --data-source-id (required), --database-id, --name (required), --type (required), --view-id\n  - view update - Update a view [intent=reverse_etl availability=implemented write=update_view]; approval: reverse ETL mutations require plan, preview, explicit approval, and execute; destructive actions require destructive confirmation.; risk: medium — Notion has no provider idempotency header; keep reverse ETL in plan\u002Fpreview\u002Fapprove\u002Fexecute so each approved record is submitted exactly once.; flags: --name, --view-id (required)\n  - view delete - Delete a view [intent=reverse_etl availability=implemented write=delete_view]; approval: reverse ETL mutations require plan, preview, explicit approval, and execute; destructive actions require destructive confirmation.; risk: high — Notion has no provider idempotency header; keep reverse ETL in plan\u002Fpreview\u002Fapprove\u002Fexecute so each approved record is submitted exactly once.; flags: --view-id (required)\n  - view query create - Create a view query [intent=reverse_etl availability=implemented write=create_view_query]; approval: reverse ETL mutations require plan, preview, explicit approval, and execute; destructive actions require destructive confirmation.; risk: medium — Notion has no provider idempotency header; keep reverse ETL in plan\u002Fpreview\u002Fapprove\u002Fexecute so each approved record is submitted exactly once.; flags: --page-size, --view-id (required)\n  - view query delete - Delete a view query [intent=reverse_etl availability=implemented write=delete_view_query]; approval: reverse ETL mutations require plan, preview, explicit approval, and execute; destructive actions require destructive confirmation.; risk: high — Notion has no provider idempotency header; keep reverse ETL in plan\u002Fpreview\u002Fapprove\u002Fexecute so each approved record is submitted exactly once.; flags: --query-id (required), --view-id (required)\n  - file-upload create - Create a file upload [intent=reverse_etl availability=implemented write=create_file_upload]; approval: reverse ETL mutations require plan, preview, explicit approval, and execute; destructive actions require destructive confirmation.; risk: medium — Notion has no provider idempotency header; keep reverse ETL in plan\u002Fpreview\u002Fapprove\u002Fexecute so each approved record is submitted exactly once.; flags: --content-type, --external-url, --filename, --mode, --number-of-parts\n  - file-upload complete - Complete a multi-part file upload [intent=reverse_etl availability=implemented write=complete_file_upload]; approval: reverse ETL mutations require plan, preview, explicit approval, and execute; destructive actions require destructive confirmation.; risk: medium — Notion has no provider idempotency header; keep reverse ETL in plan\u002Fpreview\u002Fapprove\u002Fexecute so each approved record is submitted exactly once.; flags: --file-upload-id (required)\n  - file-upload send - Upload a file [intent=reverse_etl availability=planned operation=notion.send_file_upload]; approval: binary\u002Ffile uploads require plan, preview, explicit approval, and payload digest approval before execution; risk: blocked shared-runtime binary\u002Ffile transfer dependency; notes: Operation is bounded in operations.json; promotion is blocked on the shared file upload runner that binds provider paths to approved payload digests. Named dependency, not a blank disposition.\n- Help topics:\n  - safety - Reverse ETL mutations require plan, preview, explicit approval, and execute; destructive actions require destructive confirmation.\n  - pagination - Notion paginates with start_cursor\u002Fnext_cursor and has_more; ETL streams follow the cursor to exhaustion within the configured page bounds.\n\n## Commands\n\n### Inspect as a manual\n\n```bash\npm connectors inspect notion\n```\n\n### Inspect as structured JSON\n\n```bash\npm connectors inspect notion --json\n```\n\n## Agent Rules\n\n- Run pm connectors inspect notion before creating credentials or plans.\n- Use --json only when the caller needs structured output; use the manual for human-readable guidance.\n- Never ask the user to paste secret values into chat.\n- For reverse ETL writes, create a plan, show the preview, wait for explicit approval, then run with the approval token.\n","# pm-notion\n\n## Purpose\n\nReads and writes Notion pages, databases, data sources, blocks, comments, views, and file uploads through the Notion REST API.\n\n## Icon\n\n- id: notion\n- asset: icons\u002Fnotion.svg\n- source: upstream_registry\n- review_status: upstream_seeded\n- review_url: https:\u002F\u002Fdevelopers.notion.com\u002Freference\u002Fchanges-by-version\n\n## Capabilities\n\n- check=true catalog=true read=true write=true query=false\n- Integration type: api\n\n## Authentication\n\n- Use pm credentials add with --from-env or --value-stdin for secret fields.\n\n## Configuration\n\n- base_url\n- max_pages\n- page_size\n- token (secret)\n\n## ETL Streams\n\n- databases:\n  - primary key: id\n  - cursor: last_edited_time\n  - fields: archived(boolean), created_time(string), id(string), in_trash(boolean), last_edited_time(string), object(string), parent(object), title(array), url(string)\n- pages:\n  - primary key: id\n  - cursor: last_edited_time\n  - fields: archived(boolean), created_time(string), id(string), in_trash(boolean), last_edited_time(string), object(string), parent(object), properties(object), url(string)\n- users:\n  - primary key: id\n  - fields: avatar_url(string), bot(object), id(string), name(string), object(string), person(object), type(string)\n- custom_emojis:\n  - primary key: id\n  - fields: id(string), name(string), object(string), url(string)\n- file_uploads:\n  - primary key: id\n  - cursor: last_edited_time\n  - fields: content_length(integer), content_type(string), created_time(string), expiry_time(string), filename(string), id(string), last_edited_time(string), number_of_parts(object), object(string), status(string), upload_url(string)\n- views:\n  - primary key: id\n  - cursor: last_edited_time\n  - fields: created_time(string), data_source_id(string), id(string), last_edited_time(string), name(string), object(string), parent(object), type(string)\n\n## Sync Modes\n\n- ETL sync modes: full_refresh_append, full_refresh_overwrite, full_refresh_overwrite_deduped, incremental_append, incremental_append_deduped\n\n## Reverse ETL Actions\n\n- create_meeting_note:\n  - endpoint: POST \u002Fv1\u002Fblocks\u002Fmeeting_notes\n  - optional fields: language, options, title\n  - risk: medium — Notion has no provider idempotency header; keep reverse ETL in plan\u002Fpreview\u002Fapprove\u002Fexecute so each approved record is submitted exactly once.\n- update_block:\n  - endpoint: PATCH \u002Fv1\u002Fblocks\u002F{{ record.block_id }}\n  - required fields: block_id\n  - optional fields: in_trash\n  - risk: medium — Notion has no provider idempotency header; keep reverse ETL in plan\u002Fpreview\u002Fapprove\u002Fexecute so each approved record is submitted exactly once.\n- delete_block:\n  - endpoint: DELETE \u002Fv1\u002Fblocks\u002F{{ record.block_id }}\n  - required fields: block_id\n  - risk: high — Notion has no provider idempotency header; keep reverse ETL in plan\u002Fpreview\u002Fapprove\u002Fexecute so each approved record is submitted exactly once.\n- append_block_children:\n  - endpoint: PATCH \u002Fv1\u002Fblocks\u002F{{ record.block_id }}\u002Fchildren\n  - required fields: block_id, children\n  - optional fields: position\n  - risk: medium — Notion has no provider idempotency header; keep reverse ETL in plan\u002Fpreview\u002Fapprove\u002Fexecute so each approved record is submitted exactly once.\n- create_comment:\n  - endpoint: POST \u002Fv1\u002Fcomments\n  - optional fields: attachments, display_name\n  - risk: medium — Notion has no provider idempotency header; keep reverse ETL in plan\u002Fpreview\u002Fapprove\u002Fexecute so each approved record is submitted exactly once.\n- update_comment:\n  - endpoint: PATCH \u002Fv1\u002Fcomments\u002F{{ record.comment_id }}\n  - required fields: comment_id, rich_text\n  - risk: medium — Notion has no provider idempotency header; keep reverse ETL in plan\u002Fpreview\u002Fapprove\u002Fexecute so each approved record is submitted exactly once.\n- update_comment_markdown:\n  - endpoint: PATCH \u002Fv1\u002Fcomments\u002F{{ record.comment_id }}\n  - required fields: comment_id, markdown\n  - risk: medium — Notion has no provider idempotency header; keep reverse ETL in plan\u002Fpreview\u002Fapprove\u002Fexecute so each approved record is submitted exactly once.\n- delete_comment:\n  - endpoint: DELETE \u002Fv1\u002Fcomments\u002F{{ record.comment_id }}\n  - required fields: comment_id\n  - risk: high — Notion has no provider idempotency header; keep reverse ETL in plan\u002Fpreview\u002Fapprove\u002Fexecute so each approved record is submitted exactly once.\n- create_data_source:\n  - endpoint: POST \u002Fv1\u002Fdata_sources\n  - required fields: parent, properties\n  - optional fields: icon, title\n  - risk: medium — Notion has no provider idempotency header; keep reverse ETL in plan\u002Fpreview\u002Fapprove\u002Fexecute so each approved record is submitted exactly once.\n- update_data_source:\n  - endpoint: PATCH \u002Fv1\u002Fdata_sources\u002F{{ record.data_source_id }}\n  - required fields: data_source_id\n  - optional fields: icon, in_trash, parent, properties, title\n  - risk: medium — Notion has no provider idempotency header; keep reverse ETL in plan\u002Fpreview\u002Fapprove\u002Fexecute so each approved record is submitted exactly once.\n- create_database:\n  - endpoint: POST \u002Fv1\u002Fdatabases\n  - required fields: parent\n  - optional fields: cover, description, icon, initial_data_source, is_inline, title\n  - risk: medium — Notion has no provider idempotency header; keep reverse ETL in plan\u002Fpreview\u002Fapprove\u002Fexecute so each approved record is submitted exactly once.\n- update_database:\n  - endpoint: PATCH \u002Fv1\u002Fdatabases\u002F{{ record.database_id }}\n  - required fields: database_id\n  - optional fields: cover, description, icon, in_trash, is_inline, is_locked, parent, title\n  - risk: medium — Notion has no provider idempotency header; keep reverse ETL in plan\u002Fpreview\u002Fapprove\u002Fexecute so each approved record is submitted exactly once.\n- create_page:\n  - endpoint: POST \u002Fv1\u002Fpages\n  - optional fields: allow_async, children, content, cover, icon, markdown, parent, position, properties, template\n  - risk: medium — Notion has no provider idempotency header; keep reverse ETL in plan\u002Fpreview\u002Fapprove\u002Fexecute so each approved record is submitted exactly once.\n- update_page:\n  - endpoint: PATCH \u002Fv1\u002Fpages\u002F{{ record.page_id }}\n  - required fields: page_id\n  - optional fields: cover, erase_content, icon, in_trash, is_archived, is_locked, properties, template\n  - risk: medium — Notion has no provider idempotency header; keep reverse ETL in plan\u002Fpreview\u002Fapprove\u002Fexecute so each approved record is submitted exactly once.\n- update_page_markdown:\n  - endpoint: PATCH \u002Fv1\u002Fpages\u002F{{ record.page_id }}\u002Fmarkdown\n  - required fields: page_id\n  - optional fields: allow_async\n  - risk: medium — Notion has no provider idempotency header; keep reverse ETL in plan\u002Fpreview\u002Fapprove\u002Fexecute so each approved record is submitted exactly once.\n- move_page:\n  - endpoint: POST \u002Fv1\u002Fpages\u002F{{ record.page_id }}\u002Fmove\n  - required fields: page_id, parent\n  - risk: medium — Notion has no provider idempotency header; keep reverse ETL in plan\u002Fpreview\u002Fapprove\u002Fexecute so each approved record is submitted exactly once.\n- move_page_to_data_source:\n  - endpoint: POST \u002Fv1\u002Fpages\u002F{{ record.page_id }}\u002Fmove\n  - required fields: page_id, parent\n  - risk: medium — Notion has no provider idempotency header; keep reverse ETL in plan\u002Fpreview\u002Fapprove\u002Fexecute so each approved record is submitted exactly once.\n- create_view:\n  - endpoint: POST \u002Fv1\u002Fviews\n  - required fields: data_source_id, name, type\n  - optional fields: configuration, create_database, database_id, filter, placement, position, quick_filters, sorts, view_id\n  - risk: medium — Notion has no provider idempotency header; keep reverse ETL in plan\u002Fpreview\u002Fapprove\u002Fexecute so each approved record is submitted exactly once.\n- update_view:\n  - endpoint: PATCH \u002Fv1\u002Fviews\u002F{{ record.view_id }}\n  - required fields: view_id\n  - optional fields: configuration, filter, name, quick_filters, sorts\n  - risk: medium — Notion has no provider idempotency header; keep reverse ETL in plan\u002Fpreview\u002Fapprove\u002Fexecute so each approved record is submitted exactly once.\n- delete_view:\n  - endpoint: DELETE \u002Fv1\u002Fviews\u002F{{ record.view_id }}\n  - required fields: view_id\n  - risk: high — Notion has no provider idempotency header; keep reverse ETL in plan\u002Fpreview\u002Fapprove\u002Fexecute so each approved record is submitted exactly once.\n- create_view_query:\n  - endpoint: POST \u002Fv1\u002Fviews\u002F{{ record.view_id }}\u002Fqueries\n  - required fields: view_id\n  - optional fields: page_size\n  - risk: medium — Notion has no provider idempotency header; keep reverse ETL in plan\u002Fpreview\u002Fapprove\u002Fexecute so each approved record is submitted exactly once.\n- delete_view_query:\n  - endpoint: DELETE \u002Fv1\u002Fviews\u002F{{ record.view_id }}\u002Fqueries\u002F{{ record.query_id }}\n  - required fields: view_id, query_id\n  - risk: high — Notion has no provider idempotency header; keep reverse ETL in plan\u002Fpreview\u002Fapprove\u002Fexecute so each approved record is submitted exactly once.\n- create_file_upload:\n  - endpoint: POST \u002Fv1\u002Ffile_uploads\n  - optional fields: content_type, external_url, filename, mode, number_of_parts\n  - risk: medium — Notion has no provider idempotency header; keep reverse ETL in plan\u002Fpreview\u002Fapprove\u002Fexecute so each approved record is submitted exactly once.\n- complete_file_upload:\n  - endpoint: POST \u002Fv1\u002Ffile_uploads\u002F{{ record.file_upload_id }}\u002Fcomplete\n  - required fields: file_upload_id\n  - risk: medium — Notion has no provider idempotency header; keep reverse ETL in plan\u002Fpreview\u002Fapprove\u002Fexecute so each approved record is submitted exactly once.\n\n## Security\n\n- read risk: external Notion API read of workspace databases\u002Fpages\u002Fusers\n- approval: none; read-only source connector\n- Never pass secret values in chat, shell arguments, logs, docs, or JSON output.\n\n## Command Surface\n\n- Work with Notion pages, databases, data sources, blocks, comments, views and file uploads from the command line.\n- Usage: pm notion \u003Ccommand> [flags]\n- Source CLI: Notion API (https:\u002F\u002Fdevelopers.notion.com\u002Fopenapi.json)\n- Global flags:\n  - --approval-token-stdin (boolean): Read the approval token as one bounded line from standard input.\n- Databases\n- Pages\n- Users\n- Custom Emojis\n- File Uploads\n- Views\n- Async Task\n- Block\n- Comment\n- Data Source\n- Database\n- File Upload\n- Page\n- User\n- View\n- Meeting Note\n- Other Commands\n  - databases list - List Notion databases as ETL records. [intent=etl availability=implemented stream=databases]\n  - pages list - List Notion pages as ETL records. [intent=etl availability=implemented stream=pages]\n  - users list - List Notion users as ETL records. [intent=etl availability=implemented stream=users]\n  - custom-emojis list - List Notion custom emojis as ETL records. [intent=etl availability=implemented stream=custom_emojis]\n  - file-uploads list - List Notion file uploads as ETL records. [intent=etl availability=implemented stream=file_uploads]\n  - views list - List Notion views as ETL records. [intent=etl availability=implemented stream=views]\n  - async-task get - Retrieve an async task [intent=direct_read availability=implemented operation=notion.retrieve_async_task]; notes: Bounded Notion read; fixed method and path with typed request fields.; flags: --page, --page-cursor\n  - block get - Retrieve a block [intent=direct_read availability=implemented operation=notion.retrieve_block]; notes: Bounded Notion read; fixed method and path with typed request fields.; flags: --page, --page-cursor\n  - block children list - Retrieve block children [intent=direct_read availability=implemented operation=notion.retrieve_block_children]; notes: Bounded Notion read; fixed method and path with typed request fields.; flags: --page, --page-cursor\n  - comment list - List comments [intent=direct_read availability=implemented operation=notion.list_comments]; notes: Bounded Notion read; fixed method and path with typed request fields.; flags: --page, --page-cursor\n  - comment get - Retrieve a comment [intent=direct_read availability=implemented operation=notion.retrieve_comment]; notes: Bounded Notion read; fixed method and path with typed request fields.; flags: --page, --page-cursor\n  - data-source get - Retrieve a data source [intent=direct_read availability=implemented operation=notion.retrieve_data_source]; notes: Bounded Notion read; fixed method and path with typed request fields.; flags: --page, --page-cursor\n  - data-source templates list - List templates in a data source [intent=direct_read availability=implemented operation=notion.list_data_source_templates]; notes: Bounded Notion read; fixed method and path with typed request fields.; flags: --page, --page-cursor\n  - database get - Retrieve a database [intent=direct_read availability=implemented operation=notion.retrieve_database]; notes: Bounded Notion read; fixed method and path with typed request fields.; flags: --page, --page-cursor\n  - file-upload get - Retrieve a file upload [intent=direct_read availability=implemented operation=notion.retrieve_file_upload]; notes: Bounded Notion read; fixed method and path with typed request fields.; flags: --page, --page-cursor\n  - page get - Retrieve a page [intent=direct_read availability=implemented operation=notion.retrieve_page]; notes: Bounded Notion read; fixed method and path with typed request fields.; flags: --page, --page-cursor\n  - page markdown get - Retrieve a page as markdown [intent=direct_read availability=implemented operation=notion.retrieve_page_markdown]; notes: Bounded Notion read; fixed method and path with typed request fields.; flags: --page, --page-cursor\n  - page property get - Retrieve a page property item [intent=direct_read availability=implemented operation=notion.retrieve_page_property]; notes: Bounded Notion read; fixed method and path with typed request fields.; flags: --page, --page-cursor\n  - user me get - Retrieve your token's bot user [intent=direct_read availability=implemented operation=notion.retrieve_bot_user]; notes: Bounded Notion read; fixed method and path with typed request fields.; flags: --page, --page-cursor\n  - user get - Retrieve a user [intent=direct_read availability=implemented operation=notion.retrieve_user]; notes: Bounded Notion read; fixed method and path with typed request fields.; flags: --page, --page-cursor\n  - view get - Retrieve a view [intent=direct_read availability=implemented operation=notion.retrieve_view]; notes: Bounded Notion read; fixed method and path with typed request fields.; flags: --page, --page-cursor\n  - view query results get - Get view query results [intent=direct_read availability=implemented operation=notion.retrieve_view_query_results]; notes: Bounded Notion read; fixed method and path with typed request fields.; flags: --page, --page-cursor\n  - data-source query - Query a data source [intent=direct_read availability=implemented operation=notion.query_data_source]; notes: Bounded Notion read; fixed method and path with typed request fields.; flags: --page-size, --is-archived, --result-type, --page, --page-cursor\n  - meeting-note query - Query meeting notes [intent=direct_read availability=implemented operation=notion.query_meeting_notes]; notes: Bounded Notion read; fixed method and path with typed request fields.; flags: --limit, --page, --page-cursor\n  - meeting-note create - Create a meeting note [intent=reverse_etl availability=implemented write=create_meeting_note]; approval: reverse ETL mutations require plan, preview, explicit approval, and execute; destructive actions require destructive confirmation.; risk: medium — Notion has no provider idempotency header; keep reverse ETL in plan\u002Fpreview\u002Fapprove\u002Fexecute so each approved record is submitted exactly once.; flags: --language, --title\n  - block update - Update a block [intent=reverse_etl availability=implemented write=update_block]; approval: reverse ETL mutations require plan, preview, explicit approval, and execute; destructive actions require destructive confirmation.; risk: medium — Notion has no provider idempotency header; keep reverse ETL in plan\u002Fpreview\u002Fapprove\u002Fexecute so each approved record is submitted exactly once.; flags: --block-id (required), --in-trash\n  - block delete - Delete a block [intent=reverse_etl availability=implemented write=delete_block]; approval: reverse ETL mutations require plan, preview, explicit approval, and execute; destructive actions require destructive confirmation.; risk: high — Notion has no provider idempotency header; keep reverse ETL in plan\u002Fpreview\u002Fapprove\u002Fexecute so each approved record is submitted exactly once.; flags: --block-id (required)\n  - block children append - Append block children [intent=reverse_etl availability=partial write=append_block_children]; approval: reverse ETL mutations require plan, preview, explicit approval, and execute; destructive actions require destructive confirmation.; risk: medium — Notion has no provider idempotency header; keep reverse ETL in plan\u002Fpreview\u002Fapprove\u002Fexecute so each approved record is submitted exactly once.; notes: Reverse ETL from a source record is the supported path: children is an array over Notion's 31-arm block-type union; no typed scalar leaf exists for a flag contract; flags: --block-id (required)\n  - comment create - Create a comment [intent=reverse_etl availability=implemented write=create_comment]; approval: reverse ETL mutations require plan, preview, explicit approval, and execute; destructive actions require destructive confirmation.; risk: medium — Notion has no provider idempotency header; keep reverse ETL in plan\u002Fpreview\u002Fapprove\u002Fexecute so each approved record is submitted exactly once.\n  - comment update - Update a comment [intent=reverse_etl availability=partial write=update_comment]; approval: reverse ETL mutations require plan, preview, explicit approval, and execute; destructive actions require destructive confirmation.; risk: medium — Notion has no provider idempotency header; keep reverse ETL in plan\u002Fpreview\u002Fapprove\u002Fexecute so each approved record is submitted exactly once.; notes: Reverse ETL from a source record is the supported path: rich_text is an array of rich-text objects with no scalar leaf; supply it from a reverse-ETL source record; flags: --comment-id (required)\n  - comment update-markdown - Update a comment [intent=reverse_etl availability=implemented write=update_comment_markdown]; approval: reverse ETL mutations require plan, preview, explicit approval, and execute; destructive actions require destructive confirmation.; risk: medium — Notion has no provider idempotency header; keep reverse ETL in plan\u002Fpreview\u002Fapprove\u002Fexecute so each approved record is submitted exactly once.; flags: --comment-id (required), --markdown (required)\n  - comment delete - Delete a comment [intent=reverse_etl availability=implemented write=delete_comment]; approval: reverse ETL mutations require plan, preview, explicit approval, and execute; destructive actions require destructive confirmation.; risk: high — Notion has no provider idempotency header; keep reverse ETL in plan\u002Fpreview\u002Fapprove\u002Fexecute so each approved record is submitted exactly once.; flags: --comment-id (required)\n  - data-source create - Create a data source [intent=reverse_etl availability=partial write=create_data_source]; approval: reverse ETL mutations require plan, preview, explicit approval, and execute; destructive actions require destructive confirmation.; risk: medium — Notion has no provider idempotency header; keep reverse ETL in plan\u002Fpreview\u002Fapprove\u002Fexecute so each approved record is submitted exactly once.; notes: Reverse ETL from a source record is the supported path: properties is a free-form map of property definitions with no declared required scalar leaf; flags: --parent-database-id (required)\n  - data-source update - Update a data source [intent=reverse_etl availability=implemented write=update_data_source]; approval: reverse ETL mutations require plan, preview, explicit approval, and execute; destructive actions require destructive confirmation.; risk: medium — Notion has no provider idempotency header; keep reverse ETL in plan\u002Fpreview\u002Fapprove\u002Fexecute so each approved record is submitted exactly once.; flags: --data-source-id (required), --in-trash\n  - database create - Create a database [intent=reverse_etl availability=implemented write=create_database]; approval: reverse ETL mutations require plan, preview, explicit approval, and execute; destructive actions require destructive confirmation.; risk: medium — Notion has no provider idempotency header; keep reverse ETL in plan\u002Fpreview\u002Fapprove\u002Fexecute so each approved record is submitted exactly once.; flags: --is-inline, --parent (required)\n  - database update - Update a database [intent=reverse_etl availability=implemented write=update_database]; approval: reverse ETL mutations require plan, preview, explicit approval, and execute; destructive actions require destructive confirmation.; risk: medium — Notion has no provider idempotency header; keep reverse ETL in plan\u002Fpreview\u002Fapprove\u002Fexecute so each approved record is submitted exactly once.; flags: --database-id (required), --in-trash, --is-inline, --is-locked, --parent\n  - page create - Create a page [intent=reverse_etl availability=implemented write=create_page]; approval: reverse ETL mutations require plan, preview, explicit approval, and execute; destructive actions require destructive confirmation.; risk: medium — Notion has no provider idempotency header; keep reverse ETL in plan\u002Fpreview\u002Fapprove\u002Fexecute so each approved record is submitted exactly once.; flags: --allow-async, --markdown\n  - page update - Update page [intent=reverse_etl availability=implemented write=update_page]; approval: reverse ETL mutations require plan, preview, explicit approval, and execute; destructive actions require destructive confirmation.; risk: medium — Notion has no provider idempotency header; keep reverse ETL in plan\u002Fpreview\u002Fapprove\u002Fexecute so each approved record is submitted exactly once.; flags: --erase-content, --in-trash, --is-archived, --is-locked, --page-id (required)\n  - page markdown update - Update a page's content as markdown [intent=reverse_etl availability=implemented write=update_page_markdown]; approval: reverse ETL mutations require plan, preview, explicit approval, and execute; destructive actions require destructive confirmation.; risk: medium — Notion has no provider idempotency header; keep reverse ETL in plan\u002Fpreview\u002Fapprove\u002Fexecute so each approved record is submitted exactly once.; flags: --allow-async, --page-id (required)\n  - page move - Move a page [intent=reverse_etl availability=implemented write=move_page]; approval: reverse ETL mutations require plan, preview, explicit approval, and execute; destructive actions require destructive confirmation.; risk: medium — Notion has no provider idempotency header; keep reverse ETL in plan\u002Fpreview\u002Fapprove\u002Fexecute so each approved record is submitted exactly once.; flags: --page-id (required), --parent-page-id (required)\n  - page move-to-data-source - Move a page [intent=reverse_etl availability=implemented write=move_page_to_data_source]; approval: reverse ETL mutations require plan, preview, explicit approval, and execute; destructive actions require destructive confirmation.; risk: medium — Notion has no provider idempotency header; keep reverse ETL in plan\u002Fpreview\u002Fapprove\u002Fexecute so each approved record is submitted exactly once.; flags: --page-id (required), --parent-data-source-id (required)\n  - view create - Create a view [intent=reverse_etl availability=implemented write=create_view]; approval: reverse ETL mutations require plan, preview, explicit approval, and execute; destructive actions require destructive confirmation.; risk: medium — Notion has no provider idempotency header; keep reverse ETL in plan\u002Fpreview\u002Fapprove\u002Fexecute so each approved record is submitted exactly once.; flags: --data-source-id (required), --database-id, --name (required), --type (required), --view-id\n  - view update - Update a view [intent=reverse_etl availability=implemented write=update_view]; approval: reverse ETL mutations require plan, preview, explicit approval, and execute; destructive actions require destructive confirmation.; risk: medium — Notion has no provider idempotency header; keep reverse ETL in plan\u002Fpreview\u002Fapprove\u002Fexecute so each approved record is submitted exactly once.; flags: --name, --view-id (required)\n  - view delete - Delete a view [intent=reverse_etl availability=implemented write=delete_view]; approval: reverse ETL mutations require plan, preview, explicit approval, and execute; destructive actions require destructive confirmation.; risk: high — Notion has no provider idempotency header; keep reverse ETL in plan\u002Fpreview\u002Fapprove\u002Fexecute so each approved record is submitted exactly once.; flags: --view-id (required)\n  - view query create - Create a view query [intent=reverse_etl availability=implemented write=create_view_query]; approval: reverse ETL mutations require plan, preview, explicit approval, and execute; destructive actions require destructive confirmation.; risk: medium — Notion has no provider idempotency header; keep reverse ETL in plan\u002Fpreview\u002Fapprove\u002Fexecute so each approved record is submitted exactly once.; flags: --page-size, --view-id (required)\n  - view query delete - Delete a view query [intent=reverse_etl availability=implemented write=delete_view_query]; approval: reverse ETL mutations require plan, preview, explicit approval, and execute; destructive actions require destructive confirmation.; risk: high — Notion has no provider idempotency header; keep reverse ETL in plan\u002Fpreview\u002Fapprove\u002Fexecute so each approved record is submitted exactly once.; flags: --query-id (required), --view-id (required)\n  - file-upload create - Create a file upload [intent=reverse_etl availability=implemented write=create_file_upload]; approval: reverse ETL mutations require plan, preview, explicit approval, and execute; destructive actions require destructive confirmation.; risk: medium — Notion has no provider idempotency header; keep reverse ETL in plan\u002Fpreview\u002Fapprove\u002Fexecute so each approved record is submitted exactly once.; flags: --content-type, --external-url, --filename, --mode, --number-of-parts\n  - file-upload complete - Complete a multi-part file upload [intent=reverse_etl availability=implemented write=complete_file_upload]; approval: reverse ETL mutations require plan, preview, explicit approval, and execute; destructive actions require destructive confirmation.; risk: medium — Notion has no provider idempotency header; keep reverse ETL in plan\u002Fpreview\u002Fapprove\u002Fexecute so each approved record is submitted exactly once.; flags: --file-upload-id (required)\n  - file-upload send - Upload a file [intent=reverse_etl availability=planned operation=notion.send_file_upload]; approval: binary\u002Ffile uploads require plan, preview, explicit approval, and payload digest approval before execution; risk: blocked shared-runtime binary\u002Ffile transfer dependency; notes: Operation is bounded in operations.json; promotion is blocked on the shared file upload runner that binds provider paths to approved payload digests. Named dependency, not a blank disposition.\n- Help topics:\n  - safety - Reverse ETL mutations require plan, preview, explicit approval, and execute; destructive actions require destructive confirmation.\n  - pagination - Notion paginates with start_cursor\u002Fnext_cursor and has_more; ETL streams follow the cursor to exhaustion within the configured page bounds.\n\n## Commands\n\n### Inspect as a manual\n\n```bash\npm connectors inspect notion\n```\n\n### Inspect as structured JSON\n\n```bash\npm connectors inspect notion --json\n```\n\n## Agent Rules\n\n- Run pm connectors inspect notion before creating credentials or plans.\n- Use --json only when the caller needs structured output; use the manual for human-readable guidance.\n- Never ask the user to paste secret values into chat.\n- For reverse ETL writes, create a plan, show the preview, wait for explicit approval, then run with the approval token.\n",{"name":5,"description":7},"main","813f457a925f7ee3fe3bea101a43e445992c8552","docs\u002Fskills\u002Fpm-notion",0,"https:\u002F\u002Fgithub.com\u002Fpolymetrics-ai\u002Fcli","https:\u002F\u002Fcli.polymetrics.ai","https:\u002F\u002Fgithub.com\u002Fpolymetrics-ai","Local-first data infrastructure for agents and developers.","2026-09-21 12:42:03",{"source":8,"skillName":5,"commands":34,"prompt":44,"zipAvailable":45},[35,38,41],{"tool":36,"command":37},"npx","npx skills add polymetrics-ai\u002Fcli --skill pm-notion",{"tool":39,"command":40},"bunx","bunx skills add polymetrics-ai\u002Fcli --skill pm-notion",{"tool":42,"command":43},"pnpm","pnpm dlx skills add polymetrics-ai\u002Fcli --skill pm-notion","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fpolymetrics-ai\u002Fcli\u002Fblob\u002Fmain\u002Fdocs\u002Fskills\u002Fpm-notion\u002FSKILL.md",true,[],[48,55,62,69,76,83],{"skillNo":49,"name":50,"nameZh":6,"description":51,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":52,"categories":53,"keywords":54,"publishedAt":19},"01M782EH9BFHYZVECKJ31F427S","recipe-preview-approve-reverse-etl","Preview and approve a reverse ETL plan safely.","https:\u002F\u002Fgithub.com\u002Fpolymetrics-ai\u002Fcli\u002Fblob\u002Fmain\u002Fdocs\u002Fskills\u002Frecipe-preview-approve-reverse-etl\u002FSKILL.md",[],[],{"skillNo":56,"name":57,"nameZh":6,"description":58,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":59,"categories":60,"keywords":61,"publishedAt":19},"01M782EFGH5NRZ2CXDK0V9YWFW","recipe-github-prs-to-warehouse","Sync GitHub pull requests into the local warehouse.","https:\u002F\u002Fgithub.com\u002Fpolymetrics-ai\u002Fcli\u002Fblob\u002Fmain\u002Fdocs\u002Fskills\u002Frecipe-github-prs-to-warehouse\u002FSKILL.md",[],[],{"skillNo":63,"name":64,"nameZh":6,"description":65,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":66,"categories":67,"keywords":68,"publishedAt":19},"01M782ECJZRQAK8E86CE7R2YM2","pm-zoom","Zoom connector knowledge and safe action guide.","https:\u002F\u002Fgithub.com\u002Fpolymetrics-ai\u002Fcli\u002Fblob\u002Fmain\u002Fdocs\u002Fskills\u002Fpm-zoom\u002FSKILL.md",[],[],{"skillNo":70,"name":71,"nameZh":6,"description":72,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":73,"categories":74,"keywords":75,"publishedAt":19},"01M782EASYDANMV35W2ZHG2QD0","pm-zonka-feedback","Zonka Feedback connector knowledge and safe action guide.","https:\u002F\u002Fgithub.com\u002Fpolymetrics-ai\u002Fcli\u002Fblob\u002Fmain\u002Fdocs\u002Fskills\u002Fpm-zonka-feedback\u002FSKILL.md",[],[],{"skillNo":77,"name":78,"nameZh":6,"description":79,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":80,"categories":81,"keywords":82,"publishedAt":19},"01M782E8WA94A906385AET1ZWH","pm-zoho-invoice","Zoho Invoice connector knowledge and safe action guide.","https:\u002F\u002Fgithub.com\u002Fpolymetrics-ai\u002Fcli\u002Fblob\u002Fmain\u002Fdocs\u002Fskills\u002Fpm-zoho-invoice\u002FSKILL.md",[],[],{"skillNo":84,"name":85,"nameZh":6,"description":86,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":87,"categories":88,"keywords":89,"publishedAt":19},"01M782E73M7F23B6VBGM72QMMQ","pm-zoho-inventory","Zoho Inventory connector knowledge and safe action guide.","https:\u002F\u002Fgithub.com\u002Fpolymetrics-ai\u002Fcli\u002Fblob\u002Fmain\u002Fdocs\u002Fskills\u002Fpm-zoho-inventory\u002FSKILL.md",[],[]]