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.

Start chatting
Managed
20 tools
Agent guide included

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

MCP URL
https://mcp.mcpbundles.com/bundle/notion
Claude.aiCursorVS CodeVS Code InsidersGooseLM StudioCherry StudioChatGPT

One-click install:

Install on Claude.aiInstall for organization (admins)

The link prefills the Add custom connector dialog — you still review the values and click Add, then Connect to complete OAuth.

Or add manually

  1. Open claude.ai → Settings → Connectors.
  2. Click the + button and choose Add custom connector.
  3. Set Name to Notion and paste the MCP URL into Remote MCP server URL.
  4. Click Add. Notion will appear under Not connected — select it and click Connect to complete OAuth.
Name: Notion
Remote MCP server URL: https://mcp.mcpbundles.com/bundle/notion
Authentication: OAuth

Custom connectors at claude.ai require a paid Claude plan (Pro, Max, Team, or Enterprise).

Related MCP Servers

More collaboration integrations you might like

Guru

Guru is a knowledge management platform that allows teams to organize, share, and access important i...

12 tools
Collaboration
Mendeley

Mendeley is a reference management software that allows researchers to organize and share research p...

30 tools
Collaboration
Dropbox Sign

Dropbox Sign provides a platform for electronic signatures and document management, enabling users t...

5 tools
Collaboration
Figma

Figma REST API for design file management, components, styles, and collaboration. Access files, node...

30 tools
Collaboration
GitBook

GitBook is a platform for creating, maintaining, and sharing documentation. Teams collaborate on con...

19 tools
Collaboration
Miro

Miro is an online collaborative whiteboard platform that enables teams to brainstorm, plan, and coll...

6 tools
Collaboration

Ready to use Notion?

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

Notion MCP Server & Skill