Optimized read-only MCP server for Notion API with asynchronous processing
Notion Readonly becomes available to MCP clients through the notion readonly mcp server. Optimized read-only MCP server for Notion API with asynchronous processing.
This project implements an optimized read-only MCP server for the Notion API, focusing on performance and efficiency for AI assistants to query and retrieve Notion content.
Once connected, the assistant can call these 7 tools directly:
API-retrieve-a-page — Get page informationAPI-get-block-children — Get page content blocks (with parallel processing)API-retrieve-a-block — Get details about a specific blockAPI-retrieve-a-database — Get database informationAPI-retrieve-a-comment — Get comments on a page or blockAPI-retrieve-a-page-property — Get specific property information from a pageAPI-get-one-pager — NEW! Recursively retrieve a full Notion page with all its blocks, databases, and related content in a single callSetup follows the standard MCP pattern: clone or install the server, then register it in your client's configuration file and restart the client. The configuration snippets on this page cover Claude Desktop, Claude Code and Cursor.
The server reads 2 environment variables: OPENAPI_MCP_HEADERS, YOUR_PAGE_ID. Keep credentials in your client's env block or a secrets manager rather than committing them.
Productivity servers pay off through capture: the tasks and notes that never get filed are the ones where opening the app is more friction than the thought is worth. Notion Readonly sits in that group, and the shape of its toolset — API-retrieve-a-page, API-get-block-children, API-retrieve-a-block among others — tells you what it is really for. Worth comparing against the other productivity servers in this directory before you commit to one, since several overlap in scope but differ sharply in setup cost and permissions.
| Tool | What it does |
|---|---|
| API-retrieve-a-page | Get page information |
| API-get-block-children | Get page content blocks (with parallel processing) |
| API-retrieve-a-block | Get details about a specific block |
| API-retrieve-a-database | Get database information |
| API-retrieve-a-comment | Get comments on a page or block |
| API-retrieve-a-page-property | Get specific property information from a page |
| API-get-one-pager | **NEW!** Recursively retrieve a full Notion page with all its blocks, databases, and related content in a single call |
{
"mcpServers": {
"notionApi": {
"command": "npx",
"args": ["-y", "notion-readonly-mcp-server"],
"env": {
"OPENAPI_MCP_HEADERS": "{\"Authorization\": \"Bearer ntn_****\", \"Notion-Version\": \"2022-06-28\" }"
}
}
}
}Configuration as documented by the project. Restart the client after saving.
| Variable | Description | Required |
|---|---|---|
| OPENAPI_MCP_HEADERS | Configuration value read at startup. | Optional |
| YOUR_PAGE_ID | Configuration value read at startup. | Optional |
Your workspace, on speaking terms with AI — search, read and write Notion pages and databases.
Issue tracking at the speed of conversation — Linear's official hosted server with OAuth and zero install.
Search and read your Drive — Docs, Sheets and files become context your assistant can actually use.
Your assistant inside the workspace — read channels, search history, post messages and tame the noise.
Metabase ships its own MCP endpoint — search your BI content, build and run queries, and save questions and dashboards without leaving the chat.
Stop letting your assistant hallucinate n8n node parameters — this server hands it the real schemas, templates and validation.