MCP Server for Notion
Enables AI agents to search, view, create, and update Notion pages and databases, supporting operations such as retrieving content and appending blocks via the Notion API.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@MCP Server for Notion search for my meeting notes from this morning"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
MCP Server for Notion
This tool provides the Notion API as an MCP (Model Context Protocol) server. It enables AI agents to search, view, create, and update Notion pages, as well as operate on databases.
Features
Page & Database Operations
Supports major operations such as search, retrieval, creation, updates, and appending blocks.
File-based Operations
Drastically reduces LLM token usage by saving/loading page content (JSON) to/from files.
Response Extraction (extract)
Optimizes context size by extracting only the necessary properties from the API response.
Related MCP server: Notion MCP Server
Quick Start
Local Development Environment
Install:
git clone https://github.com/acckkiie/notion-mcp-server cd notion-mcp-server npm installConfigure: Copy
.env.exampleto create.envand set your Notion API key.cp .env.example .env # Edit .env: NOTION_API_KEY=secret_...Run:
npm run dev
Image Build
npm run build
docker build -t notion-mcp-server:latest .MCP Client Configuration
Via Docker (Recommended)
Using Docker reduces environment dependencies and enables security control via proxy.
{
"mcpServers": {
"notion-mcp-server": {
"disabled": false,
"command": "bash",
"args": [
"-c",
"docker compose -f /path/to/notion-mcp-server/docker-compose.yml down 2>/dev/null; docker compose --env-file /path/to/notion-mcp-server/.env -f /path/to/notion-mcp-server/docker-compose.yml run --rm -i notion-mcp-server"
],
"env": {
"HOST_WORKSPACE_PATH": "/path/to/your/workspace"
}
}
}
}Local Execution
{
"mcpServers": {
"notion": {
"command": "node",
"args": [
"/path/to/notion-mcp-server/build/index.js"
],
"env": {
"NOTION_API_KEY": "secret_...",
"HOST_WORKSPACE_PATH": "/path/to/your/workspace"
}
}
}
}License
Available Tools
13 toolsnotion_append_block_childrenB
IMPORTANT: You MUST write the JSON payload (array of children) to a file first, then pass the file path in 'file_path'. Appends content blocks.
Inputs: block_id (required), file_path (required), extract.
notion_create_databaseA
IMPORTANT: You MUST write the JSON payload (including 'parent', 'title', 'properties') to a file first, then pass the file path in 'file_path'. Creates a database as a subpage in a specified parent.
Inputs: file_path (required), extract.
notion_create_pageA
IMPORTANT: You MUST write the JSON payload (including 'parent', 'properties', 'children') to a file first, then pass the file path in 'file_path'. Creates page in database or as subpage.
Inputs: file_path (required), extract.
notion_delete_blockA
Deletes a block (sets in_trash: true).
Inputs: block_id (required), extract.
notion_query_databaseA
Queries database with filters/sorts. Returns array of pages (results). Supports pagination
Inputs: database_id (required), sorts, filter, extract, +2 more.
notion_retrieve_blockB
Retrieves a block by ID.
Inputs: block_id (required), extract.
notion_retrieve_block_childrenA
Retrieves child blocks (paragraphs, headings, lists, etc.) of page or block. Supports pagination
Inputs: block_id (required), extract, page_size, start_cursor.
notion_retrieve_databaseA
Retrieves database schema: property definitions, title, description
Inputs: database_id (required), extract.
notion_retrieve_pageA
Retrieves page metadata: properties, parent, timestamps, archived status
Inputs: page_id (required), extract.
notion_searchA
Searches pages/databases by title. Filter by object type (page/database), sort by last_edited_time
Inputs: query (required), sort, filter, extract.
notion_update_blockC
IMPORTANT: You MUST write the JSON payload to a file first, then pass the file path in 'file_path'. Updates a block.
Inputs: block_id (required), file_path (required), extract.
notion_update_databaseA
IMPORTANT: You MUST write the JSON payload to a file first, then pass the file path in 'file_path'. Updates database title, description, or properties.
Inputs: file_path (required), database_id (required), extract.
notion_update_pageA
IMPORTANT: You MUST write the JSON payload to a file first, then pass the file path in 'file_path'. Updates page properties, archive status, icon, or cover.
Inputs: page_id (required), file_path (required), extract.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 13 tools
Each tool targets a distinct Notion resource and action: pages, databases, blocks, search, and query operations are clearly separated. Tools like notion_search and notion_query_database work differently enough that an agent should not confuse them.
All tools follow a consistent notion_verb_noun pattern (e.g., notion_retrieve_page, notion_create_database, notion_update_block, notion_append_block_children). The verb and resource order is uniform across the entire tool set, making the naming predictable.
Thirteen tools is well-scoped for Notion's content model, covering pages, databases, blocks, child-block operations, and search. Each tool covers a meaningful operation without excessive fragmentation or overlap.
The tool set provides strong coverage of Notion's core workflows: creating, retrieving, updating, querying, and searching pages, databases, and blocks. Minor gaps exist such as no explicit delete-database or page-deletion tool, though page archiving can be handled via update_page and block deletion is supported.
Maintenance
Related MCP Connectors
Securely search and manage workspace context files for AI agents and teams.
Universal memory for AI agents and tools. Save, organize and search context anywhere.
Connect AI agents to ProductNow's context engine to search, create, review, and act.
Agent-native notes, tasks, dev-docs, vaults, sync & handoffs. MCP + OpenAPI dual surface.
Related MCP Servers
- AlicenseBqualityDmaintenanceEnables AI agents to interact with Notion workspaces through the Notion API. Supports reading, writing, commenting, and managing Notion pages and databases with optimized token consumption for AI agents.19282,573 npmMIT
- AlicenseNot gradedqualityDmaintenanceEnables AI agents to interact with Notion workspaces through the Notion API, allowing them to search, read, create, and comment on pages and databases with optimized token consumption.MIT
- FlicenseNot gradedqualityDmaintenanceConnects AI assistants to Notion workspaces, allowing users to search, create, and manage pages or databases through natural language conversations. It supports complex database querying, content updates, and workspace organization via the Model Context Protocol.-
- AlicenseNot gradedqualityDmaintenanceIntegrates Notion with Claude Code, enabling search, read, and write operations on Notion pages and databases via the Model Context Protocol.5,456 npmMIT