Skip to main content

Notion

15 tools covering search, page/database CRUD, block content, comments, and workspace users — implemented in tools/notionOps.js.

Setup

  1. Create an integration at notion.so/my-integrations
  2. Copy its Internal Integration Secret into .env as NOTION_API_KEY
  3. Open the page or database you want Claude to access in Notion, click ...Connections, and add your integration

That last step is required for every page/database individually — Notion's API only exposes content that's been explicitly shared with the integration, even with a valid token.

Tools

ToolRiskWhat it does
notion_searchREADSearch pages and databases across the workspace
notion_get_pageREADGet a page's properties and metadata
notion_create_pageHIGHCreate a page under a parent page or database
notion_update_pageHIGHUpdate properties, or archive/restore a page
notion_get_databaseREADGet a database's schema
notion_query_databaseREADQuery rows with filter/sort
notion_create_databaseHIGHCreate a database under a parent page
notion_append_block_childrenHIGHAdd content blocks to a page or block
notion_get_block_childrenREADRead a page's/block's child blocks
notion_update_blockHIGHEdit an existing block's content
notion_delete_blockHIGHArchive a block
notion_get_commentsREADRead comments on a page or block
notion_add_commentHIGHAdd a comment or reply
notion_list_usersREADList all workspace users
notion_get_userREADGet a single user's info

Example

"Search my Notion workspace for a page about the Q3 roadmap, and add a comment
summarizing what we just shipped."

Claude calls notion_searchnotion_add_comment (with confirm: true), using the real page ID from the search result.