Back to MCP Directory
Notion
Model Context Protocol moderate risk

Notion

MCP server for Notion API, enabling LLMs to interact with Notion workspaces, with Markdown conversion to reduce token usage and optimize efficiency.

Connections & Capabilities

Connects To

Notion

Capabilities

readwrite

Quickstart

Config

{
  "mcpServers": {
    "notion": {
      "command": "npx",
      "args": ["-y", "@suekou/mcp-notion-server"],
      "env": {
        "NOTION_API_TOKEN": "your-integration-token"
      }
    }
  }
}

Exposed MCP Tools (17)

moderate
notion_append_block_children

Appends child blocks to a specified parent block in Notion.

Adds content to existing blocks.

safe
notion_retrieve_block

Retrieves information about a specific block in Notion.

Read-only operation.

safe
notion_retrieve_block_children

Retrieves the children of a specific block in Notion.

Read-only operation.

critical
notion_delete_block

Deletes a specific block in Notion.

Destructive operation that permanently removes content.

safe
notion_retrieve_page

Retrieves information about a specific page in Notion.

Read-only operation.

high
notion_update_page_properties

Updates properties of a page in Notion.

Modifies page metadata and content.

moderate
notion_create_database

Creates a new database in Notion.

Creates a new database structure.

safe
notion_query_database

Queries a database in Notion based on specified filters and sorts.

Read-only operation.

safe
notion_retrieve_database

Retrieves information about a specific database in Notion.

Read-only operation.

high
notion_update_database

Updates information about a database in Notion.

Modifies database metadata and schema.

moderate
notion_create_database_item

Creates a new item in a Notion database.

Adds new data entries to a database.

safe
notion_search

Searches pages or databases in Notion by title.

Read-only operation.

safe
notion_list_all_users

Lists all users in the Notion workspace.

Read-only operation, requires Enterprise plan.

safe
notion_retrieve_user

Retrieves a specific user by user_id in Notion.

Read-only operation, requires Enterprise plan.

safe
notion_retrieve_bot_user

Retrieves the bot user associated with the current token in Notion.

Read-only operation.

moderate
notion_create_comment

Creates a comment in Notion.

Adds comments to pages or blocks.

safe
notion_retrieve_comments

Retrieves a list of unresolved comments from a Notion page or block.

Read-only operation.

Safety Assessment

The server allows both read and write operations on Notion workspaces, making it moderately risky. Limiting enabled tools and carefully managing API token security are crucial for safe operation. Markdown conversion, while helpful, may introduce data loss during edits.

  • Optional Markdown conversion reduces token consumption.
  • Tool enabling can restrict available actions.
  • Requires Notion API token for authentication.
  • No direct code execution capabilities.
  • Write operations can modify Notion content.
  • Deletion of blocks is possible.
  • Improperly configured permissions can lead to data breaches.
  • Token compromise allows unauthorized access.