Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.gumloop.com/llms.txt

Use this file to discover all available pages before exploring further.

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

ToolDescription
Search PagesSearch all pages by keyword (supports pagination for large result sets)
List All PagesList pages across databases
Get PageRetrieve a page by ID or URL
List DatabasesList all databases
Get DatabaseGet database properties and schema
Query DatabaseQuery with filters
Get Block ChildrenList content blocks
Get BlockGet a single block
List All UsersList workspace users
Get UserGet user details
List Data SourcesList all data sources under a database, each with its own schema and properties
Get Data SourceRetrieve a specific data source by ID to inspect its schema
List CommentsList comments on a page or block

​
Write Tools

ToolDescription
Create PageCreate a new page as a sub-page or database entry with properties, markdown content, or block children
Update PageUpdate page properties, title, icon, cover, or archive/trash status
Create DatabaseCreate a new database with custom property schema under an existing page
Update DatabaseUpdate database title, description, icon, cover, or trash/lock status
Update Data SourceUpdate a data source’s property schema, title, description, icon, or trash status
Create CommentCreate a comment on a page, block, or reply to an existing discussion thread
Append BlocksAppend child blocks to a page or block (supports up to 100 blocks and two levels of nesting)
Update BlockUpdate an existing block’s content (paragraph text, to-do status, callout icons, etc.)
Delete BlockArchive (soft-delete) a block by ID

​
Example Prompts

Use these with your agent or in the Agent Node: Search pages: 
Find pages containing "product roadmap"
Query a database: 
Get all tasks from the Sprint database where status is "In Progress"
Get page content: 
What's in the Q4 Planning page?
List databases: 
Show me all databases in my Notion workspace
Check database schema: 
What properties does the Projects database have?
Create a page: 
Create a new page called "Meeting Notes" under the Team Wiki page with today's meeting agenda in markdown
Create a database entry: 
Add a new task to the Sprint database with title "Fix login bug", status "In Progress", and priority "High"
Create a database: 
Create a new database called "Project Tracker" with columns for Name, Status, Priority, Due Date, and Assignee
Update a page: 
Archive the Q3 Planning page and remove its cover image
List data sources: 
List all data sources under the Projects database and show their schemas
Update a data source schema: 
Add a "Priority" select column with options High, Medium, and Low to this data source
Add a comment: 
Add a comment saying "Looks good to me!" on the Q4 Planning page
List comments: 
Show me all comments on the Product Roadmap page
Append blocks: 
Add a callout block with a lightbulb emoji and text "Remember to update the timeline" to the Sprint Planning page
Update a block: 
Mark the first to-do item as completed on my Tasks page
Delete a block: 
Remove the outdated note block from the Meeting Notes page

​
Troubleshooting

IssueSolution
Agent not finding the right dataUse specific page titles or database names
Action not completingCheck that you’ve authenticated and the page is shared with the integration
Unexpected resultsThe agent may chain multiple tools (e.g., searching first, then getting content). Review the agent’s reasoning to understand its approach.
Tool not availableVerify the tool is enabled in your agent’s MCP configuration
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 your Gumloop credentials.