Skip to main content
Notion is an all-in-one workspace for notes, databases, and collaboration. The Notion MCP server lets you search, create, update, and query pages and databases using natural language.

​
What Can It Do?

  • Search pages by keyword across your workspace
  • Create and update pages as sub-pages or database entries with markdown content
  • Create and update databases with custom property schemas
  • Query databases with filters to get specific rows
  • Manage data sources within databases (list, inspect, and update schemas)
  • Retrieve page content including blocks and properties
  • List users and databases for workspace discovery
  • Comment on pages and blocks with threaded discussions
  • Manipulate blocks by appending, updating, or deleting content

​
Where to Use It

Add Notion as a tool to any agent. The agent can then search and retrieve your Notion data conversationally, choosing the right actions based on context. To add an MCP tool to your agent:
  1. Open your agent’s configuration
  2. Click Add tools → Connect an app with MCP
  3. Search for the integration and select it
  4. Authenticate with your account
You can control which tools your agent has access to. After adding an integration, click on it to enable or disable specific tools based on what your agent needs.

​
In Workflows (Via Agent Node)

For automated pipelines, use an Agent Node with Notion tools. This gives you the flexibility of an agent within a deterministic workflow.

​
As a Custom MCP Node

You can also create a standalone MCP node for a specific action. This generates a reusable node that performs one task, useful when you need the same operation repeatedly in workflows.
To create a custom MCP node:
  1. Go to your node library and search for the integration
  2. Click Create a node with AI
  3. Describe the specific action you want (e.g., “Search for pages containing ‘roadmap’”)
  4. Test the node and save it for reuse
Custom MCP nodes are single-purpose by design. For tasks that require multiple steps or dynamic decision-making, use an agent instead.

​
Available Tools

​
Read Tools

​
Write Tools

​
File Tools

Upload File takes a file that already lives in Gumloop storage, so pair it with a file input or an earlier node that writes the file. The upload ID it returns is what you pass to Create Page, Update Page, or Append Blocks to actually attach the file. Notion enforces its own upload size limit based on your workspace plan.

​
Example Prompts

Use these with your agent or in the Agent Node: Search pages:
Query a database:
Get page content:
List databases:
Check database schema:
Create a page:
Create a database entry:
Create a database:
Update a page:
List data sources:
Update a data source schema:
Add a comment:
List comments:
Append blocks:
Update a block:
Delete a block:
Upload a file:
Download a file:

​
Troubleshooting

Agents are smart enough to chain multiple API calls together. For example, asking “Get the meeting notes from last week” will search first, then retrieve the content. If results seem off, check the agent’s step-by-step reasoning.

​
Need Help?

Use this integration directly in Claude or Cursor. Connect remotely via the Notion MCP server using credentials from your Connectors page.