# Source: https://developers.notion.com/guides/mcp/mcp-supported-tools.md

> ## Documentation Index
> Fetch the complete documentation index at: https://developers.notion.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Supported tools

> Learn what you can do with Notion MCP tools.

Now that you have installed the Notion MCP, let's explore how AI assistants can use Notion MCP tools to create, search, and manage content in your Notion workspace.

These tools work seamlessly together through prompts, and their real power comes from combining them. With a single prompt, you can search your workspace, create new pages from the results, and update properties across multiple pages. Understanding these building blocks helps you craft efficient prompts that tackle complex tasks by combining multiple tools.

## MCP tools

<AccordionGroup>
  <Accordion title="notion-search">
    Search across your Notion workspace and connected tools like Slack, Google Drive, and Jira.

    <Note>
      Requires Notion AI access. Without a Notion AI plan, search is limited to your Notion workspace only.
    </Note>

    **Example prompts:**

    * "Check Slack for how we solved this bug in the past"
    * "Search for documents mentioning 'budget approval process'"
    * "Look for meeting notes from last week with John"
    * "Find all project pages that mention 'ready for dev'"
  </Accordion>

  <Accordion title="notion-fetch">
    Retrieves content from a Notion page or database by its URL.

    **Example prompts:**

    * "What product requirements still need to be implemented from this ticket `https://notion.so/page-url`?"
  </Accordion>

  <Accordion title="notion-create-pages">
    Creates one or more Notion pages with specified properties and content. If a parent is not specified, a private page will be created.

    **Example prompts:**

    * "Create a project kickoff page under our Projects folder with agenda and team info"
    * "Make a new employee onboarding checklist in our HR database"
    * "Create a meeting notes page for today's standup with action items"
    * "Add a new product feature request to our feature database"
  </Accordion>

  <Accordion title="notion-update-page">
    Update a Notion page's properties or content.

    **Example prompts:**

    * "Change the status of this task from 'In Progress' to 'Complete'"
    * "Add a new section about risks to the project plan page"
    * "Replace the old project timeline with the updated version"
  </Accordion>

  <Accordion title="notion-move-pages">
    Move one or more Notion pages or databases to a new parent.

    **Example prompts:**

    * "Move my weekly meeting notes page to the 'Team Meetings' page"
    * "Reorganize all project documents under the 'Active Projects' section"
  </Accordion>

  <Accordion title="notion-duplicate-page">
    Duplicate a Notion page within your workspace. This action completes asynchronously.

    **Example prompts:**

    * "Duplicate my project template page so I can use it for the new Q3 initiative"
    * "Make a copy of the meeting agenda template for next week's planning session"
  </Accordion>

  <Accordion title="notion-create-database">
    Creates a new Notion database, initial data source, and initial view with the specified properties.

    **Example prompts:**

    * "Create a new database to track our customer feedback with fields for customer name, feedback type, priority, and status"
    * "Set up a content calendar database with columns for publish date, content type, and approval status"
  </Accordion>

  <Accordion title="notion-update-data-source">
    Update a Notion data source's properties, name, description, or other attributes.

    **Example prompts:**

    * "Add a status field to track project completion"
    * "Update the task database to include priority levels"
  </Accordion>

  <Accordion title="notion-query-data-sources">
    Query across multiple Notion data sources directly with structured summaries, grouping, and filters. Returns organized results with counts and rollups for quick scanning.

    <Note>
      Requires Enterprise plan with Notion AI.
    </Note>

    **Example prompts:**

    * "What's due for me this week across all tasks and meeting note action items? Group by priority."
    * "Show all risks from Engineering and Product databases this month, grouped by owner."
  </Accordion>

  <Accordion title="notion-query-database-view">
    Query data from a Notion database using a pre-defined [view's filters and sorts](https://www.notion.com/help/views-filters-and-sorts).

    <Note>
      Requires Business plan or higher with Notion AI. Only available when the `notion-query-data-sources` tool is not available.
    </Note>

    **Example prompts:**

    * "Query my 'In Progress' tasks view to see what I'm currently working on"
    * "Get all items from the 'High Priority' view in our feature requests database"
    * "Export the filtered data from the 'Q1 Goals' view for analysis"
  </Accordion>

  <Accordion title="notion-create-comment">
    Add a comment to a page.

    <Warning>
      Block-level comments and discussions within a page are not yet supported.
    </Warning>

    **Example prompts:**

    * "Add a feedback comment to this design proposal"
    * "Leave a note on the quarterly review page about budget concerns"
    * "Comment on the meeting notes to clarify the action item deadlines"
  </Accordion>

  <Accordion title="notion-get-comments">
    Lists all comments on a specific page, including threaded discussions.

    **Example prompts:**

    * "List comments on the project requirements section"
    * "Get all feedback comments from last week's review"
  </Accordion>

  <Accordion title="notion-get-teams">
    Retrieves a list of teams (teamspaces) in the current workspace.

    **Example prompts:**

    * "Search for teams by name, and your membership status in each team"
    * "Get a team's ID to use as a filter for a search"
  </Accordion>

  <Accordion title="notion-get-users">
    Lists all users in the workspace with their details.

    **Example prompts:**

    * "Get contact details for the user who created this page"
    * "Look up the profile of the person assigned to this task"
  </Accordion>

  <Accordion title="notion-get-user">
    Retrieve your user information by ID.

    **Example prompts:**

    * "What's my email address?"
    * "What's my Notion user ID?"
  </Accordion>

  <Accordion title="notion-get-self">
    Retrieves information about your own bot user and the Notion workspace you're connected to.

    **Example prompts:**

    * "Which Notion workspace am I currently connected to?"
    * "What's my file size upload limit for the current workspace?"
  </Accordion>
</AccordionGroup>

<Info>
  **Tool names may vary for OpenAI**

  When connecting with an OpenAI MCP client (e.g. ChatGPT), the `notion-` prefix is automatically omitted from the `notion-fetch` and `notion-search` tools, making them appear as `fetch` and `search`, respectively. This is because these specific tool names are required as part of the [Deep Research specification](https://platform.openai.com/docs/guides/deep-research#remote-mcp-servers) for remote MCP servers.
</Info>

## Rate limits

Standard [API request limits](/reference/request-limits) apply per user's usage of Notion MCP (totaled across all tool calls). Currently, this is an average of **180 requests per minute** (3 requests per second).

Some MCP tools have additional, tool-specific rate limits that are stricter. These are subject to change over time, but the current values are listed below for reference:

* **Search**: 30 requests per minute

### Examples

To illustrate the above limitations, you'll experience rate limit errors in your MCP client of choice in any of the following example scenarios (assuming we take the average rate over a large enough time window):

* 35 searches per minute (exceeds search-specific limit)
* 12 searches & 170 fetches per minute (exceeds general 180 requests/min limit)
* 185 fetches per minute (exceeds general 180 requests/min limit)

### What to do if you're rate-limited

In most cases, the time it takes to do a complex AI-powered search across Notion and your connected tools means that sequential searches will typically stay under the rate limit. In general, if you encounter rate limit errors, prompt your LLM tool to reduce the amount of parallel searches or operations performed using Notion MCP, and/or try again later.