Advertise
MCP.so
Sign In

Notion MCP Server

@R3Wlad

Repository

Basic information

Category

Memory & Knowledge

License

MIT

Transports

stdio

Author

R3Wlad

About Notion MCP Server

No overview available yet

#notion#mcp#server

Notion MCP Server 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"
      ]
    }
  }
}

Notion MCP Server tools

9

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.

Frequently asked questions

1

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.

2

What environment variables are required?

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

3

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.

4

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.

5

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

Neither MCP

stonianua

Project context your AI can query through MCP — with source evidence.

Memory

modelcontextprotocol

Model Context Protocol Servers

88.1K

The Cloud

Teka

The Cloud is the AI-native workspace that gives every AI — Claude, ChatGPT, Gemini, and other Frontier & Free or Local models — shared memory and real agents. Not cloud computing: thecloud.so is one workspace where your

Groundwork

Rarefied-Earth

Groundwork: company memory for your AI tools. Docs public. Source closed. Public proof needs no account.

1

Memlord

MyrikLD

Memlord is a remote MCP server available at https://app.memlord.com.

Advertise