Notion

Enables AI agents to interact with Notion workspaces through the Model Context Protocol. Supports reading and creating pages, querying databases, managing blocks, and searching content. Access is scoped by the Notion integration permissions configured by the workspace admin.

Package

Registry	npm (stdio)
Package	`@notionhq/notion-mcp-server@2.5.1`
Integrity	`sha512-JPG38WoSxYxZMk+fLgqsibU1rhvCSbK1JSMUlw5DPyoc1LveN2cz5C1lbJFcv7mZTa/DAOP4zbfxNj4YtN/lcQ==`
Lockfile	package-lock.json `sha512-H+zvZZFuMFQw6E5JmVuB3H73v5A6dUQWQc++jZuavftexf8Ztrawkd47tMqcLT6HYY7jeWVPeMhJ7hCEv/9pyQ==`
Entry	`bin/cli.mjs`
Install scripts	none allowed

Configuration

Create a Notion integration and copy its Internal Integration Secret, then share the pages or databases it should access with the integration. — get credentials

Key	Name	Kind	Required	Secret	Format	Default / choices
`NOTION_TOKEN`	Notion Integration Token Internal integration secret of the Notion integration	env	yes	yes	string

Tools (24)

From the test run on 2026-10-23 (darwin-arm64, linux-x64, Node 24) — starts without credentials.

`API-create-a-comment`	Notion \| Create comment params: parent, rich_text
`API-create-a-data-source`	Notion \| Create a data source params: parent, properties, title
`API-delete-a-block`	Notion \| Delete a block params: block_id*
`API-get-block-children`	Notion \| Retrieve block children params: block_id*, page_size, start_cursor
`API-get-self`	Notion \| Retrieve your token's bot user
`API-get-user`	Notion \| Retrieve a user params: user_id*
`API-get-users`	Notion \| List all users params: page_size, start_cursor
`API-list-data-source-templates`	Notion \| List templates in a data source params: data_source_id*, page_size, start_cursor
`API-move-page`	Notion \| Move a page params: page_id, parent
`API-patch-block-children`	Notion \| Append block children params: after, block_id, children
`API-patch-page`	Notion \| Update page properties params: archived, cover, icon, in_trash, page_id*, properties
`API-post-page`	Notion \| Create a page params: children, cover, icon, parent, properties
`API-post-search`	Notion \| Search by title params: filter, page_size, query, sort, start_cursor
`API-query-data-source`	Notion \| Query a data source params: archived, data_source_id*, filter, filter_properties, in_trash, page_size, sorts, start_cursor
`API-retrieve-a-block`	Notion \| Retrieve a block params: block_id*
`API-retrieve-a-comment`	Notion \| Retrieve comments params: block_id*, page_size, start_cursor
`API-retrieve-a-data-source`	Notion \| Retrieve a data source params: data_source_id*
`API-retrieve-a-database`	Notion \| Retrieve a database params: database_id*
`API-retrieve-a-page`	Notion \| Retrieve a page params: filter_properties, page_id*
`API-retrieve-a-page-property`	Notion \| Retrieve a page property item params: page_id, page_size, property_id, start_cursor
`API-retrieve-page-markdown`	Notion \| Retrieve a page as Markdown params: include_transcript, page_id*
`API-update-a-block`	Notion \| Update a block params: archived, block_id*, type
`API-update-a-data-source`	Notion \| Update a data source params: data_source_id*, description, properties, title
`API-update-page-markdown`	Notion \| Update a page's content as Markdown params: insert_content, page_id, replace_content, replace_content_range, type, update_content

Security Assessment

Level	caution
Permissions	read:pages, write:pages, read:databases, write:databases, search:content
Data Exposure	content
Requires Supervisor	No
Risk Notes	Can read and write Notion pages, databases. Scoped by integration permissions.
Review	pass · official · 2026-03-16
Runtime	engines.node not declared · native modules: no · 36.7 MB installed

When to Use

Use	When the agent needs to read or modify content in Notion workspaces, pages, or databases.
Do not use	When working with other project management tools like Linear or Jira.
Input / Output	text, json → text, json

com.forgeuno/notion-mcp · v2.5.1 · Category: productivity · Free tier: Yes · Notion API is free; Notion workspace plans vary. · Source · Website