使用说明
Notion Complete MCP Server
Stop manually copying data between Notion and other tools. Search pages, query databases, create content, and manage your entire Notion workspace — all from your AI assistant.
Tools
| Category | Tool | Description |
|---|---|---|
| Pages | create_page |
Create a new page inside a parent page or database |
| Pages | get_page |
Retrieve page properties and metadata by ID |
| Pages | update_page |
Update page properties (status, dates, any field) |
| Pages | delete_page |
Archive/soft-delete a page |
| Pages | list_pages |
Search and list pages across your workspace |
| Databases | create_database |
Create a new database with custom schema |
| Databases | query_database |
Filter and sort database rows (e.g. Status = "In Progress") |
| Databases | get_database |
Retrieve database schema and metadata |
| Databases | update_database |
Add or modify database columns |
| Databases | list_databases |
Search all databases in your workspace |
| Blocks | get_block_children |
Get all content blocks inside a page or block |
| Blocks | append_block_children |
Add paragraphs, checklists, code blocks, and more |
| Blocks | update_block |
Edit block content or check off to-dos |
| Blocks | delete_block |
Remove a specific block from a page |
| Blocks | get_block |
Retrieve a single block by ID |
| Search | search |
Search all pages and databases with optional filters |
| Users | list_users |
List all workspace members |
| Users | get_user |
Look up a specific user by ID |
| Users | get_bot_user |
Verify your integration connection |
| Comments | create_comment |
Leave a comment on a page or reply to a thread |
| Comments | list_comments |
Read all comments on a page |
| Multi-workspace | connect_workspace |
Register multiple integration tokens by name |
| Multi-workspace | list_workspaces |
See all connected workspaces in the session |
Quick Start
1. Create a Notion Integration
Go to https://www.notion.so/my-integrations and create a new integration. Copy the secret_... token.
2. Share pages with your integration
In Notion, open any page or database, click the ... menu, go to Connections, and add your integration.
3. Set your environment variable
NOTION_API_KEY=secret_your_token_here
4. Example queries
Query a task database:
{
"tool": "query_database",
"database_id": "your-db-id",
"filter": {"property": "Status", "select": {"equals": "In Progress"}},
"sorts": [{"property": "Due Date", "direction": "ascending"}]
}
Create a page in a database:
{
"tool": "create_page",
"parent_id": "your-db-id",
"parent_type": "database_id",
"title": "New Task",
"properties": {
"Status": {"select": {"name": "Not Started"}},
"Priority": {"select": {"name": "High"}}
}
}
Search your workspace:
{
"tool": "search",
"query": "Q2 marketing plan",
"filter_type": "page"
}
Multi-workspace Support
You can connect multiple Notion workspaces in a single session:
{
"tool": "connect_workspace",
"workspace_name": "company",
"integration_token": "secret_company_token"
}
Then pass "integration_token" in any subsequent tool call to target that workspace.
Alternatively, set multiple env vars: NOTION_API_KEY, NOTION_API_KEY_COMPANY, etc. and pass the token directly.
Built with the MCP Agent Framework — production AI agents for serious builders.