notion-mcp-server

Overview

The Notion MCP Server is a robust implementation that enables AI assistants to interact with Notion's API through the Model Context Protocol. It provides a complete set of tools for reading, creating, and modifying Notion content. The server includes features for database operations, page management, block manipulation, comment handling, and user management. It is designed to work universally with MCP clients including Cursor, Claude Desktop, Cline, and Zed, making it a versatile solution for Notion integration in various AI workflows.

Try asking AI

After installing, here are 6 things you can ask your AI assistant:

• notion_pages

  Create, update, archive, restore, and search Notion pages

  Try:Create a new page with today's tasksTry:Update my meeting notes in NotionTry:Search for pages by title
• notion_blocks

  Retrieve, append, update, delete, and perform batch operations on blocks

  Try:Add bullet points to my meeting notes pageTry:Retrieve block content from pageTry:Append new blocks to a parent page
• notion_database

  Create, query, and update Notion databases

  Try:Create a new database for tracking projectsTry:Query my task database with filtersTry:Update database structure and properties
• notion_comments

  Get, create, and reply to comments on Notion pages and discussions

  Try:Add a comment to my project pageTry:Show me all comments on this documentTry:Reply to an existing discussion comment
• notion_users

  List workspace users and get information about specific users

  Try:List all users in my workspaceTry:Get information about a specific userTry:Get details about the current bot user

Comparable tools

Installation

{
  "mcpServers": {
    "notion-mcp-server": {
      "command": "npx",
      "args": ["-y", "notion-mcp-server"],
      "env": {
        "NOTION_TOKEN": "YOUR_KEY",
        "NOTION_PAGE_ID": "YOUR_PAGE_ID"
      }
    }
  }
}

{
  "mcpServers": {
    "notion-mcp-server": {
      "command": "env NOTION_TOKEN=YOUR_KEY NOTION_PAGE_ID=YOUR_PAGE_ID npx",
      "args": ["-y", "notion-mcp-server"]
    }
  }
}

FAQ

What permissions are required for the Notion integration?

The integration needs read/write permissions for the pages and databases you want to interact with. Ensure it's enabled for specific pages through the 'Connections' menu in Notion.

Does this support batch operations for better performance?

Yes, the server supports batch operations for blocks, allowing multiple append, update, delete, or mixed operations in a single request to optimize API usage.

Can I use this with other MCP clients besides Claude and Cursor?

Yes, the server is designed to be universally compatible with any MCP client including Cline, Zed, and others that implement the MCP specification.

Compare notion-mcp-server with