Notion MCP, Notion's hosted MCP server

• Searches your Notion pages and databases, or finds a teammate by name or email

  Keyword search over Notion pages and databases, or a lookup of a workspace member by name or email. Returns up to 50 results. Filters by editor, last-edited date, several teamspaces or title-only need Business or Enterprise; on other plans they are dropped with a notice.

  Try: “Search for documents mentioning 'budget approval process'”

  Read · notion-search

• Opens a page or database and reads everything in it

  Reads one page, database, data source or saved view by URL or ID and returns its content and schema. It can also open a connected-source result, such as a Slack thread, through your own connection to that source.

  Try: “What product requirements still need to be implemented from this ticket https://notion.so/your-page?”

  Read · notion-fetch

• Creates new pages with text and properties, optionally from a template

  Creates one or more pages with properties and Markdown content, optionally from a database template. With no parent it makes a private page. Can also create pages at the top of a teamspace.

  Try: “Create a project kickoff page under our Projects folder with agenda and team info”

  Write · notion-create-pages

• Edits a page's text, properties, icon or cover

  Changes a page's properties, content, icon or cover. Content edits are search-and-replace; parts that do not match are skipped and reported as warnings.

  Try: “Change the status of this task from 'In Progress' to 'Complete'”

  Write · notion-update-page

• Lists the pages you looked at most recently

  Lists pages you recently viewed, ranked by recency and visit frequency, from your top 1,000. It tracks views, not edits.

  Try: “Open the page I was looking at this morning”

  Read · notion-list-recent-pages

• Lists your favorite pages

  Lists your favorite pages in sidebar order.

  Try: “List my favorite pages”

  Read · notion-list-favorite-pages

• Lists the pages in your Private sidebar

  Lists the top-level pages and databases in your Private sidebar section, up to 200 per call.

  Try: “What's in my Private section?”

  Read · notion-list-private-pages

• Lists the pages in your Shared sidebar

  Lists the pages and databases in your Shared sidebar section.

  Try: “What pages are in my Shared section?”

  Read · notion-list-shared-pages

• Reads rows from a database, with filters, sorting or a saved view

  Reads rows from a database: run a saved view, read rows with filters and sorts (up to 100), or run SQL. Views work on every plan. SQL is unlimited on Business or Enterprise with Notion AI and metered on other plans.

  Try: “What's due for me this week across all tasks and meeting note action items? Group by priority.”

  Read · notion-query-data-sources

• Compares or totals data across several databases at once

  Runs one read-only SQL query across 2 to 100 databases, for joins, totals and side-by-side comparisons.

  Try: “Join the Projects and Tasks data sources and count open tasks per project”

  Read · notion-query-multiple-data-sources

• Creates a new database with the columns you describe

  Creates a new database with the columns you describe, plus its first view.

  Try: “Create a database to track customer feedback with customer name, feedback type, priority and status”

  Write · notion-create-database

• Changes a database's columns, name or description

  Changes a database's columns, name or description.

  Try: “Add a status field to track project completion”

  Write · notion-update-data-source

• Adds a table, board, calendar or other view to a database

  Adds a view to a database: table, board, list, calendar, timeline, gallery, form, chart, map or dashboard, with filters, sorts and grouping.

  Try: “Create a board view grouped by Status in my tasks database”

  Write · notion-create-view

• Changes a database view's filters, sorting or layout

  Renames a view or changes its filters, sorts, grouping or display settings.

  Try: “Rename the 'All Tasks' view to 'Sprint Board'”

  Write · notion-update-view

• Reads all comments and discussions on a page

  Lists all comments and discussions on a page, including resolved threads and pending suggested edits.

  Try: “Show me the comments on the Requirements section”

  Read · notion-get-comments

• Adds a comment to a page or replies in a discussion

  Adds a comment to a page or a specific passage, or replies in an existing discussion.

  Try: “Add a feedback comment to this design proposal”

  Write · notion-create-comment

• Edits a comment you wrote (Business or Enterprise)

  Replaces the text of a comment you wrote. Business or Enterprise.

  Try: “Fix the typo in my last comment on this page”

  Write · notion-update-comment

• Deletes a comment you wrote (Business or Enterprise)

  Deletes a comment you wrote, and its discussion if it was the last comment. Business or Enterprise.

  Try: “Delete my last comment on this page”

  Delete · notion-delete-comment

• Resolves or reopens a discussion (Business or Enterprise)

  Resolves or reopens a discussion. Business or Enterprise.

  Try: “Resolve the discussion about the launch date”

  Write · notion-set-discussion-resolved

• Adds or removes your emoji reaction on a comment (Business or Enterprise)

  Adds or removes your emoji reaction on a comment. Business or Enterprise.

  Try: “React with a thumbs-up to Ada's comment”

  Write · notion-set-comment-reaction

• Suggests a change that a person accepts or rejects (Business or Enterprise)

  Proposes a change that a person accepts or rejects in Notion; the page does not change until then. Business or Enterprise.

  Try: “Suggest a clearer opening paragraph for this proposal”

  Write · notion-create-suggested-edit

• Shows a pending suggestion as before and after (Business or Enterprise)

  Shows a pending suggestion as a before-and-after diff. Business or Enterprise.

  Try: “Show me the pending suggestion on the FAQ”

  Read · notion-get-suggested-edit

• Accepts or rejects a pending suggestion (Business or Enterprise)

  Accepts (applies) or rejects a pending suggestion. Marked destructive, so clients that honor tool hints ask first. Business or Enterprise.

  Try: “Accept the pending suggestion on the FAQ”

  Write · notion-resolve-suggested-edit

• Moves pages or databases to a new spot

  Moves pages or databases under a new parent.

  Try: “Move my weekly meeting notes page to the 'Team Meetings' page”

  Write · notion-move-pages

• Makes a copy of a page

  Copies a page within the workspace. Runs in the background; check it with notion-get-async-task.

  Try: “Duplicate my project template page so I can use it for the new Q3 initiative”

  Write · notion-duplicate-page

• Moves up to 20 pages to Trash (you can restore them)

  Moves up to 20 pages, including database rows, to Trash. Locked pages are refused. Undo with notion-restore-pages.

  Try: “Move these three duplicate rows to Trash”

  Delete · notion-delete-pages

• Brings pages or databases back from Trash

  Brings up to 20 pages or databases back from Trash to where they were.

  Try: “Restore the 'Q3 offsite draft' page I just deleted”

  Write · notion-restore-pages

• Moves databases and all their rows to Trash

  Moves up to 20 databases and all their rows to Trash. Linked views cannot be deleted this way.

  Try: “Move the 'Q2 leads' database to Trash”

  Delete · notion-delete-databases

• Attaches text or a file from a link to a page or comment

  Creates an attachment from inline text, a public HTTPS file URL or a finished upload, ready to place on a page or comment.

  Try: “Attach the PDF at this direct download URL to my meeting notes”

  Write · notion-create-attachment

• Creates an empty folder under a page

  Creates an empty folder under a page.

  Try: “Create a folder named 'Project files' under this page”

  Write · notion-create-folder

• Adds or removes files in a folder, or adds a subfolder

  Adds files to a folder, removes files, or adds a subfolder. One change per call.

  Try: “Add the report I just uploaded to the 'Project files' folder”

  Write · notion-update-folder

• Finds your meeting notes (Business or higher with Notion AI)

  Finds your own meeting notes, filtered by things like a title keyword. Needs Business or higher with Notion AI; other plans get an upgrade prompt.

  Try: “What were the action items from my sprint planning meetings?”

  Read · notion-query-meeting-notes

• Searches apps linked to Notion AI, like Slack, Google Drive or Jira

  Searches the sources connected to Notion AI, such as Slack, Google Drive, GitHub, Jira, mail and calendar. It does not search Notion itself. Listed only when you have Notion AI search on Business or Enterprise and the workspace has a connected source.

  Try: “Find discussions about this launch in my connected Slack and Mail”

  Read · notion-connector-search

• Lists the pages that link to or mention a page

  Lists the pages that link to or mention a given page or database. Returns titles and URLs only, never content.

  Try: “Which pages link to our launch plan?”

  Read · notion-list-page-backlinks

• Shows what changed on a page and who changed it

  Lists what changed on a page or database between two times and who changed it, including edits by Notion AI, agents and MCP clients. Defaults to the last 24 hours.

  Try: “What changed on this page since yesterday?”

  Read · notion-get-version-changes

• Shows how a page looked at an earlier time

  Shows a page or database as it was at a past time. Needs edit access and only reaches back as far as your plan keeps version history.

  Try: “Show me what our launch plan looked like last Monday”

  Read · notion-view-version

• Lists the people in your workspace, or finds one by name or email

  Lists workspace members and guests with IDs, names, emails when available and type. Can search by name or email.

  Try: “Look up the profile of the person assigned to this task”

  Read · notion-get-users

• Lists your workspace's teamspaces and which ones you belong to

  Lists the teamspaces in the workspace and your membership in each.

  Try: “Get a team's ID to use as a filter for a search”

  Read · notion-get-teams

• Lists the permission groups you can see

  Lists permission groups you can see, up to 25, and resolves a group ID from a People property to its name.

  Try: “Which group is set in the Owner property of this page?”

  Read · notion-get-groups

• Lists your calendar events for a time range

  Lists your events across connected calendars in a time range.

  Try: “What's on my calendar tomorrow?”

  Read · notion-calendar-list-events

• Adds events to your calendar (attendees may be notified)

  Creates events on calendars you can write to. Attendees may be notified.

  Try: “Create a 30-minute project review on my work calendar this Friday at 10 AM.”

  Write · notion-calendar-create-events

• Changes an event's time, guests, rooms or your RSVP

  Changes an event's time, attendees, recurrence, rooms or your RSVP. Attendees may be notified.

  Try: “Move my project review from 10 AM to 11 AM this Friday.”

  Write · notion-calendar-update-events

• Cancels events you manage (attendees may be notified)

  Cancels events you can manage. Attendees may be notified.

  Try: “Cancel the project review I organized for this Friday.”

  Delete · notion-calendar-cancel-events

• Shows your coworkers' calendar events for a time range

  Reads coworkers' events in your organization for a time range.

  Try: “Show Casey's calendar for tomorrow.”

  Read · notion-calendar-list-coworkers-events

• Finds free meeting rooms (needs Google Workspace admin rights)

  Finds free rooms or other bookable resources. Needs a Google Workspace account with admin rights to view resources.

  Try: “Which meeting rooms are available tomorrow at 2 PM for 30 minutes?”

  Read · notion-calendar-list-calendar-resources

• Finds contacts in your connected calendar accounts

  Finds contacts by name or email in your connected calendar accounts.

  Try: “Find Casey's email address in my Calendar contacts.”

  Read · notion-calendar-list-contacts

• Lists your connected calendars

  Lists your connected calendars by account. Calendar tools work on every plan through user-authorized connections.

  Try: “Which calendars are connected to my account?”

  Read · notion-calendar-list-calendars

• Turns a page into a reusable instruction set for AI

  Marks an existing page as a Notion Skill (reusable instructions for AI) without changing its content.

  Try: “Make our engineering guidelines page available as an AI skill”

  Write · notion-convert-page-to-skill

• Downloads a Notion Skill to use with a local AI agent

  Downloads a Notion Skill with its SKILL.md and supporting files for use in a local agent. The download link lasts one hour.

  Try: “Download this Skill and its supporting files for my local agent”

  Read · notion-download-skill

• Imports a skill folder from your computer into Notion

  Imports a local Agent Skills folder (tar.gz, up to 20 MiB) into a page in a Skills database, replacing that page's content. It never runs the skill.

  Try: “Upload my local release-notes skill to this Notion Skill page”

  Write · notion-upload-skill

• Lists the Notion Skills you have turned on

  Lists the Notion Skills you have turned on for MCP clients, up to 30. OAuth connections only.

  Try: “Which Notion Skills have I enabled for you?”

  Read · notion-get-enabled-skills

• Turns Notion Skills on or off for your account

  Turns Skills on or off for MCP clients, Notion AI or both, for your account only. OAuth connections only.

  Try: “Turn on the 'Weekly report' Skill for MCP clients only”

  Write · notion-update-enabled-skills

• Finds one of your Notion custom agents by name

  Finds a Notion Custom Agent by name or description and returns the link needed to start a session with it.

  Try: “Ask our Support Agent to summarize this customer issue”

  Read · notion-search-agents

• Starts a task with one of your Notion custom agents

  Starts a new session with a Custom Agent.

  Try: “Ask our Support Agent to summarize this customer issue”

  Write · notion-spawn-session

• Sends a follow-up message to a running Notion agent

  Sends a follow-up message to a Custom Agent session.

  Try: “Tell the Support Agent to include the order number”

  Write · notion-send-message-to-session

• Stops a running Notion agent

  Stops a running Custom Agent session.

  Try: “Stop the agent run I just started”

  Write · notion-stop-session

• Lists your Notion agent sessions

  Lists Custom Agent sessions, page by page.

  Try: “List my recent sessions with the Support Agent”

  Read · notion-query-sessions

• Searches your Notion agent sessions by text

  Searches Custom Agent sessions by text, up to 20 matches.

  Try: “Find the agent session where we discussed the refund policy”

  Read · notion-search-sessions

• Lists what happened during a Notion agent session

  Lists the events in a Custom Agent session.

  Try: “Show the steps the agent took in that session”

  Read · notion-list-session-events

• Reads one step from a Notion agent session

  Reads one event from a Custom Agent session.

  Try: “Show me the agent's final answer from that session”

  Read · notion-read-session-event

• Searches what your agents remembered from earlier chats, like your preferences

  Searches memories your connected agents saved in earlier sessions, such as preferences, corrections and decisions. Returns up to 50 matches.

  Try: “Check my memories for the decision on the launch date”

  Read · notion-memory-search

• Used by the assistant behind the scenes

  Gets a link to upload a file from your computer, up to 20 MiB

  Gives the client a short-lived URL to upload one local file, up to 20 MiB, which can then be placed on a page or in a comment.

  Try: “Upload diagram.png and add it to the project plan”

  Write · notion-create-file-upload

• Turns files found on a page into download links

  Turns up to 25 file references from fetched page text into signed download links.

  Try: “Get links to every file on this page”

  Read · notion-get-file-download-urls

• Reads the text of an attachment this connection created

  Returns the full text of a text attachment (HTML, Markdown, CSV, JSON and similar) that this same connection created.

  Try: “Read the contents of this Markdown attachment”

  Read · notion-download-attachment

• Checks whether a Notion agent is still working

  Checks whether a Custom Agent session is still running.

  Try: “Is the Support Agent still working on that?”

  Read · notion-get-session-status

• Waits for a Notion agent to finish

  Waits for a Custom Agent session to finish.

  Try: “Wait for the agent session to finish, then show me its answer”

  Read · notion-wait-session

• Checks on a long job like a copy and gets the result

  Checks the status of a long write started by another tool, such as a duplicate or a large page create, and returns the result when done.

  Try: “Check whether the page I just duplicated is ready”

  Read · notion-get-async-task

• Checks which workspace and account it is connected to

  Returns the workspace and user behind the current connection.

  Try: “Which Notion workspace and user are connected?”

  Read · notion-get-self

• Checks which features your Notion plan allows

  Reports which tools and parameters your workspace's plan allows and where to upgrade. Optional: other tools enforce their own limits.

  Try: “Which Notion tools can I use on this workspace's plan?”

  Read · notion-get-tool-access

Watch out for

• It can see and change everything you can

  You can't limit it to certain pages or to read-only. Our suggestion: turn on the setting in your AI app that asks you before it makes changes. notion.com

• Hidden text in a page can trick your assistant

  Notion warns that instructions hidden in a page could make the assistant leak data or edit pages. Check each change before you approve it. developers.notion.com

• It can pull in your Slack, Drive and email content

  On Business or Enterprise with Notion AI, it can send full Slack threads, Drive files and emails to your AI app. It only sees what your own connection to each of those apps can see. developers.notion.com

• Deleted pages go to Trash and can be restored

  It moves up to 20 items at a time to Trash, and the assistant can bring them back. Locked pages are refused, so a locked page cannot be deleted this way. developers.notion.com

• Guests can't connect, only workspace members

  Only workspace members can sign in. Notion blocks the sign-in for guests. developers.notion.com

• Admin controls depend on your plan

  Workspace owners manage connected AI apps under Settings, Notion MCP, and organization owners can list and revoke members' connections through the Admin API. Limiting members to an approved list of AI apps needs Enterprise. developers.notion.com

• Only use Notion's official address

  Notion's official address is mcp.notion.com. Check it before adding Notion from a third-party app store or list. developers.notion.com

Security advisories

In their words