Notion ReadOnly MCP Server
@Taewoong1378
About Notion ReadOnly MCP Server
No overview available yet
Basic information
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
7Get 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
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
More Memory & Knowledge MCP servers
minutes
silversteinEvery meeting, every idea, every voice note — searchable by your AI. Open-source, privacy-first conversation memory layer.
Memory Bank MCP Server
alioshrA Model Context Protocol (MCP) server implementation for remote memory bank management, inspired by Cline Memory Bank.
Notion MCP Integration
danhilseA simple MCP integration that allows Claude to read and manage a personal Notion todo list
Semantic Scholar MCP Server
YUZongminA FastMCP server implementation for the Semantic Scholar API, providing comprehensive access to academic paper data, author information, and citation networks.
Zettelkasten MCP Server
entanglrA Model Context Protocol (MCP) server that implements the Zettelkasten knowledge management methodology, allowing you to create, link, explore and synthesize atomic notes through Claude and other MCP-compatible clients.
Comments