Better Notion MCP

Page lifecycle: create, get, get_property, update, move, archive, restore, duplicate. Requires parent_id for create. Returns markdown content for get.

Database operations: create, get, query, create_page, update_page, delete_page, create_data_source, update_data_source, update_database, list_templates. Accepts both database_id (from URL) and data_source_id (from workspace search) — auto-resolved. Databases contain data sources with schema and rows.

Block-level content: get, children, append, update, delete. Page IDs are valid block IDs. update only works on text blocks (paragraph, headings, lists, quote, to_do, code). Supports tables, toggles, callouts, images, equations via markdown.

User info: list, get, me, from_workspace. list requires admin permissions — if it fails, use from_workspace (extracts users from accessible pages).

Workspace: info, search. Search returns pages/databases shared with integration. Use filter.object for type.

Comments: list, get, create. Use page_id for new discussion, discussion_id for replies, comment_id for get.

Convert: markdown-to-blocks, blocks-to-markdown. Most tools handle markdown automatically.

File uploads: create, send, complete, retrieve, list. Upload files to Notion (max 20MB direct, multi-part for larger). Use base64 content for send.

Get full documentation for a tool. Use when compressed descriptions are insufficient.