Tools Reference

Notion MCP provides 10 tools — 6 read tools and 4 write tools.

Search

Find pages and databases across your workspace.

Tool	Parameters	Description
search	query?: string, filter?: "page" | "database", limit?: number (default: 10, max: 100)	Searches across all pages and databases in the workspace. Only returns content shared with the integration.

Example prompts:

• "Search my Notion workspace for pages about Q4 planning."
• "Find all databases in my workspace."
• "Search for pages mentioning 'product roadmap'."

---

Pages

Read page properties and full content.

Tool	Parameters	Description
get_page	page_id: string	Retrieves page properties including title, created time, last edited time, parent, and all property values.
get_page_content	page_id: string, max_depth?: number (default: 3)	Retrieves the full content of a page as readable text blocks. Recursively fetches nested blocks (toggles, columns, etc.) up to the configured depth. Returns flattened plain text optimized for LLM consumption.

Example prompts:

• "Get the properties of page abc123."
• "Read the full content of my onboarding guide page."
• "Show me what's inside page def456 including nested toggles."

---

Databases

Inspect database schemas and query entries.

Tool	Parameters	Description
get_database	database_id: string	Retrieves database metadata including title, description, and property schema (column definitions). Use this to understand the structure of a database before querying it.
query_database	database_id: string, filter?: object, sorts?: object[], limit?: number (default: 25, max: 100)	Queries a Notion database with optional filter and sort objects. Returns matching entries with all property values. Uses Notion's native filter syntax.

Example prompts:

• "Show me the schema of our project tracker database."
• "Query the hiring pipeline database for all entries with status 'Interview'."
• "List the 10 most recently edited entries in database ghi789."

---

Users

List workspace members.

Tool	Parameters	Description
list_users	limit?: number (default: 25, max: 100)	Lists all users in the Notion workspace including name, email, type (person/bot), and avatar URL.

Example prompts:

• "Who are all the users in our Notion workspace?"
• "List the members and bots in our workspace."

---

Write Operations

caution

Write tools create and modify content in your Notion workspace. Use with care.

Page Management

Tool	Parameters	Description
create_page	parent_database_id?: string, parent_page_id?: string, properties: string, children?: string	Creates a new page in a database or as a child of another page. Properties and children are JSON strings using Notion's block format.
update_page_properties	page_id: string, properties: string	Updates the properties of an existing page. Properties is a JSON string.
append_blocks	block_id: string, children: string	Appends content blocks to a page or block. Children is a JSON string of Notion block objects.
archive_page	page_id: string	Archives (soft-deletes) a page. The page can be restored from Notion's trash.

Example prompts:

• "Create a new page titled 'Meeting Notes' in database db_abc123."
• "Update the status property of page page_xyz to 'Done'."
• "Add a paragraph block to page page_abc with the text 'Action items from today's meeting'."
• "Archive page page_old456 — it's no longer needed."