Loading...
Query databases, create pages, update blocks, and search content in Notion workspaces via the official REST API
260+ deploysclaude mcp add notion --url https://datafaucet.dev/api/mcp/t/notion
Run this command in your terminal · most users connect in under 60s
POST endpoints
query_database
Query a database with compound filters: {property, type, condition} (e.g. {"property":"Status","select":{"equals":"Done"}}). Combine with 'and'/'or'. Sort by any property + 'ascending'/'descending'. Returns up to 100 pages per call. Paginate with 'start_cursor' from next_cursor in response.
https://api.notion.com/v1/databases/{database_id}/query
create_page
Create a page in a database. Properties object keys must match database property names exactly. Types: title [{text:{content}}], rich_text [{text:{content}}], select {name}, multi_select [{name}], date {start,end}, number (raw), checkbox (bool), url (string). Add 'children' array for inline content blocks.
https://api.notion.com/v1/pages
search_pages
Full-text search across all pages and databases the integration can access. Filter with 'filter': {value: 'page'|'database', property: 'object'}. Sort by 'last_edited_time' (ascending/descending). Returns max 100 results. Paginate with 'start_cursor'. Only searches titles and text properties.
https://api.notion.com/v1/search
GET endpoints
get_block_children
Get child blocks of a page or block. Block types: paragraph, heading_1/2/3, bulleted_list_item, numbered_list_item, to_do (with checked flag), toggle, code (with language), quote, callout, image, embed, divider. Each block has rich_text array with annotations (bold, italic, code, color). Paginate with 'start_cursor'.
https://api.notion.com/v1/blocks/{block_id}/children
PATCH endpoints
update_page
Partial update any page properties. Only include properties you want to change. Set 'archived': true to soft-delete. Property format matches create_page. For status properties, use {name: 'In Progress'}. For relation, pass array of page IDs [{id}]. Returns updated page with all properties.
https://api.notion.com/v1/pages/{page_id}
append_blocks
Append child blocks to a page or block. Children array contains block objects: {type: 'paragraph', paragraph: {rich_text: [{text: {content: '...'}}]}}. Supported types: paragraph, heading_1/2/3, bulleted_list_item, numbered_list_item, to_do, toggle, code, quote, callout, divider, embed, bookmark. Max 100 blocks per call.
https://api.notion.com/v1/blocks/{block_id}/children
Run this in your terminal:
claude mcp add notion https://datafaucet.dev/api/mcp/t/notion
Connect Notion API to your AI agent in under 60 seconds. No account required.
{notion_token}) with your real credentialsNeed API keys? Try our free sandbox templates first to see MCP in action with zero setup.
Replace these placeholders with your real values before deploying:
{block_id}Resource identifier{database_id}Database/workspace ID{notion_token}API settings page{page_id}Resource identifier{search_query}Your valuePreview:
POST https://api.notion.com/v1/databases/{database_id}/query Authorization: Bearer {notion_token} Content-Type: application/json Notion-Version: 2022-06-28 {"filter":{},"sorts":[]}
claude mcp add notion --url https://datafaucet.dev/api/mcp/t/notionWhat your AI agent sees
I have access to 6 tools from Notion API: query_database, create_page, search_pages, and 3 more.
“Query a database with compound filters: {property, type, condition} (e.g. {"property":"Status","select":{"equals":"Done"}}). Combine with 'and'/'or'. Sort by any property + 'ascending'/'descending'. Returns up to 100 pages per call. Paginate with 'start_cursor' from next_cursor in response.”
Calling query_database... Done. Here are the results.
Try these prompts
“Create a new page in my Projects database with status 'In Progress'”
Copy“Find all tasks assigned to me that are overdue”
Copy“Add a comment to the Q2 Planning page with today's standup notes”
CopyClick any prompt to copy, then paste into your AI client.