Search
Notion Search is a powerful AI-driven semantic search tool that enables users to efficiently search across their entire Notion workspace and multiple connected platforms like Slack, Google Drive, and Github. It supports advanced filters including date ranges and creator IDs to deliver precise, relevant results.
Features
- Performs semantic search over Notion workspace and connected sources such as Slack, Google Drive, Github, Jira, Microsoft Teams, SharePoint, OneDrive, and Linear.
- Supports filtering search results by creation date range and content creator for targeted queries.
- Enables user-specific searches by name or email within the Notion workspace.
- Allows deep search within specific pages, databases, or teamspaces through URL or ID inputs.
- Automatically falls back to workspace-only search when AI features are unavailable to maintain search functionality.
Benefits
- Streamlines information retrieval across multiple platforms integrated with Notion to boost productivity.
- Improves accuracy and relevance of search results via semantic understanding and advanced filters.
- Facilitates quick audits and content management by filtering content creators and creation dates.
- Simplifies team collaboration by enabling fast lookup of users and their contributions within the workspace.
- Enhances user experience with fallback mechanisms ensuring consistent search availability.
Description
Perform a search over:
- "internal": Semantic search over your entire Notion workspace and connected sources (Slack, Google Drive, Github, Jira, Microsoft Teams, Sharepoint, OneDrive, Linear). Supports filtering by creation date and creator.
- "user": Search for Notion users in the current workspace by name or email. When the user lacks Notion AI features, internal search automatically falls back to workspace search (without connected sources), indicated by type: "workspace_search" instead of "ai_search". After obtaining search results, use the "fetch" tool if you need the full contents of each page or database result. If you have the URL or ID of a Notion database you want to search within, you MUST first fetch the database using the "fetch" tool to get the data source (collection://...) URL from the <data-source url="..."> tag and then use that as the data_source_url parameter for search. If "fetch" shows the database has multiple data sources, do whichever of the following makes sense:
- Use whichever data source corresponds to the view the user provided in their Notion URL, when there is a ?v=... query parameter present.
- Use context from the user & data source names to identify which to use for the search
- Search all data sources for the database using separate search tool calls Do NOT try to use the database URL/ID alongside the collection:// prefix for the data_source_url. Do NOT try to use a database URL as a page URL if you know from context that it's a database and not a regular page. <example description="Search with date range filter (only documents created in 2024)">
{ "query": "quarterly revenue report", "query_type": "internal", "filters": { "created_date_range": { "start_date": "2024-01-01", "end_date": "2025-01-01" } } } </example> <example description="Search within teamspace, filtered by creator"> { "query": "project updates", "query_type": "internal", "teamspace_id": "f336d0bc-b841-465b-8045-024475c079dd", "filters": { "created_by_user_ids": ["a1b2c3d4-e5f6-7890-abcd-ef1234567890"] } } </example> <example description="Search within database pages with combined filters"> { "query": "design review feedback", "query_type": "internal", "data_source_url": "collection://f336d0bc-b841-465b-8045-024475c079dd", "filters": { "created_date_range": { "start_date": "2024-10-01" }, "created_by_user_ids": ["user-id-1", "user-id-2"] } } </example> <example description="Search for users (no filters allowed)"> { "query": "john@example.com", "query_type": "user" } </example> <common-use-cases>
- Find recent documents: Use created_date_range filter
- Find content by specific authors: Use created_by_user_ids filter
- Audit trail: Combine both filters to find who created what and when
- Team member lookup: Use query_type: "user" with name/email patterns
Parameters
6 parameters
| Name | Type | Description |
|---|---|---|
| queryrequired | string | Semantic search query over your entire Notion workspace and connected sources (Slack, Google Drive, Github, Jira, Microsoft Teams, Sharepoint, OneDrive, or Linear). For best results, don't provide more than one question per tool call. Use a separate "search" tool call for each search you want to perform. Alternatively, the query can be a substring or keyword to find users by matching against their name or email address. For example: "john" or "john@example.com" |
| query_type | enum | Specify type of the query as either "internal" or "user". Always include this input if performing "user" search. |
| data_source_url | string | Optionally, provide the URL of a Data source to search. This will perform a semantic search over the pages in the Data Source. Note: must be a Data Source, not a Database. <data-source> tags are part of the Notion flavored Markdown format returned by tools like fetch. The full spec is available in the create-pages tool description. |
| page_url | string | Optionally, provide the URL or ID of a page to search within. This will perform a semantic search over the content within and under the specified page. Accepts either a full page URL (e.g. https://notion.so/workspace/Page-Title-1234567890) or just the page ID (UUIDv4) with or without dashes. |
| teamspace_id | string | 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. |
| filters | object | Optionally provide filters to apply to the search results. Only valid when query_type is 'internal'. |
