Advertise
MCP.so
Sign In

Notion ReadOnly MCP Server

@Taewoong1378

Repository

Basic information

Category

Memory & Knowledge

License

MIT

Transports

stdio

Author

Taewoong1378

About Notion ReadOnly MCP Server

No overview available yet

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

Notion ReadOnly MCP Server 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.

Frequently asked questions

1

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.

2

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.

3

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

More Memory & Knowledge MCP servers

Sooveryn

PANDAPROG

Sooveryn gives Claude Code a team of AI personas that remembers your project. Soov, the partner and team lead, keeps your decisions and how you work in a lasting memory, and finds them again by words and by meaning, from

server-noonien - shared memory MCP

sequico

Shared, serverless, conflict-free memory for AI agents: a multi-machine drop-in for the MCP memory knowledge graph.

Agimem

Persistent memory for AI agents. Hosted MCP server with capsule-scoped key/value storage, tags, TTL expiration, bulk ops, and RBAC.

PLUR

plur-ai

AI agents start every session with amnesia — you re-explain the project, repeat your preferences, and correct the same mistakes over and over. PLUR gives them a memory that persists. Your agent's corrections, preference

226

Scento Perfume API (MCP server): free fragrance API, no key

Scento

Scento Perfume API is a free fragrance API and perfume notes database for developers and AI agents. Search 1,500+ perfumes and 400+ ingredients, compare scents, find similar perfumes, map scent families and build occasio

Advertise