Notion ReadOnly MCP Server

Name: Notion ReadOnly MCP Server
Author: Taewoong1378

@Taewoong1378

代码仓库

关于 Notion ReadOnly MCP Server

暂无概览

基本信息

分类

记忆与知识

许可证

MIT

运行时

node

传输方式

stdio

发布者

Taewoong1378

配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

{
  "mcpServers": {
    "notionApi": {
      "command": "npx",
      "args": [
        "-y",
        "notion-readonly-mcp-server"
      ],
      "env": {
        "OPENAPI_MCP_HEADERS": "{\"Authorization\": \"Bearer ntn_****\", \"Notion-Version\": \"2022-06-28\" }"
      }
    }
  }
}

工具

Get page information

Get page content blocks (with parallel processing)

Get details about a specific block

Get database information

Get comments on a page or block

Get specific property information from a page

**NEW!** Recursively retrieve a full Notion page with all its blocks, databases, and related content in a single call

概览

What is Notion ReadOnly MCP Server?

An optimized MCP server that exposes a minimal, read-only subset of the Notion API. It is designed for AI assistants (e.g., Cursor, Claude) to query and retrieve Notion content efficiently and safely.

How to use Notion ReadOnly MCP Server?

Set up an internal Notion integration and obtain a token (recommended to configure with only "Read content" capabilities). Then add the server to your client’s MCP config (.cursor/mcp.json or claude_desktop_config.json) using either npx (npx -y notion-readonly-mcp-server) or Docker (taewoong1378/notion-readonly-mcp-server), providing the OPENAPI_MCP_HEADERS environment variable with your authorization token and Notion-Version: 2022-06-28. Ensure the relevant pages and databases are connected to the integration.

Key features of Notion ReadOnly MCP Server

Read-only design ensures data safety.
Only 7 essential tools exposed.
Parallel processing speeds up block retrieval.
Recursive one-pager tool for full page extraction.
Supports databases, page properties, and comments.
Optimized for AI assistant tool-count limits.

Use cases of Notion ReadOnly MCP Server

AI assistant retrieves full content of a Notion page with one call.
Developer queries the structure of a Notion database.
User fetches comments or properties on a specific page.
Explore nested blocks and linked databases without multiple API calls.

FAQ from Notion ReadOnly MCP Server

What makes this server different from the standard Notion API integration?

It is read-only and exposes only 7 essential tools (compared to 15+), includes parallel processing and a recursive one-pager tool, and is explicitly designed to stay within AI assistant performance limits.

What runtime does the server require?

It runs on Node.js (via npx) or Docker. No additional dependencies are needed beyond the chosen runtime and a valid Notion integration token.

How do I secure the integration token?

Create an internal Notion integration and set its capabilities to only "Read content". Provide the token in the OPENAPI_MCP_HEADERS environment variable as {"Authorization": "Bearer ntn_****", "Notion-Version": "2022-06-28"}.

Does this server modify

记忆与知识分类下的更多 MCP 服务器

Ultimate Google Docs & Drive MCP Server

a-bonus

The Ultimate Google Docs, Sheets, Drive, Gmail, & Google Calendar MCP Server. This MCP (primarily for use in Claude Desktop) gains full access to your google suite and lets claude do its thing.

605