API-get-background-result
Retrieve the result of a background processing request
LABSCO SUMMARY
A focused, read-only Notion reader that keeps an assistant fast and inside its tool limit.
Trimming the tool set and adding parallel block fetching addresses the real friction of Notion in an AI client — too many tools and too many round-trips — so API-get-one-pager can pull an entire page in one recursive call instead of dozens of separate reads.
What it is
A server that gives an assistant read-only access to Notion, deliberately exposing a small set of retrieval tools rather than the full API, so an AI client stays within its tool budget while still reading pages, blocks, databases, and comments.
What you get
- API-retrieve-a-page and API-get-block-children fetch a page and its content blocks, with parallel processing for speed
- API-retrieve-a-block, API-retrieve-a-database, API-retrieve-a-comment, and API-retrieve-a-page-property fetch individual blocks, databases, comments, and page properties
- API-get-one-pager recursively retrieves a full page with all its blocks, databases, and related content in a single call
- API-get-background-result returns the result of a background processing request
Requirements
A Notion integration token, supplied in the client configuration; runs through npx on Node. A read-content-only integration keeps its access to reading.
Setup effort
One command — npx -y notion-readonly-mcp-server
USE CASES
01
Reading a whole page in one go
API-get-one-pager recursively retrieves a page with its blocks, databases, and related content in a single call.
02
Fetching a page and its content
API-retrieve-a-page and API-get-block-children return the page and its blocks, fetched in parallel for speed.
03
Reading a database's structure
API-retrieve-a-database returns a database's information for an agent to work from.
04
Pulling a specific property or comment
API-retrieve-a-page-property and API-retrieve-a-comment fetch a single property value or the comments on a page.
8 tools
Counted once with only startup setup. Other versions, modes or optional credentials may expose a different list.
API-get-block-children
Retrieve block children
API-get-one-pager
Recursively retrieve a full Notion page with all its blocks, databases, and related content
API-retrieve-a-block
Retrieve a block
API-retrieve-a-comment
Retrieve comments
API-retrieve-a-database
Retrieve a database
API-retrieve-a-page
Retrieve a page
API-retrieve-a-page-property
Retrieve a page property item
BEFORE YOU INSTALL
What to know first
Tools you get
8 tools when we connected.
Requires
- npx on PATH
- OPENAPI_MCP_HEADERS in your environment
CONTEXT COST
Light Standing cost
Rated by the size of the 8 tool definitions that ride along on every turn, not by how many there are
INSTALLATION
Connect your client
Add the block to your client, or run the command directly.
Server setup
Configuration file
JSON
{
"mcpServers": {
"notionApi": {
"command": "npx",
"args": [
"-y",
"notion-readonly-mcp-server"
],
"env": {
"OPENAPI_MCP_HEADERS": "{\"Authorization\": \"Bearer ntn_****\", \"Notion-Version\": \"2022-06-28\" }"
}
}
}
}npx
TERMINAL
npx -y notion-readonly-mcp-server
