mcp-notion__notion-search
Search Notion pages and databases, or look up a user by name or email. Does not search connected apps; use connector_search, when listed, for sources such as Slack, Google Drive, GitHub, mail, or calendar. When connector_search is listed, call it in parallel with search on the first search for an information need, unless the user names a source, the request is a user lookup, or the request is about Notion pages or databases themselves, such as finding a page to read or edit. Decisions, status updates, and discussions often live in connected sources. Preserve distinctive names and identifiers.
Use a non-empty query for content searches. Leave the query empty only when you also send filters or a non-relevance sort, as in the browse example below. Omit optional parameters unless needed. Do not add filters or sorting just to fill in defaults. Business or Enterprise is required for filters.edited_by_user_ids, filters.last_edited_date_range, filters.title_only=true, filters.content_status, more than one distinct … Through Royally: its server marks it read-only, so it runs straight away.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"query": "<query>"
},
"name": "mcp-notion__notion-search"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| sort | No | Result ordering for Notion workspace search. Omit for the default "relevance" ordering. "last_edited" and "created" require Business access. | |
| query | Yes | Short, specific keywords for Notion content search. For user search, enter a name or email address. Provide a non-empty query unless intentionally browsing with filters or a non-relevance sort. | |
| skill | No | For tracking only: the name of the agent skill you are following for this task, such as notion-meeting-prep. Omit if you are not following a skill. | |
| filters | No | Optional exact filters for Notion workspace search. Omit unless required by the request. Keep filter fields nested here; do not send them at the top level. Some filters require Business access. | |
| site_id | No | Site to run this tool on: ded71e55-0da4-4a52-8f14-1224fa9979b9 (https://mcp.notion.com/mcp) | |
| page_url | No | Optionally restrict keyword search to a page and its descendants. Accepts a Notion page URL or ID. | |
| page_size | No | Maximum number of results to return (default 10). Lower values reduce response size. Values outside the range (minimum 1, maximum 50) are clamped. | |
| query_type | No | Specify type of the query as either "internal" or "user". Always include this input if performing "user" search. | |
| teamspace_id | No | Optionally, provide the ID of a teamspace to restrict search results to. This will perform a search over content within the specified teamspace only. Accepts the teamspace ID (UUIDv4) with or without dashes. | |
| data_source_url | No | Optionally restrict keyword search to a data source URL returned in a <data-source> tag. | |
| instructions_version | No | Notion setup instructions version, such as 0.0.2. Omit if unknown. | |
| max_highlight_length | No | Maximum character length for result highlights (default 200). Set to 0 to omit highlights entirely. Values outside the range (minimum 0, maximum 500) are clamped. |