MCP.so
Sign In

Notion MCP Server

@R3Wlad

Repository

About Notion MCP Server

No overview available yet

#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"
      ]
    }
  }
}

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.

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.

Frequently asked questions

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

Basic information

Category

Memory & Knowledge

License

MIT

Transports

stdio

Author

R3Wlad

More Memory & Knowledge MCP servers

OpenLore

aakarim

Serve your docs to AI agents over SSH and MCP. Agents use ls, cat, grep, find, and pipes against a virtual filesystem backed by your documentation. Identity-scoped access, governed writing with human approval, and portab

66

Orcha

westonhancock

Orcha is a unified context layer for AI tools and agents. It stores and indexes and exposes organizational, team, or individual knowledge. Files, structured databases, and connected sources live in one workspace, and age

ctxfile

ctxfile

Local-first MCP server that snapshots your project's working state into one context object. Open-core, privacy-first.

2

MCP Apple Notes

RafalWilinski

Talk with your notes in Claude. RAG over your Apple Notes using Model Context Protocol.

401

Memlord

MyrikLD

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