create_page
Create a new page in Notion
LABSCO SUMMARY
Built around todos specifically, rather than being a thin wrapper over the whole Notion API.
The shape of the tooling follows how task databases are actually used: due dates, priorities, statuses, subtasks and multi-condition filters, rather than generic page CRUD. Two Notion constraints carry through and are worth knowing before you start: a database can only be created under a page or wiki database, and once created it cannot be moved to a different parent. The connection step in Notion's own UI is the usual first stumble — until the page is shared with your integration, the token is valid and still cannot see anything.
What it is
A Python server over the Notion API, built around task and content management: databases with custom properties, todos with rich text and dates, and block-level content operations.
What you get
- create_database — a new Notion database under a page your integration can reach, with your own property schema
- Todos carrying rich text with Markdown and inline code, timezone-aware due dates, priority levels and status values
- Nested subtasks with their own progress, plus categories and tags for organisation
- Filtering with multiple conditions combined by AND/OR, and sorting across several properties at once
- Pagination through large result sets, and search across content
- Content operations at block level: headings, quotes, callouts, code blocks, link previews and hierarchical lists
Requirements
A Notion internal integration token in NOTION_API_KEY, and either NOTION_PARENT_PAGE_ID to create new databases or NOTION_DATABASE_ID to work with an existing one. The page or database must be connected to your integration through its Add connections menu, or every call fails on permissions. Python with uv. For Claude Desktop the variables have to be in the client config — a .env file alone is not read.
Setup effort
Build from source — git clone https://github.com/pbohannon/notion-api-mcp.git
USE CASES
01
Setting up a task database with the fields you actually want
Define the properties — status options, priority, dates — in the same request that creates the database.
02
Capturing a task properly instead of as a bare line
Add it with a due date, a priority and a Markdown description, all in one go.
03
Asking what is actually due
Filter on status and date together, sorted the way you want to read it, rather than eyeballing a board.
04
Breaking a big task down
Add subtasks that track their own progress under the parent item.
17 tools
Listed in project code.
get_page
Retrieve a Notion page by its ID
update_page
Update a Notion page
archive_page
Archive a Notion page
restore_page
Restore an archived Notion page
get_page_property
Get a page property item
add_todo
Add a new todo with rich features
search_todos
Search todos with advanced filtering
create_database
Create a new database with custom schema in a parent page
query_database
Query database with filters and sorting
verify_connection
Verify authentication with Notion API
get_database_info
Get information about the configured database
add_content_blocks
Add content blocks with positioning support
get_block_content
Get content of a specific block by its ID
list_block_children
List all children of a block
update_block_content
Update a block's content by its ID
delete_block
Delete blocks
BEFORE YOU INSTALL
What to know first
Tools you get
17 tools registered in the project's code.
Requires
- Python with uv
- NOTION_API_KEY — your Notion integration token
- Either NOTION_PARENT_PAGE_ID (to create new databases) or NOTION_DATABASE_ID (to use an existing one)
Where it runs
The documented client runs the server on your machine.
INSTALLATION
Connect your client
Server setup
TERMINAL
# Clone and setup
git clone https://github.com/pbohannon/notion-api-mcp.git
cd notion-api-mcp
uv venv && source .venv/bin/activate
# Install and configure
uv pip install -e .
cp .env.integration.template .env
# Add your Notion credentials to .env:
# NOTION_API_KEY=<YOUR_NOTION_API_KEY>
# NOTION_PARENT_PAGE_ID=<YOUR_NOTION_PARENT_PAGE_ID> # For new databases
# NOTION_DATABASE_ID=<YOUR_NOTION_DATABASE_ID> # For existing databases
# Run the server
python -m notion_api_mcpMCP Clients
Claude Desktop
CLAUDE DESKTOP · JSON
{
"mcpServers": {
"notion-api": {
"command": "<YOUR_PATH_TO_VENV>/bin/python",
"args": [
"-m",
"notion_api_mcp"
],
"env": {
"NOTION_API_KEY": "<YOUR_NOTION_API_KEY>",
"NOTION_PARENT_PAGE_ID": "<YOUR_NOTION_PARENT_PAGE_ID>",
"NOTION_DATABASE_ID": "<YOUR_NOTION_DATABASE_ID>"
}
}
}
}
