Notion MCP integration for AI agents.
Give AI agents structured access to search Notion, read pages and blocks, create pages, and update authorized workspace knowledge.
- ACTION CONTRACTS
- 25
- AUTHENTICATION
- OAuth 2.0 + API key
- SOURCE STATUS
- Provider-backed
CATALOG SOURCE REVIEWED AUGUST 23, 2026 / ACTION NAMES AND SCHEMAS DERIVED FROM WORKING MACHINES PROVIDER SOURCE
CAPABILITY PROFILE
What the Notion integration exposes
The Notion Agent App supports knowledge retrieval and publishing against pages shared with the connected integration. An agent can search the authorized workspace, retrieve a page or its Markdown representation, append blocks, or create and update pages using explicit contracts.
Search visibility follows the Notion connection, but retrieved pages may still contain internal or personal information. Publishing workflows should choose a specific parent page or data source, preserve existing properties, and verify the resulting page URL.
VERIFIED ACTION SAMPLE
Real Notion capabilities.
Showing 12 of 25 actions. Risk labels are conservative signals based on operation names, not substitutes for provider documentation or runtime policy.
get_pageREADGet a Notion page together with its first-level child blocks. This is an aggregate helper over page retrieval plus block-children listing.
INPUTS: pageId
create_data_sourceWRITECreate a Notion data source under a parent database.
INPUTS: parent / properties / title / icon
delete_blockHIGH IMPACTArchive a Notion block through the official delete endpoint.
INPUTS: blockId
append_blockREVIEWAppend a single paragraph block to a Notion page.
INPUTS: pageId / text
append_block_childrenREVIEWAppend raw Notion child blocks to an existing parent block.
INPUTS: blockId / children / position
create_databaseWRITECreate a Notion database container under a parent page or workspace.
INPUTS: parent / title / description / is_inline / initial_data_source
create_pageWRITECreate a Notion page under a parent page, data source, or workspace-level private area.
INPUTS: parent / parentId / title / properties / children
list_block_childrenREADList the direct child blocks under a Notion block with pagination.
INPUTS: blockId / pageSize / startCursor
list_data_source_templatesREADList templates available on a Notion data source.
INPUTS: dataSourceId / pageSize / startCursor
list_usersREADList users in the Notion workspace with pagination.
INPUTS: pageSize / startCursor
move_pageWRITEMove a Notion page under another page or data source.
INPUTS: pageId / parent
query_data_sourceREADQuery a Notion data source with filters, sorts, pagination, and optional property filtering.
INPUTS: dataSourceId / filter / sorts / pageSize / startCursor
INPUT CONTRACTS
Know what the action needs before it runs.
get_page
pageIdREQUIRED- The page ID to retrieve.
create_data_source
parentREQUIRED- The official Notion parent object.
propertiesREQUIRED- Notion properties keyed by property name.
titleOPTIONAL- Data source title rich text objects.
iconOPTIONAL- A Notion API object.
delete_block
blockIdREQUIRED- The block ID to delete.
append_block
pageIdREQUIRED- The page ID to append to.
textREQUIRED- Paragraph text content.
PROVIDER-SPECIFIC WORKFLOWS
Jobs this Agent App can support
Engineering brief
Combine verified issue and repository context into a new Notion page under the approved project space.
Meeting follow-through
Retrieve the source notes, extract decisions, and append a reviewed action summary.
Knowledge refresh
Find a named page, compare it with current system data, and propose targeted edits rather than replacing it wholesale.
SAFETY BOUNDARY
Operate Notion with explicit limits
- Use a connection shared only with the required pages.
- Resolve and confirm the parent before creating content.
- Avoid replacing full pages when a targeted update is sufficient.
- Verify the returned page ID and URL after publication.
CONNECTION MODEL
OAuth 2.0 + API key
Notion internal integration secret used with the Authorization Bearer header. Create an internal integration from the Notion integrations dashboard, then share target pages or databases with it.
Working Machines stores provider credentials behind the execution boundary. An agent can use an authorized connection identity, but catalog discovery alone does not reveal OAuth tokens, API keys, or provider secrets.
- READ SIGNALS
- 13
- WRITE SIGNALS
- 9
- HIGH IMPACT
- 1
- REVIEW SIGNALS
- 2
EVIDENCE AND AVAILABILITY
Provider reference
Action names, input fields, authentication types, and counts on this page are generated from the Working Machines provider catalog. Provider behavior, quotas, object semantics, account eligibility, and regional availability remain governed by Notion.