Connect Claude to Notion

Search Notion and any connected sources (Slack, Drive, GitHub, Jira, Linear) and return ranked results to read. Start here when you do not already have a page id, then call notion-fetch on the ids you want in full. Set query_type to "user" to look people up by name or email.

Retrieve a Notion page, database, or data source in full by id or URL. Pages come back as Notion-flavored Markdown; databases list their data sources with collection:// ids you need for querying. Pass the id "self" to identify the connected workspace and user.

Query database rows with read-only SQLite against one or more data sources. Call notion-fetch on the database first to get its collection:// URLs and schema, then use those URLs as table names. Use parameters rather than string interpolation; checkboxes compare against "__YES__" and "__NO__".

Return the rows of a database view with its own filters and sorts already applied. Use this when the workspace already has the view you want; use notion-query-data-sources when you need custom SQL or aggregation.

Read the discussions on a page, with their full comment text. Returns page-level threads by default; set include_all_blocks for inline comments and include_resolved to see closed ones.

List the teamspaces in this workspace with their ids, names, and whether the connected user is a member. Use it to get the teamspace_id that narrows notion-search.

List or search workspace members and guests, returning their ids, names, and emails. Use it to resolve a person's name to the user id that People properties and user mentions need. Pass user_id "self" for the connected user.

Poll a background task started by notion-create-pages, notion-update-page, or another tool called with allow_async. Status is queued, running, retrying, succeeded, or failed; the result or error arrives once it finishes. Wait a few seconds between polls.

Create one or more Notion pages under a shared parent. When the parent is a database, call notion-fetch on it first to learn its schema and exact property names. Content is Notion-flavored Markdown and must not repeat the title.

Update one page's properties or content. Pick the narrowest command: update_properties for fields, update_content for search-and-replace edits, insert_content to prepend or append, replace_content only to rewrite the whole page. Fetch the page first so old_str matches exactly.

Move up to 100 pages or databases under a new parent. Use it to file loose pages into a teamspace page or a database. Data sources under a database cannot be moved on their own.

Duplicate a page inside the same workspace. The copy is created asynchronously, so the returned id may not be populated immediately - re-read it with notion-fetch if you need its contents.

Create a database from a SQL-style CREATE TABLE schema, or from one of Notion's canonical types (tasks, projects, skills). Returns the new data source id needed by notion-query-data-sources and notion-update-data-source. Provide exactly one of schema or database_type.

Change a data source's schema, title, or description with SQL DDL. Supports ADD COLUMN, DROP COLUMN, RENAME COLUMN, and ALTER COLUMN SET. DROP COLUMN removes a property and its values, and in_trash moves the whole data source to the trash - use both deliberately.

Add a view to a database, or embed a linked view of it on another page. Supply database_id to add a tab, or parent_page_id to append an inline linked view. Filters, sorts, and grouping come from the configure DSL.

Rename a view or change its filters, sorts, grouping, and visible properties. Only send the fields you want to change; CLEAR FILTER, CLEAR SORT, and CLEAR GROUP BY remove existing settings.

Add a comment to a page, to a specific passage on it, or as a reply in an existing thread. Pass page_id alone for a page-level comment, add selection_with_ellipsis to anchor it to content, or pass discussion_id to reply.