MCP.so
Sign In

Notion ReadOnly MCP Server

@Taewoong1378

Repository

About Notion ReadOnly MCP Server

No overview available yet

Config

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

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

Tools

8

Retrieve block children

Retrieve a page

Retrieve a block

Retrieve a database

Retrieve comments

Retrieve a page property item

Recursively retrieve a full Notion page with all its blocks, databases, and related content

Retrieve the result of a background processing request

Overview

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

Frequently asked questions

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"}`.

Comments

Basic information

Category

Memory & Knowledge

License

MIT

Transports

stdio

Author

Taewoong1378

More Memory & Knowledge MCP servers

Rust Docs MCP Server

Govcraft

🦀 Prevents outdated Rust code suggestions from AI assistants. This MCP server fetches current crate docs, uses embeddings/LLMs, and provides accurate context via a tool call.

286

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

Solomd

zhitongblog

A markdown editor — and the bridge to your LLM. Local-first, MIT, ~15 MB. Bundled MCP server lets Claude Code / Codex / Cursor drive your vault directly. 14 AI providers BYOK.

425

MCP Apple Notes

RafalWilinski

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

401

Mcp Knowledge Graph

shaneholloman

MCP server enabling persistent memory for Claude through a local knowledge graph - fork focused on local development

871