Notion MCP Server

Name: Notion MCP Server
Author: R3Wlad

@R3Wlad

Repository

About Notion MCP Server

No overview available yet

#notion #mcp #server

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "mcp-notion-server-r3wlad": {
      "command": "node",
      "args": [
        "build/index.js",
        "--enabledTools=notion_retrieve_block,notion_retrieve_block_children,notion_retrieve_page,notion_query_database,notion_retrieve_database,notion_search,notion_list_all_users,notion_retrieve_user,notion_retrieve_bot_user,notion_retrieve_comments"
      ]
    }
  }
}

Tools

Information about the appended blocks.

Detailed information about the block.

List of child blocks.

Confirmation of the deletion.

Detailed information about the page.

Information about the updated page.

Information about the created database.

List of results from the query.

Detailed information about the database.

Overview

What is Notion MCP Server?

Notion MCP Server is an MCP server for the Notion API, enabling Claude (or other MCP clients) to interact with Notion workspaces programmatically. It is intended for developers and users who want to automate Notion operations via AI assistants.

How to use Notion MCP Server?

Configure Claude Desktop by adding a notion entry to claude_desktop_config.json with the command npx -y @suekou/mcp-notion-server and the required environment variable NOTION_API_TOKEN. Optionally set NOTION_MARKDOWN_CONVERSION to "true" for experimental Markdown output. Use the --enabledTools command line argument to limit which tools are available.

Key features of Notion MCP Server

Read and write Notion pages, blocks, and databases.
Search pages and databases by title.
Create and update database schemas and items.
Manage comments on pages or blocks.
Optional Markdown conversion for reduced token consumption.
Per‑request format control (JSON or Markdown).

Use cases of Notion MCP Server

Automate Notion page creation and editing via Claude.
Query Notion databases with filters and sorts from AI conversations.
Retrieve and display Notion content in human‑readable Markdown.
Manage comments and discussions programmatically.

FAQ from Notion MCP Server

How do I set up authentication?

Create a Notion integration on the Notion integrations page, copy the Internal Integration Token, and add it as the NOTION_API_TOKEN environment variable. Then invite the integration to the relevant pages or databases.

What environment variables are required?

NOTION_API_TOKEN (required). Optionally set NOTION_MARKDOWN_CONVERSION to "true" to enable experimental Markdown conversion.

Can I limit which tools are available?

Yes, use the --enabledTools command line argument with a comma‑separated list of tool names (e.g., --enabledTools=notion_retrieve_page,notion_query_database). If not specified, all tools are enabled.

How does the Markdown conversion work?

When NOTION_MARKDOWN_CONVERSION is "true", responses can be returned in Markdown format (when the format parameter is set to "markdown"). This reduces token consumption but may cause issues when editing page content. Per‑request format control ("json" or "markdown") is supported.

Where are users listed in the workspace?

The notion_list_all_users and notion_retrieve_user tools require upgrading to the Notion Enterprise plan and using an Organization API key to avoid permission errors.

Comments

More Memory & Knowledge MCP servers

Notion MCP Server

suekou

A Model Context Protocol server for connecting Notion to MCP-compatible clients

910

RAG Documentation MCP Server

hannesrudolph

An MCP server implementation that provides tools for retrieving and processing documentation through vector search, enabling AI assistants to augment their responses with relevant documentation context.

267