Suekou Notion MCP Server: Setup for Claude, Cursor and Other Apps

• Finds pages or databases by name

  Looks up pages or data sources from a title or part of one and returns short candidates with their IDs and which tool to use next. It trims noisy fields, so it is the best first step.

  Try: “Find my 'Q4 roadmap' page.”

  Network · notion_find

• Searches page and data source titles

  Searches your shared Notion content by title and returns the raw Notion results. Use notion_find first for tidier output.

  Try: “Search Notion for 'onboarding'.”

  Network · notion_search

• Reads a page with stable block IDs

  Returns a page's content in compact form with block IDs you can use for later edits.

  Try: “Read the Meeting Notes page.”

  Network · notion_read_page

• Gets a page's properties

  Fetches one page's raw record from Notion, including its properties.

  Try: “Show the properties of this page.”

  Network · notion_retrieve_page

• Changes properties on a page or database item

  Writes new values for a page's or database item's properties, such as status or date. Takes raw Notion property values.

  Try: “Set the status of that task to Done.”

  Write · notion_update_page_properties

• Gets one block

  Fetches a single block, such as a paragraph or heading, by its ID.

  Try: “Get block 1a2b3c.”

  Network · notion_retrieve_block

• Lists the blocks inside a block or page

  Returns the child blocks of a page or block, with paging.

  Try: “List the blocks on this page.”

  Network · notion_retrieve_block_children

• Adds raw blocks to a page

  Adds Notion block objects at the end of a page or block, or at a chosen spot. Needs Notion's block format, so the simple content tools are easier.

  Try: “Append a heading and a code block to this page.”

  Write · notion_append_block_children

• Replaces a block's content

  Overwrites the value of a block based on its type. The update replaces the whole field, not just a part.

  Try: “Replace the text of this callout.”

  Write · notion_update_block

• Deletes a block

  Removes a block from Notion. The tool is marked destructive in its annotations.

  Try: “Delete the last paragraph of this page.”

  Delete · notion_delete_block

• Adds simple text blocks to a page

  Adds paragraphs, headings, lists, to-dos, quotes, callouts, code blocks or dividers without raw block JSON.

  Try: “Add a to-do list of launch tasks to this page.”

  Write · notion_append_content

• Adds Markdown to a page

  Turns a safe subset of Markdown into Notion blocks and adds them to a page or block. Headings, lists, to-dos, quotes, dividers and code fences work.

  Try: “Append these meeting notes in Markdown to the page.”

  Write · notion_append_markdown

• Edits the text of one existing block

  Replaces the text or simple fields of one paragraph, heading, list item, to-do, quote, callout or code block. The type must match the block.

  Try: “Change that heading to 'Launch plan'.”

  Write · notion_update_content

• Edits several blocks at once

  Checks every target block and its type before changing anything, then updates several simple blocks in one call.

  Try: “Fix the typos in these three paragraphs.”

  Write · notion_update_content_batch

• Creates a new database

  Creates a database with its first data source and the properties you describe.

  Try: “Create a Bugs database with Status and Owner columns.”

  Write · notion_create_database

• Adds a data source to a database

  Adds another data source to an existing database. Do not use it to make a new database.

  Try: “Add a second data source to the Projects database.”

  Write · notion_create_data_source

• Gets a database

  Fetches a database record, including its data sources.

  Try: “Show the Projects database.”

  Network · notion_retrieve_database

• Gets a data source

  Fetches one data source with its schema.

  Try: “Show the schema of the Tasks data source.”

  Network · notion_retrieve_data_source

• Summarizes a data source's columns

  Returns a compact view of the property names, types and options so queries and new items use the right names.

  Try: “What columns does the Tasks table have?”

  Network · notion_inspect_data_source

• Changes a data source's title or columns

  Updates a data source's title, description or property schema. It takes raw Notion property definitions, so it can change or drop columns.

  Try: “Rename the Tasks data source to Sprint Tasks.”

  Delete · notion_update_data_source

• Queries a data source with raw filters

  Runs a Notion filter and sort you write in Notion's own format against a data source.

  Try: “Query the Tasks source for items due this week.”

  Network · notion_query_data_source

• Queries a data source with simple conditions

  Takes plain conditions such as Status equals Done, checks the property names and option values against the schema, and builds the Notion filter for you.

  Try: “List Tasks where Status is In Progress.”

  Network · notion_query_data_source_by_values

• Creates a database item from raw properties

  Adds a new row to a data source using raw Notion property values.

  Try: “Add a row to Tasks.”

  Write · notion_create_data_source_item

• Creates a database item from simple values

  Adds a new row using plain values that the server checks against the schema first.

  Try: “Add a task 'Write docs' with Status Todo.”

  Write · notion_create_data_source_item_from_values

• Posts a comment

  Adds a comment to a page or replies in an existing discussion. Needs the integration's insert-comment capability.

  Try: “Comment 'Looks good' on this page.”

  Write · notion_create_comment

• Reads comments on a page or block

  Returns the open comments on a page or block.

  Try: “Show comments on the roadmap page.”

  Network · notion_retrieve_comments

• Lists workspace users

  Lists the users in your workspace, which needs the user-information capability.

  Try: “Who is in the workspace?”

  Network · notion_list_all_users

• Gets one user

  Fetches a single user by ID.

  Try: “Look up user 1234.”

  Network · notion_retrieve_user

• Gets the integration's own bot user

  Returns the bot user that your integration token belongs to, which shows which workspace you reached.

  Try: “Which Notion bot am I connected as?”

  Network · notion_retrieve_bot_user

• Opens the Data Source Explorer panel

  Shows an interactive panel in clients that support MCP Apps for inspecting a data source, building filters, running queries and creating items.

  Try: “Open the explorer for the Tasks database.”

  Write · notion_open_data_source_app

• Opens the Page Workbench panel

  Shows an interactive panel in clients that support MCP Apps for reading a page, picking blocks, updating simple blocks and appending Markdown.

  Try: “Open the workbench for this page.”

  Write · notion_open_page_workbench

Watch out for

• It can delete blocks

  notion_delete_block removes blocks, and it is on unless you use the tool allowlist. Leave out the delete and update tools if you only need reading. github.com

• It can rewrite pages and database columns

  The update tools overwrite block content, page properties and data source columns, including raw property definitions. Review what the assistant plans to change before approving. github.com

• The token reaches everything you share with it

  A Notion connection on a page also covers that page's children. Share only the pages and databases the assistant needs, and turn off capabilities you do not use in the integration settings. github.com

• The token sits in a config file

  The integration token is stored as plain text in your app's MCP config. Do not commit that file. github.com

• The allowlist is opt-in

  With no --enabledTools option, all 31 tools are registered. github.com

Security advisories