How do I install the notion readonly mcp server?

Use a recorded configuration for your client, replace example credential values and paths, and verify the documented runtime. Restart or reconnect the client, then inspect the available tools.

What credentials does it need?

The recorded environment keys are `OPENAPI_MCP_HEADERS`. Keep credentials outside committed files and confirm the configuration required by your installed version.

SSyncDev

Start a project

Notion Readonly MCP Server

Optimized read-only MCP server for Notion API with asynchronous processing

Local serverstdioGo

What is the Notion Readonly MCP Server?

Notion Readonly becomes available to MCP clients through the notion readonly mcp server. Optimized read-only MCP server for Notion API with asynchronous processing.

What Notion Readonly does

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.

Practical notes

Maintained by Taewoong1378, written in Go.

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account 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

How to install the Notion Readonly MCP Server

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

From the project documentation. Replace placeholders and example paths before connecting.

Configuration

Variable	Description	Required
OPENAPI_MCP_HEADERS	Declared in the maintainer’s client configuration.	Check documentation

Example prompts to try

“Use Notion Readonly to API-retrieve-a-page.”
“Use Notion Readonly to API-get-block-children.”
“Use Notion Readonly to API-retrieve-a-block.”

Frequently asked questions

Optimized read-only MCP server for Notion API with asynchronous processing Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.