Collaboration

Notion MCP Server

Connect your account, then chat with AI to run tools.

Notion is an all-in-one workspace for notes, databases, project management, and collaboration. Search pages, query databases, create and update content, manage blocks, and work with comments through the Notion REST API.

20 tools
Agent guide included
Start Chatting

Opens MCPBundles Studio with this server selected. After sign-in, chat and run tools from the same thread.

Browse all tools

AI Skill
SKILL.md

Domain knowledge for Notion — workflow patterns, data models, and gotchas for your AI agent.

Notion

Notion organizes content as pages (documents) and databases (structured tables). Pages contain blocks (paragraphs, headings, lists, toggles, etc.) as children. Databases have typed properties (title, text, number, select, date, etc.) and rows are pages with property values.

Data Model

  • Pages are documents with properties and block children. Every database row is also a page.
  • Databases define a schema via properties. Query with filters and sorts.
  • Blocks are content units: paragraph, heading_1/2/3, bulleted_list_item, numbered_list_item, to_do, toggle, code, image, etc.
  • Users are workspace members (person or bot type).
  • Comments are threaded discussions on pages or specific blocks.

Common Patterns

  • Search finds pages and databases by title. Use filter to narrow to pages or databases only.
  • Read page content: Render a page as human-readable Markdown. Fetch block children only when you need the raw block JSON.
  • Write content with Markdown: New pages and appended blocks both accept a markdown_content parameter. Pass Markdown text and it's automatically converted to Notion blocks. Supports headings, lists, to-dos, code blocks, quotes, images, and inline formatting.
  • Query database: Use filter objects with property-based conditions. Sorts accept property name + direction.
  • Create page in database: Set parent to database_id and provide property values matching the database schema.
  • Create page as child: Set parent to page_id and provide content via markdown_content or raw children blocks.
  • Move a page: Move/reparent a page under a different page or database.
  • IDs: UUIDv4 format. Dashes can be omitted. Use the full UUID with dashes when passing ids into parameters.

Gotchas

  • Pagination: Paged listings return at most 100 items. Use start_cursor from the response to continue.
  • Rich text: Text content is represented as arrays of rich_text objects with type, text.content, and annotations. When using markdown_content, this is handled automatically.
  • Property values vary by type: Each property type (title, rich_text, number, select, date, etc.) has its own value format.
  • Archived = deleted: Setting archived=true on a page or block is how you delete in Notion.
  • Markdown vs raw blocks: Use markdown_content for natural content creation. Use raw children blocks only when you need precise control over block structure (e.g., toggles, callouts, synced blocks).

Tools in this Server (20)

Notion Append Blocks

Append content to a Notion page or block. You can provide either: - **markdown_content**: A Markdown string that is automatically converted to Notion ...

Notion Create Comment

Create a comment on a Notion page or reply to an existing discussion thread. Provide either parent.page_id for a new top-level comment, or discussion_...

Notion Create Database

Create a new Notion database as a child of a page. Define the schema via the properties parameter. Each property needs a name (key) and type definitio...

Notion Create Page

Create a new Notion page. Set parent to a database_id to create a database row, or to a page_id to create a child page. Properties must match the pare...

Notion Delete Block

Delete a Notion block by archiving it. This is equivalent to setting archived=true on the block.

Notion Get Block Children

Retrieve the child blocks (content) of a page or block. This is how you read the actual content of a Notion page — the page endpoint only returns prop...

Notion Get Comments

Retrieve comments from a Notion page or block. Returns threaded discussion comments with pagination support.

Notion Get Database

Retrieve a Notion database by its ID, including its schema (property definitions), title, and description.

Notion Get Page

Retrieve a Notion page by its ID, including all of its property values.

Notion Get Self

Get information about the authenticated Notion integration bot user, including workspace details.

Notion Get User

Get details for a specific Notion user by their user ID.

Notion Import File

Import a file from a public URL into Notion's permanent storage. Notion downloads the file server-side — no binary upload needed. Supports images, PDF...

Notion List Users

List all users (people and bots) in the Notion workspace. Supports pagination.

Notion Move Page

Move a Notion page to a different parent. The page can be moved under another page or into a database. The bot must have edit access to both the page ...

Notion Query Database

Query a Notion database to retrieve pages (rows) matching filter conditions. Supports compound filters (and/or), property-based sorting, and paginatio...

Notion Read Page

Read a Notion page and return its content as readable Markdown. Combines page properties with the full page content (blocks) rendered as Markdown text...

Notion Search

Search across all pages and databases shared with the integration by title. Optionally filter to only pages or only databases. Results are sorted by l...

Notion Update Block

Update the content of an existing block. Provide the block's type and the updated content. For example, to update a paragraph: {'paragraph': {'rich_te...

Notion Update Database

Update a Notion database's title, description, or property schema. Add new properties by including them in the properties object. Rename properties by...

Notion Update Page

Update a Notion page's properties, icon, or cover. Set archived=true to move the page to trash.

Frequently Asked Questions

What is the Notion MCP server?

Notion is an all-in-one workspace for notes, databases, project management, and collaboration. Search pages, query databases, create and update content, manage blocks, and work with comments through the Notion REST API. It provides 20 tools that AI agents can use through the Model Context Protocol (MCP).

How do I connect Notion to my AI agent?

Add the MCPBundles server URL to your MCP client configuration (Claude Desktop, Cursor, VS Code, etc.). The URL format is: https://mcp.mcpbundles.com/bundle/notion. Authentication is handled automatically.

How many tools does Notion provide?

Notion provides 20 tools that can be called by AI agents, along with a SKILL.md that gives your AI agent domain knowledge about when and how to use them.

What authentication does Notion require?

Notion uses One-click sign in. Notion requires credentials. Connect via MCPBundles and authentication is handled automatically.

Setup Instructions

Connect Notion to any MCP client in minutes

https://mcp.mcpbundles.com/bundle/notion

What is MCP?

Model Context Protocol lets AI tools call external capabilities securely through a single URL. This bundle groups tools behind an MCP endpoint that many clients can use.

Use this bundle in 3 steps

  1. Copy the MCP URL above
  2. Open your AI tool and add a new MCP/connector
  3. Paste the URL and follow any auth prompts

Claude Desktop Users

Skip the manual setup! Use the .mcpb file format for one-click installation. Check the Claude Desktop tab for setup instructions.

Pick your tool tab for exact steps

Select ChatGPT, Cursor, Claude Code, or another tab for copy-paste config.

Related MCP Servers

More collaboration integrations you might like

Agent Arena

Agent Arena Registry allows users to search for agents, retrieve their profiles, and register new ag...

Collaboration
Agi Alpha

This server provides a full-featured platform for managing job listings and agent interactions, incl...

Collaboration
Airtable

Official Airtable MCP server providing AI-powered access to Airtable bases, tables, records, and sch...

Collaboration
Anima

This server facilitates the creation and management of design assets, allowing users to convert desi...

Collaboration
Approval Studio

Online proofing and design review platform for creative teams. Provides annotation tools, version co...

Collaboration
Atlassian

Atlassian provides software development and collaboration tools including Jira for project tracking,...

Collaboration

Ready to use Notion?

Sign in to connect your credentials and start running tools from the chat.

Notion MCP Server & Skill — 20 Tools