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

• Finds pages and databases by title

  Searches your shared Notion content by title.

  Try: “Search Notion for "Q3 planning".”

  Network · post-search

• Reads a page's properties

  Gets a page and its properties by ID.

  Try: “Get the page for the roadmap.”

  Network · retrieve-a-page

• Reads a whole page as Markdown

  Returns the full page content as Markdown, which uses fewer tokens than block data. Can include meeting-note transcripts.

  Try: “Read my meeting notes page as Markdown.”

  Network · retrieve-page-markdown

• Edits a page using Markdown

  Replaces the whole page or makes find-and-replace edits using Markdown.

  Try: “Replace the intro of this page with a shorter summary.”

  Write · update-page-markdown

• Creates a new page

  Creates a page under a parent page or data source.

  Try: “Create a page called "Weekly notes" under Team wiki.”

  Write · post-page

• Updates page properties

  Changes properties of an existing page, such as title, status or archived.

  Try: “Set the status of this page to Done.”

  Write · patch-page

• Moves a page to a new parent

  Moves a page under a different parent page or data source.

  Try: “Move this page into the Archive section.”

  Write · move-page

• Reads one page property

  Gets a single property value from a page.

  Try: “What is the due date on this page?”

  Network · retrieve-a-page-property

• Lists the blocks inside a page

  Returns the child blocks of a page or block.

  Try: “List the blocks on this page.”

  Network · get-block-children

• Adds blocks to a page

  Appends new blocks to the end of a page or block.

  Try: “Add a to-do list to the bottom of this page.”

  Write · patch-block-children

• Reads one block

  Gets a single block by ID.

  Try: “Show me this block.”

  Network · retrieve-a-block

• Edits one block

  Changes the content of a single block.

  Try: “Fix the typo in this paragraph block.”

  Write · update-a-block

• Deletes a block

  Removes a block from a page.

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

  Delete · delete-a-block

• Searches a database with filters

  Queries a data source (database) with filters and sorts.

  Try: “Show tasks due this week sorted by priority.”

  Network · query-data-source

• Reads a database's structure

  Gets the properties and schema of a data source.

  Try: “What columns does my tasks database have?”

  Network · retrieve-a-data-source

• Reads database details

  Gets database details, including its data source IDs.

  Try: “Get the details of my projects database.”

  Network · retrieve-a-database

• Creates a new database table

  Creates a data source under a parent page.

  Try: “Create a bug tracker database on this page.”

  Write · create-a-data-source

• Changes a database's properties

  Updates the properties of a data source.

  Try: “Add a "Priority" column to my tasks database.”

  Write · update-a-data-source

• Lists a database's page templates

  Lists the templates available in a data source.

  Try: “What templates does the tasks database have?”

  Network · list-data-source-templates

• Reads comments on a page

  Gets comments from a page or block.

  Try: “Show the comments on this page.”

  Network · retrieve-a-comment

• Adds a comment

  Posts a comment on a page or in a discussion.

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

  Write · create-a-comment

• Lists people in the workspace

  Lists users in your workspace.

  Try: “Who is in my Notion workspace?”

  Network · get-users

• Looks up one person

  Gets a user by ID.

  Try: “Look up this user.”

  Network · get-user

• Shows which integration you are using

  Returns the bot user for the token.

  Try: “Which integration am I connected as?”

  Network · get-self

Watch out for

• It can delete blocks and rewrite whole pages

  Content tools can remove blocks or replace a page body. Create the integration with only "Read content" if you do not want edits.

• The token works for every page you share

  Anything shared with the integration is readable by the assistant. Share pages one at a time instead of a whole workspace.

• It cannot delete databases

  The README says the exposed API is limited so databases cannot be deleted through it.

Security advisories