From 32f35635c4e4d24fef6e39fbc8b9f3c56aba16a9 Mon Sep 17 00:00:00 2001 From: Lily Shen <115414357+lilyshen0722@users.noreply.github.com> Date: Sun, 18 Oct 2026 23:42:12 -0700 Subject: [PATCH 1/4] feat(connectors): add provisional Notion hosted MCP entry Co-authored-by: forge Agent-Model: codex/gpt-6-sol/medium --- .../notion-tools-list-2026-10-01.json | 10256 ++++++++++++++++ .../unit/services/hostedMcpEntry.test.js | 40 +- backend/integrations/hostedMcp/entries.ts | 5 +- backend/integrations/hostedMcp/notion.ts | 8213 +++++++++++++ 4 files changed, 18510 insertions(+), 4 deletions(-) create mode 100644 backend/__tests__/fixtures/hostedMcp/notion-tools-list-2026-10-01.json create mode 100644 backend/integrations/hostedMcp/notion.ts diff --git a/backend/__tests__/fixtures/hostedMcp/notion-tools-list-2026-10-01.json b/backend/__tests__/fixtures/hostedMcp/notion-tools-list-2026-10-01.json new file mode 100644 index 0000000000..3a02b36fad --- /dev/null +++ b/backend/__tests__/fixtures/hostedMcp/notion-tools-list-2026-10-01.json @@ -0,0 +1,10256 @@ +{ + "measuredAt": "2026-10-01T11:18:41.957Z", + "server": "https://mcp.notion.com/mcp", + "serverVersion": { + "name": "Notion MCP", + "icons": [ + { + "src": "https://mcp.notion.com/notion-logo-block-sticker.svg", + "mimeType": "image/svg+xml" + } + ], + "version": "1.2.0", + "websiteUrl": "https://developers.notion.com/docs/mcp", + "description": "Notion's official MCP server lets you use your Notion workspace as a system of record for knowledge work and software development. Search questions about the codebase and business, fetch links to pages such as tech specs and PRDs, and track tasks with your team." + }, + "requestedScope": null, + "tokenShape": { + "token_type": "bearer", + "scope": "default", + "expires_in": 28800, + "has_refresh_token": true, + "has_id_token": false, + "keys": [ + "access_token", + "expires_in", + "refresh_token", + "scope", + "token_type" + ] + }, + "count": 44, + "tools": [ + { + "name": "notion-search", + "title": "Search Notion", + "annotations": { + "readOnlyHint": true, + "destructiveHint": false, + "idempotentHint": true, + "openWorldHint": true + }, + "inputSchema": { + "type": "object", + "properties": { + "query": { + "type": "string", + "description": "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." + }, + "query_type": { + "description": "Specify type of the query as either \"internal\" or \"user\". Always include this input if performing \"user\" search.", + "type": "string", + "enum": [ + "internal", + "user" + ] + }, + "data_source_url": { + "description": "Optionally restrict keyword search to a data source URL returned in a tag.", + "type": "string" + }, + "page_url": { + "description": "Optionally restrict keyword search to a page and its descendants. Accepts a Notion page URL or ID.", + "type": "string" + }, + "teamspace_id": { + "description": "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.", + "type": "string" + }, + "filters": { + "description": "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.", + "type": "object", + "properties": { + "created_date_range": { + "description": "Optional filter to only produce search results created within the specified date range.", + "type": "object", + "properties": { + "start_date": { + "description": "The start date of the date range as an ISO 8601 date string, if any.", + "type": "string", + "format": "date", + "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$" + }, + "end_date": { + "description": "The end date of the date range as an ISO 8601 date string, if any.", + "type": "string", + "format": "date", + "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$" + } + }, + "additionalProperties": false + }, + "created_by_user_ids": { + "description": "Optional filter to only produce search results created by the Notion users that have the specified user IDs.", + "maxItems": 100, + "type": "array", + "items": { + "type": "string" + } + }, + "edited_by_user_ids": { + "description": "Optional filter to only produce search results edited by the Notion users that have the specified user IDs. Available on the Business plan.", + "maxItems": 100, + "type": "array", + "items": { + "type": "string" + } + }, + "last_edited_date_range": { + "description": "Optional filter to only produce search results last edited within the specified date range. Available on the Business plan.", + "type": "object", + "properties": { + "start_date": { + "description": "The start date of the date range as an ISO 8601 date string, if any.", + "type": "string", + "format": "date", + "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$" + }, + "end_date": { + "description": "The end date of the date range as an ISO 8601 date string, if any.", + "type": "string", + "format": "date", + "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$" + } + }, + "additionalProperties": false + }, + "teamspace_ids": { + "description": "Optional filter to only produce search results inside one of the specified teamspaces. Selecting more than one teamspace is available on the Business plan; use teamspace_id for one teamspace on other plans.", + "maxItems": 100, + "type": "array", + "items": { + "type": "string" + } + }, + "title_only": { + "description": "When true, match the query only against page and database titles instead of page content. Available on the Business plan.", + "type": "boolean" + }, + "content_status": { + "description": "Which pages to include by status. Omit for the default live pages. Supplying this field, even with the default value, requires Business access.", + "type": "string", + "enum": [ + "all_with_archived", + "all_without_archived", + "verified_only", + "archived_only" + ] + } + }, + "additionalProperties": {} + }, + "sort": { + "description": "Result ordering for Notion workspace search. Omit for the default \"relevance\" ordering. \"last_edited\" and \"created\" require Business access.", + "type": "string", + "enum": [ + "relevance", + "last_edited", + "created" + ] + }, + "page_size": { + "description": "Maximum number of results to return (default 10). Lower values reduce response size.", + "type": "integer", + "minimum": 1, + "maximum": 50 + }, + "max_highlight_length": { + "description": "Maximum character length for result highlights (default 200). Set to 0 to omit highlights entirely.", + "type": "integer", + "minimum": 0, + "maximum": 500 + } + }, + "required": [ + "query" + ], + "$schema": "https://json-schema.org/draft/2020-12/schema", + "additionalProperties": {} + }, + "outputSchema": null, + "description": "Before the first content search for this connection, call get_tool_access with {} unless its current access result is already in context. Choose the content-search tool by current_tool_access.ai_search.status, not by query wording:\n- If the" + }, + { + "name": "notion-ai-search", + "title": "AI search", + "annotations": { + "readOnlyHint": true, + "destructiveHint": false, + "idempotentHint": true, + "openWorldHint": true + }, + "inputSchema": { + "type": "object", + "properties": { + "query": { + "type": "string", + "description": "Exact keywords, a page title, a project name, or a concise natural-language question. Keywords are valid; a question is not required. Preserve distinctive names and identifiers. Prefer one topic per call, ideally under 50 words. Provide a non-empty query unless intentionally browsing Notion with filters or a non-relevance sort." + }, + "query_type": { + "description": "Omit or use \"internal\" for content search. Use \"user\" to look up a workspace user by name or email.", + "type": "string", + "enum": [ + "internal", + "user" + ] + }, + "data_source_url": { + "description": "Optionally restrict search to a data source URL returned in a tag. Omit when searching the whole workspace.", + "type": "string" + }, + "page_url": { + "description": "Optionally restrict search to a page and its descendants. Accepts a Notion page URL or ID. Omit when searching the whole workspace.", + "type": "string" + }, + "teamspace_id": { + "description": "Optionally restrict search to a teamspace ID.", + "type": "string" + }, + "filters": { + "description": "Optional exact filters for Notion pages and databases. Supplying an effective filter selects Notion-only workspace search so the filter is enforced exactly. Omit for unified search across Notion and connected sources. Keep filter fields nested here. Some filters require Business access.", + "type": "object", + "properties": { + "created_date_range": { + "description": "Optional filter to only produce search results created within the specified date range.", + "type": "object", + "properties": { + "start_date": { + "description": "The start date of the date range as an ISO 8601 date string, if any.", + "type": "string", + "format": "date", + "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$" + }, + "end_date": { + "description": "The end date of the date range as an ISO 8601 date string, if any.", + "type": "string", + "format": "date", + "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$" + } + }, + "additionalProperties": false + }, + "created_by_user_ids": { + "description": "Optional filter to only produce search results created by the Notion users that have the specified user IDs.", + "maxItems": 100, + "type": "array", + "items": { + "type": "string" + } + }, + "edited_by_user_ids": { + "description": "Optional filter to only produce search results edited by the Notion users that have the specified user IDs. Available on the Business plan.", + "maxItems": 100, + "type": "array", + "items": { + "type": "string" + } + }, + "last_edited_date_range": { + "description": "Optional filter to only produce search results last edited within the specified date range. Available on the Business plan.", + "type": "object", + "properties": { + "start_date": { + "description": "The start date of the date range as an ISO 8601 date string, if any.", + "type": "string", + "format": "date", + "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$" + }, + "end_date": { + "description": "The end date of the date range as an ISO 8601 date string, if any.", + "type": "string", + "format": "date", + "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$" + } + }, + "additionalProperties": false + }, + "teamspace_ids": { + "description": "Optional filter to only produce search results inside one of the specified teamspaces. Selecting more than one teamspace is available on the Business plan; use teamspace_id for one teamspace on other plans.", + "maxItems": 100, + "type": "array", + "items": { + "type": "string" + } + }, + "title_only": { + "description": "When true, match the query only against page and database titles instead of page content. Available on the Business plan.", + "type": "boolean" + }, + "content_status": { + "description": "Which pages to include by status. Omit for the default live pages. Supplying this field, even with the default value, requires Business access.", + "type": "string", + "enum": [ + "all_with_archived", + "all_without_archived", + "verified_only", + "archived_only" + ] + } + }, + "additionalProperties": false + }, + "sort": { + "description": "Omit for the default \"relevance\" ordering. \"last_edited\" and \"created\" select Notion-only workspace search and require Business access.", + "type": "string", + "enum": [ + "relevance", + "last_edited", + "created" + ] + }, + "page_size": { + "description": "Maximum number of results to return (default 10).", + "type": "integer", + "minimum": 1, + "maximum": 50 + }, + "max_highlight_length": { + "description": "Maximum result highlight length (default 200). Set to 0 to omit highlights.", + "type": "integer", + "minimum": 0, + "maximum": 500 + } + }, + "required": [ + "query" + ], + "$schema": "https://json-schema.org/draft/2020-12/schema", + "additionalProperties": false + }, + "outputSchema": null, + "description": "Use this tool for every content search when access discovery reports current_tool_access.ai_search.status=\"available\". This includes exact keywords, page titles, project names, and natural-language questions. Choose by the connection's acce" + }, + { + "name": "notion-get-tool-access", + "title": "Get tool access", + "annotations": { + "readOnlyHint": true, + "destructiveHint": false, + "idempotentHint": true, + "openWorldHint": false + }, + "inputSchema": { + "type": "object", + "properties": { + "tool_names": { + "description": "Optional RunTool names to include, such as search and ai_search. Omit to return all tools visible to this connection. Unknown or unexposed names are omitted. An empty list returns an empty map.", + "maxItems": 100, + "type": "array", + "items": { + "type": "string", + "minLength": 1, + "maxLength": 100 + } + } + }, + "$schema": "https://json-schema.org/draft/2020-12/schema", + "additionalProperties": false + }, + "outputSchema": null, + "description": "Get current tool availability, parameter restrictions, and available upgrade links for this Notion connection. Call with {} to get the full access map before using a conditionally available tool, unless current access is already in context." + }, + { + "name": "notion-fetch", + "title": "Fetch Notion entities", + "annotations": { + "readOnlyHint": true, + "destructiveHint": false, + "idempotentHint": true, + "openWorldHint": false + }, + "inputSchema": { + "type": "object", + "properties": { + "id": { + "type": "string", + "description": "The ID or URL of the Notion page, database, or data source to fetch. Supports notion.so URLs, Notion Sites URLs (*.notion.site), raw UUIDs, and data source URLs (collection://...). Pass a notion://docs/* URI to read that documentation resource. Also accepts an explicit saved view URL (view://...) from a database response. If a database block ID returns a validation error, use the collection:// URL from that error. Example: notion://docs/enhanced-markdown-spec." + }, + "include_transcript": { + "description": "Whether to include meeting note transcripts. Defaults to false. When true, full transcripts are included; when false, a placeholder with the meeting note URL is shown instead.", + "type": "boolean" + }, + "include_discussions": { + "description": "Whether to include discussion/comment indicators in the page output. When true, adds a summary with discussion count, preview snippets, and discussion:// URLs. Use with the get_comments tool to retrieve full discussion content. Defaults to false.", + "type": "boolean" + } + }, + "required": [ + "id" + ], + "$schema": "https://json-schema.org/draft/2020-12/schema", + "additionalProperties": {} + }, + "outputSchema": null, + "description": "Retrieves details about a Notion entity (page, database, data source, or saved database view) by URL or ID.\n\nProvide a URL or ID in `id`. Make multiple calls for multiple entities.\n\nFor pages, use path, verification, edit time, and truncati" + }, + { + "name": "notion-create-attachment", + "title": "Create a Notion attachment", + "annotations": { + "readOnlyHint": false, + "destructiveHint": false, + "idempotentHint": false, + "openWorldHint": true + }, + "inputSchema": { + "type": "object", + "properties": { + "filename": { + "description": "The filename to create in Notion, including a supported extension such as .html, .md, .pdf, or .png. Required with content and source_url. Omit it with source_file_id; the stored upload already carries a filename.", + "type": "string", + "minLength": 1 + }, + "content_type": { + "description": "Optional MIME type, such as text/html or application/pdf. It must match the filename extension; omit it to infer the type from the filename. Omit it with source_file_id; the stored upload already carries a content type.", + "type": "string", + "minLength": 1, + "maxLength": 255 + }, + "content": { + "description": "The complete UTF-8 text content of the file. Maximum 200 KiB after UTF-8 encoding. Requires filename. Examples:

Report

 or # Notes\n\nHello.", + "type": "string", + "maxLength": 204800 + }, + "source_url": { + "description": "A direct, publicly reachable HTTPS URL from which Notion can download the file within one minute. Notion makes a metadata-only HEAD request when supported, then a GET. Redirects, private network addresses, custom request headers, and cookies are not supported. Downloads are limited to 5 MiB for free workspaces and 50 MiB for paid workspaces. Requires filename. Example: https://storage.example.com/report.pdf?signature=....", + "type": "string", + "minLength": 1, + "maxLength": 8192 + }, + "source_file_id": { + "description": "The ID of a file upload this exact integration already created. Use create_file_upload when available; otherwise run `ntn files create` or use the Notion File Upload API with this integration's token. Its status must be uploaded. An upload created with a different token is not visible. Example: 1e2f3a4b-5c6d-7e8f-9a0b-1c2d3e4f5a6b.", + "type": "string", + "minLength": 1, + "maxLength": 36 + } + }, + "$schema": "https://json-schema.org/draft/2020-12/schema", + "additionalProperties": {} + }, + "outputSchema": null, + "description": "Create an attachment and upload it to Notion.\n\nProvide exactly one source:\n- content for small UTF-8 text artifacts such as HTML, Markdown, plain text, CSV, JSON, XML, CSS, YAML, TSV, calendar, GPX, or SVG files.\n- source_url for a direct, " + }, + { + "name": "notion-create-file-upload", + "title": "Create a file upload URL", + "annotations": { + "readOnlyHint": false, + "destructiveHint": false, + "idempotentHint": false, + "openWorldHint": true + }, + "inputSchema": { + "type": "object", + "properties": { + "filename": { + "type": "string", + "minLength": 1, + "description": "The filename to create in Notion, including a supported extension such as .pdf, .png, or .zip." + }, + "content_type": { + "description": "Optional MIME type, such as application/pdf or image/png. Prefer omitting it so the type is inferred from the filename: a type that disagrees with the extension is stored as given, and the file then renders as the wrong kind.", + "type": "string", + "minLength": 1, + "maxLength": 255 + } + }, + "required": [ + "filename" + ], + "$schema": "https://json-schema.org/draft/2020-12/schema", + "additionalProperties": false + }, + "outputSchema": null, + "description": "Create a short-lived URL for uploading one local file directly to Notion.\n\nAfter calling this tool, send exactly one multipart/form-data POST request to `upload_url`. Put the file in the `file` form field and include every header returned i" + }, + { + "name": "notion-download-attachment", + "title": "Download a Notion text attachment", + "annotations": { + "readOnlyHint": true, + "destructiveHint": false, + "idempotentHint": true, + "openWorldHint": false + }, + "inputSchema": { + "type": "object", + "properties": { + "file_upload_id": { + "type": "string", + "description": "The FileUpload ID returned by the create-attachment tool." + } + }, + "required": [ + "file_upload_id" + ], + "$schema": "https://json-schema.org/draft/2020-12/schema", + "additionalProperties": {} + }, + "outputSchema": null, + "description": "Download the contents of a small UTF-8 text attachment created by the Notion MCP `create-attachment` tool.\n\nPass the `file_upload_id` returned by `create-attachment`. The attachment must belong to the requesting integration, have completed " + }, + { + "name": "notion-create-pages", + "title": "Create pages in Markdown", + "annotations": { + "readOnlyHint": false, + "destructiveHint": false, + "idempotentHint": false, + "openWorldHint": false + }, + "inputSchema": { + "type": "object", + "properties": { + "pages": { + "description": "The pages to create.", + "maxItems": 100, + "type": "array", + "items": { + "type": "object", + "properties": { + "properties": { + "description": "The properties of the new page, which is a JSON map of property names to SQLite values.\nFor pages in a database, use the SQLite schema definition shown in .\nFor pages outside of a database, the only allowed property is \"title\", which is the title of the page and is automatically shown at the top of the page as a large heading.\n**IMPORTANT**: Some property types require specific formats:\n- Date properties: Split into \"date:{property}:start\", \"date:{property}:end\" (optional), and \"date:{property}:is_datetime\" (0 or 1)\n- Place properties: Split into \"place:{property}:name\", \"place:{property}:address\", \"place:{property}:latitude\", \"place:{property}:longitude\", and \"place:{property}:google_place_id\" (optional)\n- Number properties: Use JavaScript numbers (not strings)\n- Checkbox properties: Use \"__YES__\" for checked, \"__NO__\" for unchecked\n- Relation properties: Use an array of related page URLs or page IDs, e.g. [\"https://www.notion.so/26ab1f9f4c5f80b18d3bd10a6b1d2f4e\", \"26ab1f9f-4c5f-80b1-8d3b-d10a6b1d2f4e\"]\n- Person properties: Use an array of user IDs, user or agent URLs, or group references copied from fetch output (\"space_permission_group-\"). Bare group UUIDs are also supported.\n- Files properties: Use a JSON array of file IDs, Notion Folder URLs, and/or tags copied from fetch output. Folders are stored as native Folder references, not ordinary links.\n\n\n**Special property naming**: Properties named \"id\" or \"url\" (case insensitive) must be prefixed with \"userDefined:\" (e.g., \"userDefined:URL\", \"userDefined:id\")", + "type": "object", + "propertyNames": { + "type": "string" + }, + "additionalProperties": { + "anyOf": [ + { + "type": "string" + }, + { + "type": "number" + }, + { + "maxItems": 100, + "type": "array", + "items": { + "type": "string" + } + }, + { + "type": "null" + } + ] + } + }, + "content": { + "description": "The content of the new page, using Notion Markdown. For people and dates, use user and date mentions rather than plain text; notion://docs/enhanced-markdown-spec gives the syntax.", + "type": "string" + }, + "template_id": { + "description": "The ID of a template to apply to this page. When specified, do not provide 'content' as the template will provide it. Properties can still be set alongside the template. Get template IDs from the section in the fetch tool results. Template application is asynchronous: the page starts blank and content appears shortly after.", + "type": "string" + }, + "icon": { + "description": "An emoji character (e.g. \"\ud83d\ude80\"), a custom emoji by name (e.g. \":rocket_ship:\"), a Notion icon identifier as returned by fetch (e.g. \"icons/pizza_blue\"), or an external image URL. Use \"none\" to explicitly set no icon. Omit to leave unchanged. Keep the title free of a duplicate leading emoji because the icon renders separately.", + "type": "string" + }, + "cover": { + "description": "An external image URL for the page cover. Use \"none\" to explicitly set no cover. Omit to leave unchanged.", + "type": "string" + }, + "is_skill": { + "description": "Set to true only when the user asks for reusable instructions or a repeatable workflow. Do not mark ordinary reference pages, one-time documents, or drafts as skills. Before creating a skill, read the MCP resource `notion://docs/skills` through your MCP client's resource-reading interface. If your client does not support reading MCP resources, call the Notion \"fetch\" tool with this URI instead. Do NOT pass this URI to any other URL-fetching tool. False has the same effect as omitting the field.", + "type": "boolean" + }, + "preserve_internal_links": { + "description": "Preserve internal Markdown links instead of converting them to native mentions.", + "type": "boolean" + } + }, + "additionalProperties": false + } + }, + "creation_mode": { + "description": "If the user explicitly names a private or shared destination, omit \"creation_mode\" and use that parent. Otherwise, use \"draft\" when the user clearly wants a durable page but has not named a destination. Prefer this explicit draft mode over omitting the parent. Draft mode is server-enforced: it creates a private workspace-level page and cannot be combined with \"parent\". Create it without first asking where it should live. After creation, tell the user it is private and offer to move it once they name a destination.", + "type": "string", + "enum": [ + "draft" + ] + }, + "parent": { + "description": "All pages in one call share this parent. Otherwise use a page (page_id), database page (database_id), or data source (data_source_id). A database_id cannot be used when the database has more than one data source; fetch it and use the right collection:// URL as data_source_id. If omitted, pages are private at the workspace level. When no destination is named, prefer explicit \"creation_mode\": \"draft\" over omitting the parent.", + "anyOf": [ + { + "type": "object", + "properties": { + "page_id": { + "type": "string", + "description": "The ID of the parent page (with or without dashes), for example, 195de9221179449fab8075a27c979105" + }, + "type": { + "description": "Always `page_id`", + "type": "string", + "enum": [ + "page_id" + ] + } + }, + "required": [ + "page_id" + ], + "additionalProperties": {} + }, + { + "type": "object", + "properties": { + "database_id": { + "type": "string", + "description": "The ID of the parent database (with or without dashes), for example, 195de9221179449fab8075a27c979105" + }, + "type": { + "description": "Always `database_id`", + "type": "string", + "enum": [ + "database_id" + ] + } + }, + "required": [ + "database_id" + ], + "additionalProperties": {} + }, + { + "type": "object", + "properties": { + "data_source_id": { + "type": "string", + "description": "The ID of the parent data source (collection), with or without dashes. For example, f336d0bc-b841-465b-8045-024475c079dd" + }, + "type": { + "description": "Always `data_source_id`", + "type": "string", + "enum": [ + "data_source_id" + ] + } + }, + "required": [ + "data_source_id" + ], + "additionalProperties": {} + } + ] + }, + "allow_async": { + "description": "Default to true for page creation. Set to false only when the next step needs the created pages immediately, or when async execution rejects the request as too large. When this create operation is accepted for background execution, it returns an async_task result. Use get_async_task to wait for a succeeded status before taking a dependent action on the pages. For pages created with template_id, a succeeded status does not mean template content is ready; fetch and retry until it is ready before changing or relying on that content. If omitted or false, the tool keeps the existing synchronous result shape.", + "type": "boolean" + } + }, + "required": [ + "pages" + ], + "$schema": "https://json-schema.org/draft/2020-12/schema", + "additionalProperties": {} + }, + "outputSchema": null, + "description": "Creates one or more Notion pages with the specified properties and content.\n\n## Core rules\n\n**IMPORTANT**: Before writing page content, read the MCP resource `notion://docs/enhanced-markdown-spec` through your MCP client's resource-reading " + }, + { + "name": "notion-update-page", + "title": "Update Notion page", + "annotations": { + "readOnlyHint": false, + "destructiveHint": true, + "idempotentHint": false, + "openWorldHint": false + }, + "inputSchema": { + "type": "object", + "properties": { + "page_id": { + "type": "string", + "description": "The ID of the page to update, with or without dashes." + }, + "command": { + "type": "string", + "enum": [ + "update_properties", + "update_content", + "replace_content", + "insert_content", + "apply_template", + "update_verification" + ], + "description": "The update command to execute." + }, + "properties": { + "description": "Required for \"update_properties\" command. A JSON object that updates the page's properties.\nFor pages in a database, fetch the page or its data source first and use the exact property names and SQLite schema definition shown in .\nFor pages outside of a database, the only allowed property is \"title\", which is the title of the page in inline markdown format.\nFor a Files property, an uploaded file can be provided as {\"type\":\"file_upload\",\"file_upload\":{\"id\":\"\"}} inside the property's array.\nUse null to remove a property's value.\n**IMPORTANT**: Some property types require specific formats:\n- Date properties: Split into \"date:{property}:start\", \"date:{property}:end\" (optional), and \"date:{property}:is_datetime\" (0 or 1)\n- Place properties: Split into \"place:{property}:name\", \"place:{property}:address\", \"place:{property}:latitude\", \"place:{property}:longitude\", and \"place:{property}:google_place_id\" (optional)\n- Number properties: Use JavaScript numbers (not strings)\n- Checkbox properties: Use \"__YES__\" for checked, \"__NO__\" for unchecked\n- Relation properties: Use an array of related page URLs or page IDs, e.g. [\"https://www.notion.so/26ab1f9f4c5f80b18d3bd10a6b1d2f4e\", \"26ab1f9f-4c5f-80b1-8d3b-d10a6b1d2f4e\"]\n- Person properties: Use an array of user IDs, user or agent URLs, or group references copied from fetch output (\"space_permission_group-\"). Bare group UUIDs are also supported.\n- Files properties: Use a JSON array of file IDs, Notion Folder URLs, and/or tags copied from fetch output. Folders are stored as native Folder references, not ordinary links.\n\n\n**Special property naming**: Properties named \"id\" or \"url\" (case insensitive) must be prefixed with \"userDefined:\" (e.g., \"userDefined:URL\", \"userDefined:id\")", + "type": "object", + "propertyNames": { + "type": "string" + }, + "additionalProperties": { + "anyOf": [ + { + "type": "string" + }, + { + "type": "number" + }, + { + "maxItems": 100, + "type": "array", + "items": { + "anyOf": [ + { + "type": "string" + }, + { + "type": "object", + "properties": { + "type": { + "type": "string", + "enum": [ + "file_upload" + ], + "description": "Always `file_upload`" + }, + "file_upload": { + "type": "object", + "properties": { + "id": { + "type": "string", + "description": "ID of a file upload returned by create_file_upload or create_attachment." + } + }, + "required": [ + "id" + ], + "additionalProperties": {}, + "description": "The uploaded file to attach to the Files property." + } + }, + "required": [ + "type", + "file_upload" + ], + "additionalProperties": {} + } + ] + } + }, + { + "type": "null" + } + ] + } + }, + "new_str": { + "description": "Required for \"replace_content\" command. The new content string to replace the entire page content with. Preserve child pages and databases with their exact fetched or tags. For people and dates, use user and date mentions rather than plain text; notion://docs/enhanced-markdown-spec gives the syntax.", + "type": "string" + }, + "content": { + "description": "Required for \"insert_content\" command. The markdown content to insert into the page. For people and dates, use user and date mentions rather than plain text; notion://docs/enhanced-markdown-spec gives the syntax.", + "type": "string" + }, + "content_updates": { + "description": "Required for \"update_content\" command. An array of search-and-replace operations, each with old_str (content to find) and new_str (replacement content).", + "maxItems": 100, + "type": "array", + "items": { + "type": "object", + "properties": { + "old_str": { + "type": "string", + "minLength": 1, + "description": "The existing content string to find and replace. Must exactly match the page content." + }, + "new_str": { + "type": "string", + "description": "The new content string to replace old_str with. For people and dates, use user and date mentions rather than plain text; notion://docs/enhanced-markdown-spec gives the syntax." + }, + "replace_all_matches": { + "description": "If true, replaces all occurrences of old_str. If false (default), the operation fails if there are multiple matches.", + "type": "boolean" + } + }, + "required": [ + "old_str", + "new_str" + ], + "additionalProperties": {} + } + }, + "position": { + "description": "Optional for \"insert_content\" command. Use {\"type\":\"start\"} to prepend content or {\"type\":\"end\"} to append content. Omit to append.", + "anyOf": [ + { + "type": "object", + "properties": { + "type": { + "type": "string", + "enum": [ + "start" + ], + "description": "Insert the content at the start of the page." + } + }, + "required": [ + "type" + ], + "additionalProperties": {} + }, + { + "type": "object", + "properties": { + "type": { + "type": "string", + "enum": [ + "end" + ], + "description": "Insert the content at the end of the page." + } + }, + "required": [ + "type" + ], + "additionalProperties": {} + } + ] + }, + "allow_deleting_content": { + "description": "Optional for \"replace_content\" and \"update_content\" commands. Set to true to allow deletion of child pages and databases that are not referenced in the new content. If false or omitted, the operation will fail with an error listing the pages/databases that would be deleted. Show that list and ask the user for confirmation before retrying with true.", + "type": "boolean" + }, + "template_id": { + "description": "Required for \"apply_template\" command. The ID of a template to apply to this page; any page ID can be used as a template. Template content is appended to any existing page content asynchronously.", + "type": "string" + }, + "verification_status": { + "description": "Required for \"update_verification\" command. Set to \"verified\" to mark the page as verified, or \"unverified\" to remove verification. Requires a Business or Enterprise plan unless the page is in a wiki. When updating verification, the owner will be automatically set to the authenticated actor.", + "type": "string", + "enum": [ + "verified", + "unverified" + ] + }, + "verification_expiry_days": { + "description": "Optional for \"update_verification\" command when verification_status is \"verified\". Number of days until verification expires (e.g. 7, 30, 90). Omit for indefinite verification.", + "type": "integer", + "minimum": 1, + "maximum": 9007199254740991 + }, + "icon": { + "description": "An emoji character (e.g. \"\ud83d\ude80\"), a custom emoji by name (e.g. \":rocket_ship:\"), a Notion icon identifier as returned by fetch (e.g. \"icons/pizza_blue\"), or an external image URL. Use \"none\" to remove the icon. Omit to leave unchanged. Can be set alongside any command. Keep the title free of a duplicate leading emoji because the icon renders separately.", + "type": "string" + }, + "cover": { + "description": "An external image URL for the page cover. Use \"none\" to remove the cover. Omit to leave unchanged. Can be set alongside any command.", + "type": "string" + }, + "is_skill": { + "description": "Set to true to mark this page as a skill, or false to remove the skill designation. Can be set alongside any command. To change only skill status, use \"update_properties\" and omit \"properties\".", + "type": "boolean" + }, + "allow_async": { + "description": "Default to true for page updates. Set to false only when the next step needs the updated page immediately, or when async execution rejects the request as too large. When this update operation is accepted for background execution, it returns an async_task result. Use get_async_task to wait for a succeeded status before taking a dependent action on the page. For apply_template, a succeeded status does not mean template content is ready; fetch and retry until it is ready before changing or relying on that content. If omitted or false, the tool waits for a synchronous result when possible, but may still return a pollable async_task response if queued execution exceeds the synchronous wait deadline.", + "type": "boolean" + } + }, + "required": [ + "page_id", + "command" + ], + "$schema": "https://json-schema.org/draft/2020-12/schema", + "additionalProperties": {} + }, + "outputSchema": null, + "description": "Update a Notion page's properties or content.\n\n## Core rules\n\n**IMPORTANT**: Before writing page content, read the MCP resource `notion://docs/enhanced-markdown-spec` through your MCP client's resource-reading interface, or call the Notion " + }, + { + "name": "notion-convert-page-to-skill", + "title": "Convert Notion page to skill", + "annotations": { + "readOnlyHint": false, + "destructiveHint": false, + "idempotentHint": true, + "openWorldHint": false + }, + "inputSchema": { + "type": "object", + "properties": { + "page_url": { + "type": "string", + "minLength": 1, + "maxLength": 2000, + "description": "The full Notion URL of the page to mark as a skill." + } + }, + "required": [ + "page_url" + ], + "$schema": "https://json-schema.org/draft/2020-12/schema", + "additionalProperties": {} + }, + "outputSchema": null, + "description": "Mark an existing Notion page as a skill without changing its content. The page must be in the current workspace, and the authenticated user must have permission to edit it. Use this tool only when the user wants the page's current contents " + }, + { + "name": "notion-upload-skill", + "title": "Upload a Notion Skill", + "annotations": { + "readOnlyHint": false, + "destructiveHint": true, + "idempotentHint": false, + "openWorldHint": false + }, + "inputSchema": { + "type": "object", + "properties": { + "action": { + "type": "string", + "enum": [ + "prepare", + "complete" + ], + "description": "Prepare an upload or complete a previously uploaded archive." + }, + "page_id": { + "type": "string", + "format": "uuid", + "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", + "description": "Target page in a Skills database. Create a new page first to import a new skill." + }, + "content_length": { + "description": "Required for prepare. Exact compressed archive size in bytes (maximum 20 MiB).", + "type": "integer", + "minimum": 1, + "maximum": 20971520 + }, + "checksum_crc32": { + "description": "Required for prepare. Base64-encoded big-endian CRC32 of the tar.gz bytes; S3 verifies it on upload.", + "type": "string" + }, + "upload_token": { + "description": "Required for complete. Opaque token from prepare. Bound to the integration, workspace, and page; expires after ten minutes.", + "type": "string", + "minLength": 1, + "maxLength": 16384 + } + }, + "required": [ + "action", + "page_id" + ], + "$schema": "https://json-schema.org/draft/2020-12/schema", + "additionalProperties": false + }, + "outputSchema": null, + "description": "Import a spec-compliant Agent Skills directory into a page in a Skills database. First call action=prepare with page_id and the exact tar.gz content_length and checksum_crc32. PUT the raw archive bytes to upload_url with all upload_headers," + }, + { + "name": "notion-download-skill", + "title": "Download a Notion Skill", + "annotations": { + "readOnlyHint": true, + "destructiveHint": false, + "idempotentHint": true, + "openWorldHint": false + }, + "inputSchema": { + "type": "object", + "properties": { + "id": { + "type": "string", + "description": "Identifier for a Notion skill page." + } + }, + "required": [ + "id" + ], + "$schema": "https://json-schema.org/draft/2020-12/schema", + "additionalProperties": false + }, + "outputSchema": null, + "description": "Download a spec-compliant Notion Skill as a complete tar.gz archive containing SKILL.md and its supporting files and nested folders. Pass the skill page ID. Returns a temporary signed url. Download and extract the archive to read or use the" + }, + { + "name": "notion-move-pages", + "title": "Move Notion pages", + "annotations": { + "readOnlyHint": false, + "destructiveHint": false, + "idempotentHint": true, + "openWorldHint": false + }, + "inputSchema": { + "type": "object", + "properties": { + "page_or_database_ids": { + "description": "An array of up to 100 page or database IDs to move. IDs are v4 UUIDs and can be supplied with or without dashes (e.g. extracted from a or URL given by the \"search\" or \"fetch\" tool). Data Sources under Databases can't be moved individually.", + "minItems": 1, + "maxItems": 100, + "type": "array", + "items": { + "type": "string" + } + }, + "new_parent": { + "description": "The new parent under which the pages will be moved. This can be a page, the workspace, a database, or a specific data source under a database when there are multiple. Moving pages to the workspace level adds them as private pages and should rarely be used.", + "anyOf": [ + { + "type": "object", + "properties": { + "page_id": { + "type": "string", + "description": "The ID of the parent page (with or without dashes), for example, 195de9221179449fab8075a27c979105" + }, + "type": { + "description": "Always `page_id`", + "type": "string", + "enum": [ + "page_id" + ] + } + }, + "required": [ + "page_id" + ], + "additionalProperties": {} + }, + { + "type": "object", + "properties": { + "database_id": { + "type": "string", + "description": "The ID of the parent database (with or without dashes), for example, 195de9221179449fab8075a27c979105" + }, + "type": { + "description": "Always `database_id`", + "type": "string", + "enum": [ + "database_id" + ] + } + }, + "required": [ + "database_id" + ], + "additionalProperties": {} + }, + { + "type": "object", + "properties": { + "data_source_id": { + "type": "string", + "description": "The ID of the parent data source (collection), with or without dashes. For example, f336d0bc-b841-465b-8045-024475c079dd" + }, + "type": { + "description": "Always `data_source_id`", + "type": "string", + "enum": [ + "data_source_id" + ] + } + }, + "required": [ + "data_source_id" + ], + "additionalProperties": {} + }, + { + "type": "object", + "properties": { + "type": { + "type": "string", + "enum": [ + "workspace" + ], + "description": "The parent type." + } + }, + "required": [ + "type" + ], + "additionalProperties": {} + } + ] + } + }, + "required": [ + "page_or_database_ids", + "new_parent" + ], + "$schema": "https://json-schema.org/draft/2020-12/schema", + "additionalProperties": {} + }, + "outputSchema": null, + "description": "Move one or more Notion pages or databases to a new parent." + }, + { + "name": "notion-duplicate-page", + "title": "Duplicate Notion page", + "annotations": { + "readOnlyHint": false, + "destructiveHint": false, + "idempotentHint": false, + "openWorldHint": false + }, + "inputSchema": { + "type": "object", + "properties": { + "page_id": { + "type": "string", + "description": "The ID of the page to duplicate. This is a v4 UUID, with or without dashes, and can be parsed from a Notion page URL." + } + }, + "required": [ + "page_id" + ], + "$schema": "https://json-schema.org/draft/2020-12/schema", + "additionalProperties": {} + }, + "outputSchema": null, + "description": "Duplicate a Notion page. The page must be within the current workspace, and you must have permission to access it. The duplication completes asynchronously, so do not rely on the new page identified by the returned ID or URL to be populated" + }, + { + "name": "notion-create-database", + "title": "Create Notion database", + "annotations": { + "readOnlyHint": false, + "destructiveHint": false, + "idempotentHint": false, + "openWorldHint": false + }, + "inputSchema": { + "type": "object", + "properties": { + "parent": { + "description": "The parent under which to create the new database. If omitted, the database will be created as a private page at the workspace level.", + "type": "object", + "properties": { + "page_id": { + "type": "string", + "description": "The ID of the parent page, with or without dashes." + }, + "type": { + "description": "Always `page_id`", + "type": "string", + "enum": [ + "page_id" + ] + } + }, + "required": [ + "page_id" + ], + "additionalProperties": {} + }, + "title": { + "description": "The title of the new database.", + "type": "string" + }, + "description": { + "description": "The description of the new database.", + "type": "string" + }, + "schema": { + "description": "SQL DDL CREATE TABLE statement defining the database schema. Cannot be combined with database_type. Column names must be double-quoted and type options use single quotes.\n\nProperty type syntax:\n- Simple: TITLE, RICH_TEXT, DATE, PEOPLE, CHECKBOX, URL, EMAIL, PHONE_NUMBER, STATUS, FILES\n- SELECT('opt':color, ...) / MULTI_SELECT('opt':color, ...)\n- NUMBER [FORMAT 'dollar'] / FORMULA('expression')\n- RELATION('ds') for a one-way relation\n- RELATION('ds', DUAL) for a two-way relation\n- RELATION('ds', DUAL 'Children') with a synced property name\n- RELATION('ds', DUAL 'Children' 'children') with a synced name and synced_id (for self-relations)\n- ROLLUP('rel_prop', 'target_prop', 'function')\n- UNIQUE_ID [PREFIX 'X'] / CREATED_TIME / LAST_EDITED_TIME\n- Any column: COMMENT 'description text' Colors: default, gray, brown, orange, yellow, green, blue, purple, pink, red.\n\n\nExamples:\n- Minimal: CREATE TABLE (\"Name\" TITLE)\n- With options: CREATE TABLE (\"Name\" TITLE, \"Budget\" NUMBER FORMAT 'dollar', \"Tags\" MULTI_SELECT('eng':blue, 'design':pink), \"Task ID\" UNIQUE_ID PREFIX 'PRJ')\n- Self-relations are a two-step flow: create the database, then use its data source ID with update_data_source to add paired properties such as RELATION('ds', DUAL 'Children' 'children').", + "type": "string" + }, + "database_type": { + "description": "Create a canonical typed database with Notion's required properties and metadata. Supported types: tasks, projects, skills. Example: tasks. Use title \"Tasks\" when needed.", + "type": "string", + "enum": [ + "tasks", + "projects", + "skills" + ] + } + }, + "$schema": "https://json-schema.org/draft/2020-12/schema", + "additionalProperties": {} + }, + "outputSchema": null, + "description": "Creates a new Notion database using SQL DDL syntax, or a canonical typed database for tasks, projects, or skills.\n\nProvide exactly one of:\n- schema: a CREATE TABLE statement. If no title property is provided, \"Name\" is auto-added.\n- databas" + }, + { + "name": "notion-create-folder", + "title": "Create Notion folder", + "annotations": { + "readOnlyHint": false, + "destructiveHint": false, + "idempotentHint": false, + "openWorldHint": false + }, + "inputSchema": { + "type": "object", + "properties": { + "parent": { + "description": "Where to create the Folder.", + "anyOf": [ + { + "type": "object", + "properties": { + "page_id": { + "type": "string", + "description": "The ID of the page that will own the Folder." + } + }, + "required": [ + "page_id" + ], + "additionalProperties": false + }, + { + "type": "object", + "properties": { + "folder_id": { + "type": "string", + "description": "The ID of the Folder that will contain the new Folder." + } + }, + "required": [ + "folder_id" + ], + "additionalProperties": false + } + ] + }, + "title": { + "type": "string", + "description": "The title of the new Folder." + } + }, + "required": [ + "parent", + "title" + ], + "$schema": "https://json-schema.org/draft/2020-12/schema", + "additionalProperties": {} + }, + "outputSchema": null, + "description": "Creates an empty Notion Folder. Set parent.page_id for a top-level Folder owned by a page, or parent.folder_id to create a nested Folder inside another Folder. A page-owned Folder is not inserted into the page's content. A nested Folder is " + }, + { + "name": "notion-update-folder", + "title": "Update Notion folder", + "annotations": { + "readOnlyHint": false, + "destructiveHint": true, + "idempotentHint": false, + "openWorldHint": false + }, + "inputSchema": { + "type": "object", + "properties": { + "folder_id": { + "type": "string", + "description": "The ID of the Folder to update." + }, + "command": { + "type": "string", + "enum": [ + "add_files", + "remove_files", + "add_subfolder" + ], + "description": "The Folder update to apply." + }, + "file_upload_ids": { + "description": "Required for add_files. One or more file upload IDs returned by the file upload tools.", + "minItems": 1, + "maxItems": 100, + "type": "array", + "items": { + "type": "string" + } + }, + "file_urls": { + "description": "Required for remove_files. The exact file URLs shown in the Folder's latest fetch output.", + "minItems": 1, + "maxItems": 100, + "type": "array", + "items": { + "type": "string" + } + }, + "title": { + "description": "Required for add_subfolder. The new Folder's title.", + "type": "string" + } + }, + "required": [ + "folder_id", + "command" + ], + "$schema": "https://json-schema.org/draft/2020-12/schema", + "additionalProperties": false + }, + "outputSchema": null, + "description": "Update an existing Notion Folder with an explicit Folder operation.\n\n- Use add_files with file upload IDs returned by the upload tools.\n- Fetch the Folder first, then use remove_files with the exact file URLs from that fetch result.\n- Use a" + }, + { + "name": "notion-update-data-source", + "title": "Update Notion data source", + "annotations": { + "readOnlyHint": false, + "destructiveHint": true, + "idempotentHint": false, + "openWorldHint": false + }, + "inputSchema": { + "type": "object", + "properties": { + "data_source_id": { + "type": "string", + "description": "The data source to update. Accepts a collection:// URI from tags, a bare UUID, or a database ID (only if the database has a single data source)." + }, + "statements": { + "description": "Semicolon-separated SQL DDL statements to update the schema. Supports ADD COLUMN, DROP COLUMN, RENAME COLUMN, and ALTER COLUMN SET.\n\nProperty type syntax:\n- Simple: TITLE, RICH_TEXT, DATE, PEOPLE, CHECKBOX, URL, EMAIL, PHONE_NUMBER, STATUS, FILES\n- SELECT('opt':color, ...) / MULTI_SELECT('opt':color, ...)\n- NUMBER [FORMAT 'dollar'] / FORMULA('expression')\n- RELATION('ds') for a one-way relation\n- RELATION('ds', DUAL) for a two-way relation\n- RELATION('ds', DUAL 'Children') with a synced property name\n- RELATION('ds', DUAL 'Children' 'children') with a synced name and synced_id (for self-relations)\n- ROLLUP('rel_prop', 'target_prop', 'function')\n- UNIQUE_ID [PREFIX 'X'] / CREATED_TIME / LAST_EDITED_TIME\n- Any column: COMMENT 'description text' Colors: default, gray, brown, orange, yellow, green, blue, purple, pink, red.\n\n\nExamples:\n- ADD COLUMN \"Priority\" SELECT('High':red, 'Medium':yellow, 'Low':green); ADD COLUMN \"Due Date\" DATE\n- RENAME COLUMN \"Status\" TO \"Project Status\"\n- DROP COLUMN \"Old Property\"\n- For a self-relation, add both relation properties in one call with matching DUAL names and IDs, such as ADD COLUMN \"Parent\" RELATION('ds', DUAL 'Children' 'children').", + "type": "string" + }, + "title": { + "description": "The new title of the data source.", + "type": "string" + }, + "description": { + "description": "The new description of the data source.", + "type": "string" + }, + "is_inline": { + "description": "Whether the database should display inline (true) or as full page (false). Only applicable for single-source databases.", + "type": "boolean" + }, + "in_trash": { + "description": "Move data source to trash. Cannot be undone without Notion UI.", + "type": "boolean" + }, + "page_layout": { + "description": "Replaces the data source's page layout. Refer to existing properties by name. See notion://docs/database-page-layouts. Example: {\"main\":[{\"type\":\"title\",\"pinnedProperties\":[\"Status\",\"Owner\"]},{\"type\":\"editor\"},{\"type\":\"discussions\"}],\"sidebar\":[{\"type\":\"properties\"}]}.", + "type": "object", + "properties": { + "main": { + "type": "array", + "items": { + "anyOf": [ + { + "type": "object", + "properties": { + "type": { + "type": "string", + "enum": [ + "cover", + "properties", + "editor", + "discussions", + "relations", + "backlinks", + "page_sections", + "bottom_controls" + ], + "description": "The module type." + } + }, + "required": [ + "type" + ], + "additionalProperties": false + }, + { + "type": "object", + "properties": { + "type": { + "type": "string", + "enum": [ + "title" + ], + "description": "The module type." + }, + "pinnedProperties": { + "description": "Property names to show under the title.", + "type": "array", + "items": { + "type": "string" + } + }, + "propertyLabels": { + "description": "Whether pinned properties show their names.", + "type": "string", + "enum": [ + "show", + "hide" + ] + } + }, + "required": [ + "type" + ], + "additionalProperties": false + }, + { + "type": "object", + "properties": { + "type": { + "type": "string", + "enum": [ + "property" + ], + "description": "The module type." + }, + "property": { + "type": "string", + "description": "The name of the property to show." + }, + "config": { + "description": "How the property looks.", + "type": "object", + "properties": { + "style": { + "type": "string", + "enum": [ + "compact", + "large", + "small", + "landscape", + "portrait", + "square", + "map", + "text" + ], + "description": "Display style. Which styles apply depends on the property type." + } + }, + "required": [ + "style" + ], + "additionalProperties": false + } + }, + "required": [ + "type", + "property" + ], + "additionalProperties": false + }, + { + "type": "object", + "properties": { + "type": { + "type": "string", + "enum": [ + "views" + ], + "description": "The module type." + }, + "relation": { + "type": "string", + "description": "The name of a two-way relation property whose related pages show as a view." + } + }, + "required": [ + "type", + "relation" + ], + "additionalProperties": false + } + ] + }, + "description": "Main area modules in order. Include a title, an editor (unless the layout has a tab), and discussions." + }, + "sidebar": { + "description": "Sidebar modules in order. Only properties and property modules are allowed.", + "type": "array", + "items": { + "anyOf": [ + { + "type": "object", + "properties": { + "type": { + "type": "string", + "enum": [ + "properties" + ], + "description": "The module type." + } + }, + "required": [ + "type" + ], + "additionalProperties": false + }, + { + "type": "object", + "properties": { + "type": { + "type": "string", + "enum": [ + "property" + ], + "description": "The module type." + }, + "property": { + "type": "string", + "description": "The name of the property to show." + }, + "config": { + "description": "How the property looks.", + "type": "object", + "properties": { + "style": { + "type": "string", + "enum": [ + "compact", + "large", + "small", + "landscape", + "portrait", + "square", + "map", + "text" + ], + "description": "Display style. Which styles apply depends on the property type." + } + }, + "required": [ + "style" + ], + "additionalProperties": false + } + }, + "required": [ + "type", + "property" + ], + "additionalProperties": false + } + ] + } + }, + "tab": { + "description": "Puts page content in a tab next to database views. Omit for a simple layout.", + "type": "object", + "properties": { + "id": { + "description": "The existing tab ID from fetch. Omit for a new tab. Starts with view_tab_.", + "type": "string" + }, + "modules": { + "type": "array", + "items": { + "anyOf": [ + { + "type": "object", + "properties": { + "type": { + "type": "string", + "enum": [ + "properties", + "editor", + "discussions", + "relations" + ], + "description": "The module type." + } + }, + "required": [ + "type" + ], + "additionalProperties": false + }, + { + "type": "object", + "properties": { + "type": { + "type": "string", + "enum": [ + "property" + ], + "description": "The module type." + }, + "property": { + "type": "string", + "description": "The name of the property to show." + }, + "config": { + "description": "How the property looks.", + "type": "object", + "properties": { + "style": { + "type": "string", + "enum": [ + "compact", + "large", + "small", + "landscape", + "portrait", + "square", + "map", + "text" + ], + "description": "Display style. Which styles apply depends on the property type." + } + }, + "required": [ + "style" + ], + "additionalProperties": false + } + }, + "required": [ + "type", + "property" + ], + "additionalProperties": false + } + ] + }, + "description": "Tab modules in order. Must include an editor. Only properties, property modules, discussions, relations, and the editor are allowed." + } + }, + "required": [ + "modules" + ], + "additionalProperties": false + }, + "format": { + "description": "Page display options.", + "type": "object", + "properties": { + "propertyIcons": { + "description": "Whether property icons show on the page.", + "type": "string", + "enum": [ + "show", + "hide" + ] + }, + "pageFullWidth": { + "description": "Whether pages open at full width.", + "type": "boolean" + } + }, + "additionalProperties": false + } + }, + "required": [ + "main" + ], + "additionalProperties": false + } + }, + "required": [ + "data_source_id" + ], + "$schema": "https://json-schema.org/draft/2020-12/schema", + "additionalProperties": {} + }, + "outputSchema": null, + "description": "Update a Notion data source's schema, title, attributes, or page layout. Schema changes use SQL DDL statements. Returns Markdown showing updated structure and schema.\n\nAccepts a data source ID (collection ID from fetch response's . To attach a file created by create-file-upload or create-attachment, include its returned suggested_markdown on a separate line; up to three file attachments are supported. Do not use UI shortcuts like @today, @name, [[page]], or autocomplete-style emoji syntax; those are editor affordances, not markdown syntax. Mention tags must include a real url where required by the spec. Other block-level Markdown such as fenced code blocks, headings, lists, tables, and blockquotes is stored as plain comment text rather than rendered as blocks. Example: Looks good..", + "type": "string" + } + }, + "required": [ + "page_id" + ], + "$schema": "https://json-schema.org/draft/2020-12/schema", + "additionalProperties": {} + }, + "outputSchema": null, + "description": "Add a comment to a page or specific content.\n\nProvide `page_id` to identify the page, then choose ONE targeting mode:\n- `page_id` alone: Add a top-level comment to the page\n- `page_id` + `selection_with_ellipsis`: Start a new discussion on " + }, + { + "name": "notion-get-comments", + "title": "Get page comments", + "annotations": { + "readOnlyHint": true, + "destructiveHint": false, + "idempotentHint": true, + "openWorldHint": false + }, + "inputSchema": { + "type": "object", + "properties": { + "page_id": { + "type": "string", + "description": "Identifier for a Notion page." + }, + "include_resolved": { + "description": "Include resolved discussions in the response. Defaults to false.", + "type": "boolean" + }, + "include_all_blocks": { + "description": "Include discussions on child blocks, not just page-level discussions. Defaults to false.", + "type": "boolean" + }, + "discussion_id": { + "description": "Fetch a specific discussion by ID or discussion URL (e.g., discussion://pageId/blockId/discussionId).", + "type": "string" + } + }, + "required": [ + "page_id" + ], + "$schema": "https://json-schema.org/draft/2020-12/schema", + "additionalProperties": {} + }, + "outputSchema": null, + "description": "Get comments and discussions from a Notion page.\n\nReturns discussions with full comment content in XML format. By default, returns page-level discussions only. On supported Business connections, pending suggested edits use `kind=\"suggested_" + }, + { + "name": "notion-get-async-task", + "title": "Get async task status", + "annotations": { + "readOnlyHint": true, + "destructiveHint": false, + "idempotentHint": true, + "openWorldHint": false + }, + "inputSchema": { + "type": "object", + "properties": { + "task_id": { + "type": "string", + "minLength": 1, + "description": "The ID of the async task to retrieve, as returned in the async_task response of the tool that started it." + } + }, + "required": [ + "task_id" + ], + "$schema": "https://json-schema.org/draft/2020-12/schema", + "additionalProperties": {} + }, + "outputSchema": null, + "description": "Retrieves the current status of an async task that was started by another tool (for example, \"create_pages\" called with \"allow_async\": true).\n\nThe status is one of \"queued\", \"running\", \"retrying\", \"succeeded\", or \"failed\". When the task has" + }, + { + "name": "notion-get-teams", + "title": "Get workspace teams", + "annotations": { + "readOnlyHint": true, + "destructiveHint": false, + "idempotentHint": true, + "openWorldHint": false + }, + "inputSchema": { + "type": "object", + "properties": { + "query": { + "description": "Optional search query to filter teams by name (case-insensitive).", + "type": "string", + "minLength": 1, + "maxLength": 100 + } + }, + "$schema": "https://json-schema.org/draft/2020-12/schema", + "additionalProperties": {} + }, + "outputSchema": null, + "description": "Retrieves a list of teams (teamspaces) in the current workspace. Shows which teams exist, user membership status, IDs, names, and roles.\n\nTeams are returned split by membership status and limited to a maximum of 10 results.\n\n\n1. L" + }, + { + "name": "notion-get-users", + "title": "Get users and bots in workspace", + "annotations": { + "readOnlyHint": true, + "destructiveHint": false, + "idempotentHint": true, + "openWorldHint": false + }, + "inputSchema": { + "type": "object", + "properties": { + "query": { + "description": "Optional search query to filter users by name or email (case-insensitive).", + "type": "string", + "minLength": 1, + "maxLength": 100 + }, + "start_cursor": { + "description": "Cursor for pagination. Use the next_cursor value from the previous response to get the next page.", + "type": "string", + "minLength": 1 + }, + "page_size": { + "description": "Number of users to return per page (1\u2013100; default 100).", + "type": "integer", + "minimum": 1, + "maximum": 100 + }, + "user_id": { + "description": "Return only the user matching this ID. Pass \"self\" to fetch the current user.", + "type": "string", + "minLength": 1, + "maxLength": 100 + } + }, + "$schema": "https://json-schema.org/draft/2020-12/schema", + "additionalProperties": {} + }, + "outputSchema": null, + "description": "Retrieves a list of users in the current workspace. Shows workspace members and guests with their IDs, names, emails (if available), and types (person or bot).\n\nSupports cursor-based pagination to iterate through all users in the workspace." + }, + { + "name": "notion-query-data-sources", + "title": "Query Notion data sources", + "annotations": { + "readOnlyHint": true, + "destructiveHint": false, + "idempotentHint": true, + "openWorldHint": false + }, + "inputSchema": { + "type": "object", + "properties": { + "data": { + "description": "Mode parameter reference and examples.\n\nSQL mode:\n- Checkbox values: use \"__YES__\" for checked, \"__NO__\" for unchecked\n\n\nRows mode: Return up to 100 rows with faithful rich-text property values and optional structured filters and sorts.\n\nExample:\n{\"mode\":\"rows\",\"data_source_url\":\"collection://f336d0bc-b841-465b-8045-024475c079dd\",\"filter\":{\"type\":\"group\",\"operator\":\"and\",\"filters\":[{\"type\":\"property\",\"property\":\"Status\",\"propertyType\":\"select\",\"operator\":\"enum_is\",\"value\":{\"type\":\"exact\",\"value\":\"In Progress\"}}]},\"limit\":20}\n\nExamples:\n- Simple SQL: {\"data_source_urls\":[\"collection://f336d0bc-b841-465b-8045-024475c079dd\"],\"query\":\"SELECT * FROM [collection://f336d0bc-b841-465b-8045-024475c079dd] LIMIT 10\"}\n- SQL parameters: {\"mode\":\"sql\",\"data_source_urls\":[\"collection://abc123\"],\"query\":\"SELECT * FROM [collection://abc123] WHERE Status = ? AND Priority = ?\",\"params\":[\"In Progress\",\"High\"]}\n- Checkbox query: {\"data_source_urls\":[\"collection://def456\"],\"query\":\"SELECT * FROM [collection://def456] WHERE Completed = ?\",\"params\":[\"__YES__\"]}\n\nView mode: Execute a specific database view's query with its filters and sorts. Omit \"is_archived\" or set it to false for non-archived rows. Set \"is_archived\": true to apply the view inside the archived partition. When the response has \"has_more\": true, pass its \"next_cursor\" as \"start_cursor\" in a follow-up view-mode request with the same \"is_archived\" value.\n\nExample:\n{\"mode\":\"view\",\"view_url\":\"https://www.notion.so/workspace/Tasks-DB-abc123?v=def456\",\"is_archived\":false}", + "anyOf": [ + { + "type": "object", + "properties": { + "data_source_urls": { + "maxItems": 100, + "type": "array", + "items": { + "type": "string" + }, + "description": "Notion data source URLs whose SQLite tables are available to the query; each data source is exposed as a table named by its URL. Obtain them from the fetch tool, in the format: collection://f336d0bc-b841-465b-8045-024475c079dd" + }, + "query": { + "type": "string", + "description": "Read-only SQLite query to execute against the data sources. Use a data source URL as the table name, e.g. SELECT * FROM \"collection://...\" WHERE .... Include every needed filter in WHERE (filters on views of the data source are not automatically applied). For time comparisons or ordering, normalize text timestamps with datetime(...) or date(...). SQL text values can omit rich-text mentions and formatting, and links can lose their destination. Use faithful rows mode or fetch the page before rewriting a rich-text property." + }, + "mode": { + "description": "Optional mode parameter. Defaults to 'sql' if not specified. SQL mode does not accept is_archived; that parameter belongs only to view mode.", + "type": "string", + "enum": [ + "sql" + ] + }, + "params": { + "description": "Positional parameters bound to `?` placeholders in the query. Prefer parameterized queries over string interpolation. Use \"__YES__\" for checked checkboxes and \"__NO__\" for unchecked checkboxes.", + "maxItems": 100, + "type": "array", + "items": { + "anyOf": [ + { + "type": "string" + }, + { + "type": "number" + }, + { + "type": "boolean" + }, + { + "type": "null" + } + ] + } + } + }, + "required": [ + "data_source_urls", + "query" + ], + "additionalProperties": false + }, + { + "type": "object", + "properties": { + "mode": { + "type": "string", + "enum": [ + "view" + ], + "description": "Mode for executing a database view's existing query" + }, + "view_url": { + "type": "string", + "description": "URL of a specific database view to query. Example: https://www.notion.so/workspace/db-id?v=view-id" + }, + "start_cursor": { + "description": "Cursor for pagination. Use the next_cursor value from the previous response to get the next page.", + "type": "string", + "minLength": 1, + "maxLength": 200 + }, + "page_size": { + "description": "Number of rows to return per page (default: 100, max: 100).", + "type": "integer", + "minimum": 1, + "maximum": 100 + }, + "is_archived": { + "description": "Optional archive selector. Omitted or false queries non-archived rows only; true queries archived rows only.", + "type": "boolean" + } + }, + "required": [ + "mode", + "view_url" + ], + "additionalProperties": false + }, + { + "type": "object", + "properties": { + "mode": { + "type": "string", + "enum": [ + "rows" + ], + "description": "Return data source rows with rich-text mentions, links, formatting, dates, and equations preserved." + }, + "data_source_url": { + "type": "string", + "description": "One Notion data source URL obtained from a fetch result." + }, + "filter": { + "description": "Structured filter using exact property names from the data source schema. Supports an outer Boolean group plus one nested group level.", + "type": "object", + "properties": { + "type": { + "type": "string", + "enum": [ + "group" + ], + "description": "Selects the filter or filter-value variant." + }, + "operator": { + "type": "string", + "enum": [ + "and", + "or" + ], + "description": "Comparison or Boolean operation applied by this filter." + }, + "filters": { + "maxItems": 100, + "type": "array", + "items": { + "anyOf": [ + { + "anyOf": [ + { + "type": "object", + "properties": { + "type": { + "type": "string", + "enum": [ + "property" + ], + "description": "Selects the filter or filter-value variant." + }, + "property": { + "type": "string", + "description": "Exact data source property name to filter." + }, + "propertyType": { + "type": "string", + "description": "Notion property type used to select valid operators and value shapes." + }, + "operator": { + "type": "string", + "enum": [ + "is_empty", + "is_not_empty" + ], + "description": "Comparison or Boolean operation applied by this filter." + } + }, + "required": [ + "type", + "property", + "propertyType", + "operator" + ], + "additionalProperties": false, + "description": "Checks whether a property has any value." + }, + { + "type": "object", + "properties": { + "type": { + "type": "string", + "enum": [ + "property" + ], + "description": "Selects the filter or filter-value variant." + }, + "property": { + "type": "string", + "description": "Exact data source property name to filter." + }, + "propertyType": { + "type": "string", + "enum": [ + "title", + "text", + "url", + "email", + "phone_number" + ], + "description": "Notion property type used to select valid operators and value shapes." + }, + "operator": { + "type": "string", + "enum": [ + "string_is", + "string_is_not", + "string_contains", + "string_does_not_contain", + "string_starts_with", + "string_ends_with" + ], + "description": "Comparison or Boolean operation applied by this filter." + }, + "value": { + "type": "object", + "properties": { + "type": { + "type": "string", + "enum": [ + "exact" + ], + "description": "Selects the filter or filter-value variant." + }, + "value": { + "type": "string", + "description": "Literal or relative value used by the filter." + } + }, + "required": [ + "type", + "value" + ], + "additionalProperties": false, + "description": "Literal or relative value used by the filter." + } + }, + "required": [ + "type", + "property", + "propertyType", + "operator", + "value" + ], + "additionalProperties": false, + "description": "Property filter for text-like properties." + }, + { + "type": "object", + "properties": { + "type": { + "type": "string", + "enum": [ + "property" + ], + "description": "Selects the filter or filter-value variant." + }, + "property": { + "type": "string", + "description": "Exact data source property name to filter." + }, + "propertyType": { + "type": "string", + "enum": [ + "number", + "auto_increment_id" + ], + "description": "Notion property type used to select valid operators and value shapes." + }, + "operator": { + "type": "string", + "enum": [ + "number_equals", + "number_does_not_equal", + "number_greater_than", + "number_less_than", + "number_greater_than_or_equal_to", + "number_less_than_or_equal_to" + ], + "description": "Comparison or Boolean operation applied by this filter." + }, + "value": { + "type": "object", + "properties": { + "type": { + "type": "string", + "enum": [ + "exact" + ], + "description": "Selects the filter or filter-value variant." + }, + "value": { + "type": "number", + "description": "Literal or relative value used by the filter." + } + }, + "required": [ + "type", + "value" + ], + "additionalProperties": false, + "description": "Literal or relative value used by the filter." + } + }, + "required": [ + "type", + "property", + "propertyType", + "operator", + "value" + ], + "additionalProperties": false, + "description": "Property filter for number properties." + }, + { + "anyOf": [ + { + "type": "object", + "properties": { + "type": { + "type": "string", + "enum": [ + "property" + ], + "description": "Selects the filter or filter-value variant." + }, + "property": { + "type": "string", + "description": "Exact data source property name to filter." + }, + "propertyType": { + "type": "string", + "enum": [ + "date", + "created_time", + "last_edited_time", + "last_visited_time" + ], + "description": "Notion property type used to select valid operators and value shapes." + }, + "operator": { + "type": "string", + "enum": [ + "date_is", + "date_is_before", + "date_is_after", + "date_is_on_or_before", + "date_is_on_or_after" + ], + "description": "Comparison or Boolean operation applied by this filter." + }, + "value": { + "anyOf": [ + { + "type": "object", + "properties": { + "type": { + "type": "string", + "enum": [ + "exact" + ], + "description": "Selects the filter or filter-value variant." + }, + "value": { + "type": "string", + "description": "Literal or relative value used by the filter." + } + }, + "required": [ + "type", + "value" + ], + "additionalProperties": false + }, + { + "type": "object", + "properties": { + "type": { + "type": "string", + "enum": [ + "relative" + ], + "description": "Selects the filter or filter-value variant." + }, + "value": { + "type": "string", + "enum": [ + "today", + "tomorrow", + "yesterday", + "one_week_ago", + "one_week_from_now", + "one_month_ago", + "one_month_from_now" + ], + "description": "Literal or relative value used by the filter." + } + }, + "required": [ + "type", + "value" + ], + "additionalProperties": false + } + ], + "description": "Literal or relative value used by the filter." + }, + "use_end": { + "description": "For a date property, compare its end date instead of its start date.", + "type": "boolean" + } + }, + "required": [ + "type", + "property", + "propertyType", + "operator", + "value" + ], + "additionalProperties": false + }, + { + "type": "object", + "properties": { + "type": { + "type": "string", + "enum": [ + "property" + ], + "description": "Selects the filter or filter-value variant." + }, + "property": { + "type": "string", + "description": "Exact data source property name to filter." + }, + "propertyType": { + "type": "string", + "enum": [ + "date", + "created_time", + "last_edited_time", + "last_visited_time" + ], + "description": "Notion property type used to select valid operators and value shapes." + }, + "operator": { + "type": "string", + "enum": [ + "date_is_within", + "date_is_relative_to" + ], + "description": "Comparison or Boolean operation applied by this filter." + }, + "value": { + "anyOf": [ + { + "type": "object", + "properties": { + "type": { + "type": "string", + "enum": [ + "exact" + ], + "description": "Selects the filter or filter-value variant." + }, + "value": { + "type": "object", + "properties": { + "type": { + "type": "string", + "enum": [ + "daterange" + ], + "description": "Selects the filter or filter-value variant." + }, + "start_date": { + "description": "ISO 8601 date or date-time at the start of the range.", + "type": "string" + }, + "end_date": { + "description": "ISO 8601 date or date-time at the end of the range.", + "type": "string" + } + }, + "required": [ + "type" + ], + "additionalProperties": false, + "description": "Literal or relative value used by the filter." + } + }, + "required": [ + "type", + "value" + ], + "additionalProperties": false + }, + { + "type": "object", + "properties": { + "type": { + "type": "string", + "enum": [ + "relative" + ], + "description": "Selects the filter or filter-value variant." + }, + "value": { + "type": "string", + "enum": [ + "custom" + ], + "description": "Literal or relative value used by the filter." + }, + "direction": { + "type": "string", + "enum": [ + "past", + "future" + ], + "description": "Whether the custom range extends into the past or future." + }, + "unit": { + "type": "string", + "enum": [ + "year", + "month", + "week", + "day" + ], + "description": "Time unit used to measure a relative date range." + }, + "count": { + "type": "number", + "description": "Number of units in the custom relative range." + } + }, + "required": [ + "type", + "value", + "direction", + "unit", + "count" + ], + "additionalProperties": false + }, + { + "type": "object", + "properties": { + "type": { + "type": "string", + "enum": [ + "relative" + ], + "description": "Selects the filter or filter-value variant." + }, + "value": { + "type": "string", + "enum": [ + "surrounding" + ], + "description": "Literal or relative value used by the filter." + }, + "unit": { + "type": "string", + "enum": [ + "year", + "month", + "week", + "day" + ], + "description": "Time unit used to measure a relative date range." + } + }, + "required": [ + "type", + "value", + "unit" + ], + "additionalProperties": false + }, + { + "type": "object", + "properties": { + "type": { + "type": "string", + "enum": [ + "relative" + ], + "description": "Selects the filter or filter-value variant." + }, + "value": { + "type": "string", + "enum": [ + "this_week", + "the_past_week", + "the_past_month", + "the_past_year", + "the_next_week", + "the_next_month", + "the_next_year" + ], + "description": "Literal or relative value used by the filter." + } + }, + "required": [ + "type", + "value" + ], + "additionalProperties": false + } + ], + "description": "Literal or relative value used by the filter." + }, + "use_end": { + "description": "For a date property, compare its end date instead of its start date.", + "type": "boolean" + } + }, + "required": [ + "type", + "property", + "propertyType", + "operator", + "value" + ], + "additionalProperties": false + } + ], + "description": "Property filter for date properties." + }, + { + "type": "object", + "properties": { + "type": { + "type": "string", + "enum": [ + "property" + ], + "description": "Selects the filter or filter-value variant." + }, + "property": { + "type": "string", + "description": "Exact data source property name to filter." + }, + "propertyType": { + "type": "string", + "enum": [ + "select" + ], + "description": "Notion property type used to select valid operators and value shapes." + }, + "operator": { + "type": "string", + "enum": [ + "enum_is", + "enum_is_not" + ], + "description": "Comparison or Boolean operation applied by this filter." + }, + "value": { + "anyOf": [ + { + "type": "object", + "properties": { + "type": { + "type": "string", + "enum": [ + "exact" + ], + "description": "Selects the filter or filter-value variant." + }, + "value": { + "type": "string", + "description": "Literal or relative value used by the filter." + } + }, + "required": [ + "type", + "value" + ], + "additionalProperties": false + }, + { + "type": "array", + "items": { + "type": "object", + "properties": { + "type": { + "type": "string", + "enum": [ + "exact" + ], + "description": "Selects the filter or filter-value variant." + }, + "value": { + "type": "string", + "description": "Literal or relative value used by the filter." + } + }, + "required": [ + "type", + "value" + ], + "additionalProperties": false + } + } + ], + "description": "Literal or relative value used by the filter." + } + }, + "required": [ + "type", + "property", + "propertyType", + "operator", + "value" + ], + "additionalProperties": false, + "description": "Property filter for select properties by option name." + }, + { + "type": "object", + "properties": { + "type": { + "type": "string", + "enum": [ + "property" + ], + "description": "Selects the filter or filter-value variant." + }, + "property": { + "type": "string", + "description": "Exact data source property name to filter." + }, + "propertyType": { + "type": "string", + "enum": [ + "multi_select" + ], + "description": "Notion property type used to select valid operators and value shapes." + }, + "operator": { + "type": "string", + "enum": [ + "enum_contains", + "enum_does_not_contain" + ], + "description": "Comparison or Boolean operation applied by this filter." + }, + "value": { + "anyOf": [ + { + "type": "object", + "properties": { + "type": { + "type": "string", + "enum": [ + "exact" + ], + "description": "Selects the filter or filter-value variant." + }, + "value": { + "type": "string", + "description": "Literal or relative value used by the filter." + } + }, + "required": [ + "type", + "value" + ], + "additionalProperties": false + }, + { + "type": "array", + "items": { + "type": "object", + "properties": { + "type": { + "type": "string", + "enum": [ + "exact" + ], + "description": "Selects the filter or filter-value variant." + }, + "value": { + "type": "string", + "description": "Literal or relative value used by the filter." + } + }, + "required": [ + "type", + "value" + ], + "additionalProperties": false + } + } + ], + "description": "Literal or relative value used by the filter." + } + }, + "required": [ + "type", + "property", + "propertyType", + "operator", + "value" + ], + "additionalProperties": false, + "description": "Property filter for multi-select properties." + }, + { + "type": "object", + "properties": { + "type": { + "type": "string", + "enum": [ + "property" + ], + "description": "Selects the filter or filter-value variant." + }, + "property": { + "type": "string", + "description": "Exact data source property name to filter." + }, + "propertyType": { + "type": "string", + "enum": [ + "checkbox" + ], + "description": "Notion property type used to select valid operators and value shapes." + }, + "operator": { + "type": "string", + "enum": [ + "checkbox_is", + "checkbox_is_not" + ], + "description": "Comparison or Boolean operation applied by this filter." + }, + "value": { + "type": "object", + "properties": { + "type": { + "type": "string", + "enum": [ + "exact" + ], + "description": "Selects the filter or filter-value variant." + }, + "value": { + "type": "boolean", + "description": "Literal or relative value used by the filter." + } + }, + "required": [ + "type", + "value" + ], + "additionalProperties": false, + "description": "Literal or relative value used by the filter." + } + }, + "required": [ + "type", + "property", + "propertyType", + "operator", + "value" + ], + "additionalProperties": false, + "description": "Property filter for checkbox properties." + }, + { + "type": "object", + "properties": { + "type": { + "type": "string", + "enum": [ + "property" + ], + "description": "Selects the filter or filter-value variant." + }, + "property": { + "type": "string", + "description": "Exact data source property name to filter." + }, + "propertyType": { + "type": "string", + "enum": [ + "relation" + ], + "description": "Notion property type used to select valid operators and value shapes." + }, + "operator": { + "type": "string", + "enum": [ + "relation_contains", + "relation_does_not_contain" + ], + "description": "Comparison or Boolean operation applied by this filter." + }, + "value": { + "anyOf": [ + { + "type": "object", + "properties": { + "type": { + "type": "string", + "enum": [ + "exact" + ], + "description": "Selects the filter or filter-value variant." + }, + "value": { + "type": "string", + "description": "Literal or relative value used by the filter." + } + }, + "required": [ + "type", + "value" + ], + "additionalProperties": false + }, + { + "type": "array", + "items": { + "type": "object", + "properties": { + "type": { + "type": "string", + "enum": [ + "exact" + ], + "description": "Selects the filter or filter-value variant." + }, + "value": { + "type": "string", + "description": "Literal or relative value used by the filter." + } + }, + "required": [ + "type", + "value" + ], + "additionalProperties": false + } + } + ], + "description": "Literal or relative value used by the filter." + } + }, + "required": [ + "type", + "property", + "propertyType", + "operator", + "value" + ], + "additionalProperties": false, + "description": "Property filter for relation properties." + }, + { + "type": "object", + "properties": { + "type": { + "type": "string", + "enum": [ + "property" + ], + "description": "Selects the filter or filter-value variant." + }, + "property": { + "type": "string", + "description": "Exact data source property name to filter." + }, + "propertyType": { + "type": "string", + "enum": [ + "status" + ], + "description": "Notion property type used to select valid operators and value shapes." + }, + "operator": { + "type": "string", + "enum": [ + "status_is", + "status_is_not" + ], + "description": "Comparison or Boolean operation applied by this filter." + }, + "value": { + "anyOf": [ + { + "type": "object", + "properties": { + "type": { + "type": "string", + "enum": [ + "is_group", + "is_option" + ], + "description": "Selects the filter or filter-value variant." + }, + "value": { + "type": "string", + "description": "Literal or relative value used by the filter." + } + }, + "required": [ + "type", + "value" + ], + "additionalProperties": false + }, + { + "type": "array", + "items": { + "type": "object", + "properties": { + "type": { + "type": "string", + "enum": [ + "is_group", + "is_option" + ], + "description": "Selects the filter or filter-value variant." + }, + "value": { + "type": "string", + "description": "Literal or relative value used by the filter." + } + }, + "required": [ + "type", + "value" + ], + "additionalProperties": false + } + } + ], + "description": "Literal or relative value used by the filter." + } + }, + "required": [ + "type", + "property", + "propertyType", + "operator", + "value" + ], + "additionalProperties": false, + "description": "Property filter for status properties by option name." + }, + { + "type": "object", + "properties": { + "type": { + "type": "string", + "enum": [ + "property" + ], + "description": "Selects the filter or filter-value variant." + }, + "property": { + "type": "string", + "description": "Exact data source property name to filter." + }, + "propertyType": { + "type": "string", + "enum": [ + "person", + "created_by", + "last_edited_by" + ], + "description": "Notion property type used to select valid operators and value shapes." + }, + "operator": { + "type": "string", + "enum": [ + "person_contains", + "person_does_not_contain" + ], + "description": "Comparison or Boolean operation applied by this filter." + }, + "value": { + "anyOf": [ + { + "anyOf": [ + { + "type": "object", + "properties": { + "type": { + "type": "string", + "enum": [ + "exact" + ], + "description": "Selects the filter or filter-value variant." + }, + "value": { + "type": "string", + "description": "Literal or relative value used by the filter." + } + }, + "required": [ + "type", + "value" + ], + "additionalProperties": false + }, + { + "type": "object", + "properties": { + "type": { + "type": "string", + "enum": [ + "relative" + ], + "description": "Selects the filter or filter-value variant." + }, + "value": { + "type": "string", + "enum": [ + "me" + ], + "description": "Literal or relative value used by the filter." + } + }, + "required": [ + "type", + "value" + ], + "additionalProperties": false + } + ] + }, + { + "type": "array", + "items": { + "anyOf": [ + { + "type": "object", + "properties": { + "type": { + "type": "string", + "enum": [ + "exact" + ], + "description": "Selects the filter or filter-value variant." + }, + "value": { + "type": "string", + "description": "Literal or relative value used by the filter." + } + }, + "required": [ + "type", + "value" + ], + "additionalProperties": false + }, + { + "type": "object", + "properties": { + "type": { + "type": "string", + "enum": [ + "relative" + ], + "description": "Selects the filter or filter-value variant." + }, + "value": { + "type": "string", + "enum": [ + "me" + ], + "description": "Literal or relative value used by the filter." + } + }, + "required": [ + "type", + "value" + ], + "additionalProperties": false + } + ] + } + } + ], + "description": "Literal or relative value used by the filter." + } + }, + "required": [ + "type", + "property", + "propertyType", + "operator", + "value" + ], + "additionalProperties": false, + "description": "Property filter for person-like properties. Exact values use user://, bot://, organization_bot://, or space_permission_group:// URIs; relative values use me." + }, + { + "type": "object", + "properties": { + "type": { + "type": "string", + "enum": [ + "property" + ], + "description": "Selects the filter or filter-value variant." + }, + "property": { + "type": "string", + "description": "Exact data source property name to filter." + }, + "propertyType": { + "type": "string", + "enum": [ + "verification" + ], + "description": "Notion property type used to select valid operators and value shapes." + }, + "operator": { + "type": "string", + "enum": [ + "verification_is", + "verification_is_not" + ], + "description": "Comparison or Boolean operation applied by this filter." + }, + "value": { + "anyOf": [ + { + "type": "object", + "properties": { + "type": { + "type": "string", + "enum": [ + "exact" + ], + "description": "Selects the filter or filter-value variant." + }, + "value": { + "type": "string", + "enum": [ + "verified", + "expired", + "none" + ], + "description": "Literal or relative value used by the filter." + } + }, + "required": [ + "type", + "value" + ], + "additionalProperties": false + }, + { + "type": "array", + "items": { + "type": "object", + "properties": { + "type": { + "type": "string", + "enum": [ + "exact" + ], + "description": "Selects the filter or filter-value variant." + }, + "value": { + "type": "string", + "enum": [ + "verified", + "expired", + "none" + ], + "description": "Literal or relative value used by the filter." + } + }, + "required": [ + "type", + "value" + ], + "additionalProperties": false + } + } + ], + "description": "Literal or relative value used by the filter." + } + }, + "required": [ + "type", + "property", + "propertyType", + "operator", + "value" + ], + "additionalProperties": false, + "description": "Property filter for page verification state." + }, + { + "type": "object", + "properties": { + "type": { + "type": "string", + "enum": [ + "property" + ], + "description": "Selects the filter or filter-value variant." + }, + "property": { + "type": "string", + "description": "Exact data source property name to filter." + }, + "propertyType": { + "type": "string", + "enum": [ + "formula" + ], + "description": "Notion property type used to select valid operators and value shapes." + }, + "operator": { + "description": "Comparison or Boolean operation applied by this filter.", + "type": "string", + "enum": [ + "any", + "none", + "every" + ] + }, + "resultFilter": { + "anyOf": [ + { + "type": "object", + "properties": { + "type": { + "type": "string", + "enum": [ + "property" + ], + "description": "Selects the filter or filter-value variant." + }, + "property": { + "type": "string", + "description": "Exact data source property name to filter." + }, + "propertyType": { + "type": "string", + "description": "Notion property type used to select valid operators and value shapes." + }, + "operator": { + "type": "string", + "enum": [ + "is_empty", + "is_not_empty" + ], + "description": "Comparison or Boolean operation applied by this filter." + } + }, + "required": [ + "type", + "property", + "propertyType", + "operator" + ], + "additionalProperties": false, + "description": "Checks whether a property has any value." + }, + { + "type": "object", + "properties": { + "type": { + "type": "string", + "enum": [ + "property" + ], + "description": "Selects the filter or filter-value variant." + }, + "property": { + "type": "string", + "description": "Exact data source property name to filter." + }, + "propertyType": { + "type": "string", + "enum": [ + "title", + "text", + "url", + "email", + "phone_number" + ], + "description": "Notion property type used to select valid operators and value shapes." + }, + "operator": { + "type": "string", + "enum": [ + "string_is", + "string_is_not", + "string_contains", + "string_does_not_contain", + "string_starts_with", + "string_ends_with" + ], + "description": "Comparison or Boolean operation applied by this filter." + }, + "value": { + "type": "object", + "properties": { + "type": { + "type": "string", + "enum": [ + "exact" + ], + "description": "Selects the filter or filter-value variant." + }, + "value": { + "type": "string", + "description": "Literal or relative value used by the filter." + } + }, + "required": [ + "type", + "value" + ], + "additionalProperties": false, + "description": "Literal or relative value used by the filter." + } + }, + "required": [ + "type", + "property", + "propertyType", + "operator", + "value" + ], + "additionalProperties": false, + "description": "Property filter for text-like properties." + }, + { + "type": "object", + "properties": { + "type": { + "type": "string", + "enum": [ + "property" + ], + "description": "Selects the filter or filter-value variant." + }, + "property": { + "type": "string", + "description": "Exact data source property name to filter." + }, + "propertyType": { + "type": "string", + "enum": [ + "number", + "auto_increment_id" + ], + "description": "Notion property type used to select valid operators and value shapes." + }, + "operator": { + "type": "string", + "enum": [ + "number_equals", + "number_does_not_equal", + "number_greater_than", + "number_less_than", + "number_greater_than_or_equal_to", + "number_less_than_or_equal_to" + ], + "description": "Comparison or Boolean operation applied by this filter." + }, + "value": { + "type": "object", + "properties": { + "type": { + "type": "string", + "enum": [ + "exact" + ], + "description": "Selects the filter or filter-value variant." + }, + "value": { + "type": "number", + "description": "Literal or relative value used by the filter." + } + }, + "required": [ + "type", + "value" + ], + "additionalProperties": false, + "description": "Literal or relative value used by the filter." + } + }, + "required": [ + "type", + "property", + "propertyType", + "operator", + "value" + ], + "additionalProperties": false, + "description": "Property filter for number properties." + }, + { + "anyOf": [ + { + "type": "object", + "properties": { + "type": { + "type": "string", + "enum": [ + "property" + ], + "description": "Selects the filter or filter-value variant." + }, + "property": { + "type": "string", + "description": "Exact data source property name to filter." + }, + "propertyType": { + "type": "string", + "enum": [ + "date", + "created_time", + "last_edited_time", + "last_visited_time" + ], + "description": "Notion property type used to select valid operators and value shapes." + }, + "operator": { + "type": "string", + "enum": [ + "date_is", + "date_is_before", + "date_is_after", + "date_is_on_or_before", + "date_is_on_or_after" + ], + "description": "Comparison or Boolean operation applied by this filter." + }, + "value": { + "anyOf": [ + { + "type": "object", + "properties": { + "type": { + "type": "string", + "enum": [ + "exact" + ], + "description": "Selects the filter or filter-value variant." + }, + "value": { + "type": "string", + "description": "Literal or relative value used by the filter." + } + }, + "required": [ + "type", + "value" + ], + "additionalProperties": false + }, + { + "type": "object", + "properties": { + "type": { + "type": "string", + "enum": [ + "relative" + ], + "description": "Selects the filter or filter-value variant." + }, + "value": { + "type": "string", + "enum": [ + "today", + "tomorrow", + "yesterday", + "one_week_ago", + "one_week_from_now", + "one_month_ago", + "one_month_from_now" + ], + "description": "Literal or relative value used by the filter." + } + }, + "required": [ + "type", + "value" + ], + "additionalProperties": false + } + ], + "description": "Literal or relative value used by the filter." + }, + "use_end": { + "description": "For a date property, compare its end date instead of its start date.", + "type": "boolean" + } + }, + "required": [ + "type", + "property", + "propertyType", + "operator", + "value" + ], + "additionalProperties": false + }, + { + "type": "object", + "properties": { + "type": { + "type": "string", + "enum": [ + "property" + ], + "description": "Selects the filter or filter-value variant." + }, + "property": { + "type": "string", + "description": "Exact data source property name to filter." + }, + "propertyType": { + "type": "string", + "enum": [ + "date", + "created_time", + "last_edited_time", + "last_visited_time" + ], + "description": "Notion property type used to select valid operators and value shapes." + }, + "operator": { + "type": "string", + "enum": [ + "date_is_within", + "date_is_relative_to" + ], + "description": "Comparison or Boolean operation applied by this filter." + }, + "value": { + "anyOf": [ + { + "type": "object", + "properties": { + "type": { + "type": "string", + "enum": [ + "exact" + ], + "description": "Selects the filter or filter-value variant." + }, + "value": { + "type": "object", + "properties": { + "type": { + "type": "string", + "enum": [ + "daterange" + ], + "description": "Selects the filter or filter-value variant." + }, + "start_date": { + "description": "ISO 8601 date or date-time at the start of the range.", + "type": "string" + }, + "end_date": { + "description": "ISO 8601 date or date-time at the end of the range.", + "type": "string" + } + }, + "required": [ + "type" + ], + "additionalProperties": false, + "description": "Literal or relative value used by the filter." + } + }, + "required": [ + "type", + "value" + ], + "additionalProperties": false + }, + { + "type": "object", + "properties": { + "type": { + "type": "string", + "enum": [ + "relative" + ], + "description": "Selects the filter or filter-value variant." + }, + "value": { + "type": "string", + "enum": [ + "custom" + ], + "description": "Literal or relative value used by the filter." + }, + "direction": { + "type": "string", + "enum": [ + "past", + "future" + ], + "description": "Whether the custom range extends into the past or future." + }, + "unit": { + "type": "string", + "enum": [ + "year", + "month", + "week", + "day" + ], + "description": "Time unit used to measure a relative date range." + }, + "count": { + "type": "number", + "description": "Number of units in the custom relative range." + } + }, + "required": [ + "type", + "value", + "direction", + "unit", + "count" + ], + "additionalProperties": false + }, + { + "type": "object", + "properties": { + "type": { + "type": "string", + "enum": [ + "relative" + ], + "description": "Selects the filter or filter-value variant." + }, + "value": { + "type": "string", + "enum": [ + "surrounding" + ], + "description": "Literal or relative value used by the filter." + }, + "unit": { + "type": "string", + "enum": [ + "year", + "month", + "week", + "day" + ], + "description": "Time unit used to measure a relative date range." + } + }, + "required": [ + "type", + "value", + "unit" + ], + "additionalProperties": false + }, + { + "type": "object", + "properties": { + "type": { + "type": "string", + "enum": [ + "relative" + ], + "description": "Selects the filter or filter-value variant." + }, + "value": { + "type": "string", + "enum": [ + "this_week", + "the_past_week", + "the_past_month", + "the_past_year", + "the_next_week", + "the_next_month", + "the_next_year" + ], + "description": "Literal or relative value used by the filter." + } + }, + "required": [ + "type", + "value" + ], + "additionalProperties": false + } + ], + "description": "Literal or relative value used by the filter." + }, + "use_end": { + "description": "For a date property, compare its end date instead of its start date.", + "type": "boolean" + } + }, + "required": [ + "type", + "property", + "propertyType", + "operator", + "value" + ], + "additionalProperties": false + } + ], + "description": "Property filter for date properties." + }, + { + "type": "object", + "properties": { + "type": { + "type": "string", + "enum": [ + "property" + ], + "description": "Selects the filter or filter-value variant." + }, + "property": { + "type": "string", + "description": "Exact data source property name to filter." + }, + "propertyType": { + "type": "string", + "enum": [ + "select" + ], + "description": "Notion property type used to select valid operators and value shapes." + }, + "operator": { + "type": "string", + "enum": [ + "enum_is", + "enum_is_not" + ], + "description": "Comparison or Boolean operation applied by this filter." + }, + "value": { + "anyOf": [ + { + "type": "object", + "properties": { + "type": { + "type": "string", + "enum": [ + "exact" + ], + "description": "Selects the filter or filter-value variant." + }, + "value": { + "type": "string", + "description": "Literal or relative value used by the filter." + } + }, + "required": [ + "type", + "value" + ], + "additionalProperties": false + }, + { + "type": "array", + "items": { + "type": "object", + "properties": { + "type": { + "type": "string", + "enum": [ + "exact" + ], + "description": "Selects the filter or filter-value variant." + }, + "value": { + "type": "string", + "description": "Literal or relative value used by the filter." + } + }, + "required": [ + "type", + "value" + ], + "additionalProperties": false + } + } + ], + "description": "Literal or relative value used by the filter." + } + }, + "required": [ + "type", + "property", + "propertyType", + "operator", + "value" + ], + "additionalProperties": false, + "description": "Property filter for select properties by option name." + }, + { + "type": "object", + "properties": { + "type": { + "type": "string", + "enum": [ + "property" + ], + "description": "Selects the filter or filter-value variant." + }, + "property": { + "type": "string", + "description": "Exact data source property name to filter." + }, + "propertyType": { + "type": "string", + "enum": [ + "multi_select" + ], + "description": "Notion property type used to select valid operators and value shapes." + }, + "operator": { + "type": "string", + "enum": [ + "enum_contains", + "enum_does_not_contain" + ], + "description": "Comparison or Boolean operation applied by this filter." + }, + "value": { + "anyOf": [ + { + "type": "object", + "properties": { + "type": { + "type": "string", + "enum": [ + "exact" + ], + "description": "Selects the filter or filter-value variant." + }, + "value": { + "type": "string", + "description": "Literal or relative value used by the filter." + } + }, + "required": [ + "type", + "value" + ], + "additionalProperties": false + }, + { + "type": "array", + "items": { + "type": "object", + "properties": { + "type": { + "type": "string", + "enum": [ + "exact" + ], + "description": "Selects the filter or filter-value variant." + }, + "value": { + "type": "string", + "description": "Literal or relative value used by the filter." + } + }, + "required": [ + "type", + "value" + ], + "additionalProperties": false + } + } + ], + "description": "Literal or relative value used by the filter." + } + }, + "required": [ + "type", + "property", + "propertyType", + "operator", + "value" + ], + "additionalProperties": false, + "description": "Property filter for multi-select properties." + }, + { + "type": "object", + "properties": { + "type": { + "type": "string", + "enum": [ + "property" + ], + "description": "Selects the filter or filter-value variant." + }, + "property": { + "type": "string", + "description": "Exact data source property name to filter." + }, + "propertyType": { + "type": "string", + "enum": [ + "checkbox" + ], + "description": "Notion property type used to select valid operators and value shapes." + }, + "operator": { + "type": "string", + "enum": [ + "checkbox_is", + "checkbox_is_not" + ], + "description": "Comparison or Boolean operation applied by this filter." + }, + "value": { + "type": "object", + "properties": { + "type": { + "type": "string", + "enum": [ + "exact" + ], + "description": "Selects the filter or filter-value variant." + }, + "value": { + "type": "boolean", + "description": "Literal or relative value used by the filter." + } + }, + "required": [ + "type", + "value" + ], + "additionalProperties": false, + "description": "Literal or relative value used by the filter." + } + }, + "required": [ + "type", + "property", + "propertyType", + "operator", + "value" + ], + "additionalProperties": false, + "description": "Property filter for checkbox properties." + }, + { + "type": "object", + "properties": { + "type": { + "type": "string", + "enum": [ + "property" + ], + "description": "Selects the filter or filter-value variant." + }, + "property": { + "type": "string", + "description": "Exact data source property name to filter." + }, + "propertyType": { + "type": "string", + "enum": [ + "relation" + ], + "description": "Notion property type used to select valid operators and value shapes." + }, + "operator": { + "type": "string", + "enum": [ + "relation_contains", + "relation_does_not_contain" + ], + "description": "Comparison or Boolean operation applied by this filter." + }, + "value": { + "anyOf": [ + { + "type": "object", + "properties": { + "type": { + "type": "string", + "enum": [ + "exact" + ], + "description": "Selects the filter or filter-value variant." + }, + "value": { + "type": "string", + "description": "Literal or relative value used by the filter." + } + }, + "required": [ + "type", + "value" + ], + "additionalProperties": false + }, + { + "type": "array", + "items": { + "type": "object", + "properties": { + "type": { + "type": "string", + "enum": [ + "exact" + ], + "description": "Selects the filter or filter-value variant." + }, + "value": { + "type": "string", + "description": "Literal or relative value used by the filter." + } + }, + "required": [ + "type", + "value" + ], + "additionalProperties": false + } + } + ], + "description": "Literal or relative value used by the filter." + } + }, + "required": [ + "type", + "property", + "propertyType", + "operator", + "value" + ], + "additionalProperties": false, + "description": "Property filter for relation properties." + }, + { + "type": "object", + "properties": { + "type": { + "type": "string", + "enum": [ + "property" + ], + "description": "Selects the filter or filter-value variant." + }, + "property": { + "type": "string", + "description": "Exact data source property name to filter." + }, + "propertyType": { + "type": "string", + "enum": [ + "status" + ], + "description": "Notion property type used to select valid operators and value shapes." + }, + "operator": { + "type": "string", + "enum": [ + "status_is", + "status_is_not" + ], + "description": "Comparison or Boolean operation applied by this filter." + }, + "value": { + "anyOf": [ + { + "type": "object", + "properties": { + "type": { + "type": "string", + "enum": [ + "is_group", + "is_option" + ], + "description": "Selects the filter or filter-value variant." + }, + "value": { + "type": "string", + "description": "Literal or relative value used by the filter." + } + }, + "required": [ + "type", + "value" + ], + "additionalProperties": false + }, + { + "type": "array", + "items": { + "type": "object", + "properties": { + "type": { + "type": "string", + "enum": [ + "is_group", + "is_option" + ], + "description": "Selects the filter or filter-value variant." + }, + "value": { + "type": "string", + "description": "Literal or relative value used by the filter." + } + }, + "required": [ + "type", + "value" + ], + "additionalProperties": false + } + } + ], + "description": "Literal or relative value used by the filter." + } + }, + "required": [ + "type", + "property", + "propertyType", + "operator", + "value" + ], + "additionalProperties": false, + "description": "Property filter for status properties by option name." + }, + { + "type": "object", + "properties": { + "type": { + "type": "string", + "enum": [ + "property" + ], + "description": "Selects the filter or filter-value variant." + }, + "property": { + "type": "string", + "description": "Exact data source property name to filter." + }, + "propertyType": { + "type": "string", + "enum": [ + "person", + "created_by", + "last_edited_by" + ], + "description": "Notion property type used to select valid operators and value shapes." + }, + "operator": { + "type": "string", + "enum": [ + "person_contains", + "person_does_not_contain" + ], + "description": "Comparison or Boolean operation applied by this filter." + }, + "value": { + "anyOf": [ + { + "anyOf": [ + { + "type": "object", + "properties": { + "type": { + "type": "string", + "enum": [ + "exact" + ], + "description": "Selects the filter or filter-value variant." + }, + "value": { + "type": "string", + "description": "Literal or relative value used by the filter." + } + }, + "required": [ + "type", + "value" + ], + "additionalProperties": false + }, + { + "type": "object", + "properties": { + "type": { + "type": "string", + "enum": [ + "relative" + ], + "description": "Selects the filter or filter-value variant." + }, + "value": { + "type": "string", + "enum": [ + "me" + ], + "description": "Literal or relative value used by the filter." + } + }, + "required": [ + "type", + "value" + ], + "additionalProperties": false + } + ] + }, + { + "type": "array", + "items": { + "anyOf": [ + { + "type": "object", + "properties": { + "type": { + "type": "string", + "enum": [ + "exact" + ], + "description": "Selects the filter or filter-value variant." + }, + "value": { + "type": "string", + "description": "Literal or relative value used by the filter." + } + }, + "required": [ + "type", + "value" + ], + "additionalProperties": false + }, + { + "type": "object", + "properties": { + "type": { + "type": "string", + "enum": [ + "relative" + ], + "description": "Selects the filter or filter-value variant." + }, + "value": { + "type": "string", + "enum": [ + "me" + ], + "description": "Literal or relative value used by the filter." + } + }, + "required": [ + "type", + "value" + ], + "additionalProperties": false + } + ] + } + } + ], + "description": "Literal or relative value used by the filter." + } + }, + "required": [ + "type", + "property", + "propertyType", + "operator", + "value" + ], + "additionalProperties": false, + "description": "Property filter for person-like properties. Exact values use user://, bot://, organization_bot://, or space_permission_group:// URIs; relative values use me." + }, + { + "type": "object", + "properties": { + "type": { + "type": "string", + "enum": [ + "property" + ], + "description": "Selects the filter or filter-value variant." + }, + "property": { + "type": "string", + "description": "Exact data source property name to filter." + }, + "propertyType": { + "type": "string", + "enum": [ + "verification" + ], + "description": "Notion property type used to select valid operators and value shapes." + }, + "operator": { + "type": "string", + "enum": [ + "verification_is", + "verification_is_not" + ], + "description": "Comparison or Boolean operation applied by this filter." + }, + "value": { + "anyOf": [ + { + "type": "object", + "properties": { + "type": { + "type": "string", + "enum": [ + "exact" + ], + "description": "Selects the filter or filter-value variant." + }, + "value": { + "type": "string", + "enum": [ + "verified", + "expired", + "none" + ], + "description": "Literal or relative value used by the filter." + } + }, + "required": [ + "type", + "value" + ], + "additionalProperties": false + }, + { + "type": "array", + "items": { + "type": "object", + "properties": { + "type": { + "type": "string", + "enum": [ + "exact" + ], + "description": "Selects the filter or filter-value variant." + }, + "value": { + "type": "string", + "enum": [ + "verified", + "expired", + "none" + ], + "description": "Literal or relative value used by the filter." + } + }, + "required": [ + "type", + "value" + ], + "additionalProperties": false + } + } + ], + "description": "Literal or relative value used by the filter." + } + }, + "required": [ + "type", + "property", + "propertyType", + "operator", + "value" + ], + "additionalProperties": false, + "description": "Property filter for page verification state." + } + ], + "description": "Filter on the formula's result. The propertyType in the resultFilter should be the resultType of the formula." + } + }, + "required": [ + "type", + "property", + "propertyType", + "resultFilter" + ], + "additionalProperties": false, + "description": "Filter applied to a formula property." + } + ], + "description": "Filter applied to a single property." + }, + { + "type": "object", + "properties": { + "type": { + "type": "string", + "enum": [ + "group" + ], + "description": "Selects the filter or filter-value variant." + }, + "operator": { + "type": "string", + "enum": [ + "and", + "or" + ], + "description": "Comparison or Boolean operation applied by this filter." + }, + "filters": { + "maxItems": 100, + "type": "array", + "items": { + "anyOf": [ + { + "type": "object", + "properties": { + "type": { + "type": "string", + "enum": [ + "property" + ], + "description": "Selects the filter or filter-value variant." + }, + "property": { + "type": "string", + "description": "Exact data source property name to filter." + }, + "propertyType": { + "type": "string", + "description": "Notion property type used to select valid operators and value shapes." + }, + "operator": { + "type": "string", + "enum": [ + "is_empty", + "is_not_empty" + ], + "description": "Comparison or Boolean operation applied by this filter." + } + }, + "required": [ + "type", + "property", + "propertyType", + "operator" + ], + "additionalProperties": false, + "description": "Checks whether a property has any value." + }, + { + "type": "object", + "properties": { + "type": { + "type": "string", + "enum": [ + "property" + ], + "description": "Selects the filter or filter-value variant." + }, + "property": { + "type": "string", + "description": "Exact data source property name to filter." + }, + "propertyType": { + "type": "string", + "enum": [ + "title", + "text", + "url", + "email", + "phone_number" + ], + "description": "Notion property type used to select valid operators and value shapes." + }, + "operator": { + "type": "string", + "enum": [ + "string_is", + "string_is_not", + "string_contains", + "string_does_not_contain", + "string_starts_with", + "string_ends_with" + ], + "description": "Comparison or Boolean operation applied by this filter." + }, + "value": { + "type": "object", + "properties": { + "type": { + "type": "string", + "enum": [ + "exact" + ], + "description": "Selects the filter or filter-value variant." + }, + "value": { + "type": "string", + "description": "Literal or relative value used by the filter." + } + }, + "required": [ + "type", + "value" + ], + "additionalProperties": false, + "description": "Literal or relative value used by the filter." + } + }, + "required": [ + "type", + "property", + "propertyType", + "operator", + "value" + ], + "additionalProperties": false, + "description": "Property filter for text-like properties." + }, + { + "type": "object", + "properties": { + "type": { + "type": "string", + "enum": [ + "property" + ], + "description": "Selects the filter or filter-value variant." + }, + "property": { + "type": "string", + "description": "Exact data source property name to filter." + }, + "propertyType": { + "type": "string", + "enum": [ + "number", + "auto_increment_id" + ], + "description": "Notion property type used to select valid operators and value shapes." + }, + "operator": { + "type": "string", + "enum": [ + "number_equals", + "number_does_not_equal", + "number_greater_than", + "number_less_than", + "number_greater_than_or_equal_to", + "number_less_than_or_equal_to" + ], + "description": "Comparison or Boolean operation applied by this filter." + }, + "value": { + "type": "object", + "properties": { + "type": { + "type": "string", + "enum": [ + "exact" + ], + "description": "Selects the filter or filter-value variant." + }, + "value": { + "type": "number", + "description": "Literal or relative value used by the filter." + } + }, + "required": [ + "type", + "value" + ], + "additionalProperties": false, + "description": "Literal or relative value used by the filter." + } + }, + "required": [ + "type", + "property", + "propertyType", + "operator", + "value" + ], + "additionalProperties": false, + "description": "Property filter for number properties." + }, + { + "anyOf": [ + { + "type": "object", + "properties": { + "type": { + "type": "string", + "enum": [ + "property" + ], + "description": "Selects the filter or filter-value variant." + }, + "property": { + "type": "string", + "description": "Exact data source property name to filter." + }, + "propertyType": { + "type": "string", + "enum": [ + "date", + "created_time", + "last_edited_time", + "last_visited_time" + ], + "description": "Notion property type used to select valid operators and value shapes." + }, + "operator": { + "type": "string", + "enum": [ + "date_is", + "date_is_before", + "date_is_after", + "date_is_on_or_before", + "date_is_on_or_after" + ], + "description": "Comparison or Boolean operation applied by this filter." + }, + "value": { + "anyOf": [ + { + "type": "object", + "properties": { + "type": { + "type": "string", + "enum": [ + "exact" + ], + "description": "Selects the filter or filter-value variant." + }, + "value": { + "type": "string", + "description": "Literal or relative value used by the filter." + } + }, + "required": [ + "type", + "value" + ], + "additionalProperties": false + }, + { + "type": "object", + "properties": { + "type": { + "type": "string", + "enum": [ + "relative" + ], + "description": "Selects the filter or filter-value variant." + }, + "value": { + "type": "string", + "enum": [ + "today", + "tomorrow", + "yesterday", + "one_week_ago", + "one_week_from_now", + "one_month_ago", + "one_month_from_now" + ], + "description": "Literal or relative value used by the filter." + } + }, + "required": [ + "type", + "value" + ], + "additionalProperties": false + } + ], + "description": "Literal or relative value used by the filter." + }, + "use_end": { + "description": "For a date property, compare its end date instead of its start date.", + "type": "boolean" + } + }, + "required": [ + "type", + "property", + "propertyType", + "operator", + "value" + ], + "additionalProperties": false + }, + { + "type": "object", + "properties": { + "type": { + "type": "string", + "enum": [ + "property" + ], + "description": "Selects the filter or filter-value variant." + }, + "property": { + "type": "string", + "description": "Exact data source property name to filter." + }, + "propertyType": { + "type": "string", + "enum": [ + "date", + "created_time", + "last_edited_time", + "last_visited_time" + ], + "description": "Notion property type used to select valid operators and value shapes." + }, + "operator": { + "type": "string", + "enum": [ + "date_is_within", + "date_is_relative_to" + ], + "description": "Comparison or Boolean operation applied by this filter." + }, + "value": { + "anyOf": [ + { + "type": "object", + "properties": { + "type": { + "type": "string", + "enum": [ + "exact" + ], + "description": "Selects the filter or filter-value variant." + }, + "value": { + "type": "object", + "properties": { + "type": { + "type": "string", + "enum": [ + "daterange" + ], + "description": "Selects the filter or filter-value variant." + }, + "start_date": { + "description": "ISO 8601 date or date-time at the start of the range.", + "type": "string" + }, + "end_date": { + "description": "ISO 8601 date or date-time at the end of the range.", + "type": "string" + } + }, + "required": [ + "type" + ], + "additionalProperties": false, + "description": "Literal or relative value used by the filter." + } + }, + "required": [ + "type", + "value" + ], + "additionalProperties": false + }, + { + "type": "object", + "properties": { + "type": { + "type": "string", + "enum": [ + "relative" + ], + "description": "Selects the filter or filter-value variant." + }, + "value": { + "type": "string", + "enum": [ + "custom" + ], + "description": "Literal or relative value used by the filter." + }, + "direction": { + "type": "string", + "enum": [ + "past", + "future" + ], + "description": "Whether the custom range extends into the past or future." + }, + "unit": { + "type": "string", + "enum": [ + "year", + "month", + "week", + "day" + ], + "description": "Time unit used to measure a relative date range." + }, + "count": { + "type": "number", + "description": "Number of units in the custom relative range." + } + }, + "required": [ + "type", + "value", + "direction", + "unit", + "count" + ], + "additionalProperties": false + }, + { + "type": "object", + "properties": { + "type": { + "type": "string", + "enum": [ + "relative" + ], + "description": "Selects the filter or filter-value variant." + }, + "value": { + "type": "string", + "enum": [ + "surrounding" + ], + "description": "Literal or relative value used by the filter." + }, + "unit": { + "type": "string", + "enum": [ + "year", + "month", + "week", + "day" + ], + "description": "Time unit used to measure a relative date range." + } + }, + "required": [ + "type", + "value", + "unit" + ], + "additionalProperties": false + }, + { + "type": "object", + "properties": { + "type": { + "type": "string", + "enum": [ + "relative" + ], + "description": "Selects the filter or filter-value variant." + }, + "value": { + "type": "string", + "enum": [ + "this_week", + "the_past_week", + "the_past_month", + "the_past_year", + "the_next_week", + "the_next_month", + "the_next_year" + ], + "description": "Literal or relative value used by the filter." + } + }, + "required": [ + "type", + "value" + ], + "additionalProperties": false + } + ], + "description": "Literal or relative value used by the filter." + }, + "use_end": { + "description": "For a date property, compare its end date instead of its start date.", + "type": "boolean" + } + }, + "required": [ + "type", + "property", + "propertyType", + "operator", + "value" + ], + "additionalProperties": false + } + ], + "description": "Property filter for date properties." + }, + { + "type": "object", + "properties": { + "type": { + "type": "string", + "enum": [ + "property" + ], + "description": "Selects the filter or filter-value variant." + }, + "property": { + "type": "string", + "description": "Exact data source property name to filter." + }, + "propertyType": { + "type": "string", + "enum": [ + "select" + ], + "description": "Notion property type used to select valid operators and value shapes." + }, + "operator": { + "type": "string", + "enum": [ + "enum_is", + "enum_is_not" + ], + "description": "Comparison or Boolean operation applied by this filter." + }, + "value": { + "anyOf": [ + { + "type": "object", + "properties": { + "type": { + "type": "string", + "enum": [ + "exact" + ], + "description": "Selects the filter or filter-value variant." + }, + "value": { + "type": "string", + "description": "Literal or relative value used by the filter." + } + }, + "required": [ + "type", + "value" + ], + "additionalProperties": false + }, + { + "type": "array", + "items": { + "type": "object", + "properties": { + "type": { + "type": "string", + "enum": [ + "exact" + ], + "description": "Selects the filter or filter-value variant." + }, + "value": { + "type": "string", + "description": "Literal or relative value used by the filter." + } + }, + "required": [ + "type", + "value" + ], + "additionalProperties": false + } + } + ], + "description": "Literal or relative value used by the filter." + } + }, + "required": [ + "type", + "property", + "propertyType", + "operator", + "value" + ], + "additionalProperties": false, + "description": "Property filter for select properties by option name." + }, + { + "type": "object", + "properties": { + "type": { + "type": "string", + "enum": [ + "property" + ], + "description": "Selects the filter or filter-value variant." + }, + "property": { + "type": "string", + "description": "Exact data source property name to filter." + }, + "propertyType": { + "type": "string", + "enum": [ + "multi_select" + ], + "description": "Notion property type used to select valid operators and value shapes." + }, + "operator": { + "type": "string", + "enum": [ + "enum_contains", + "enum_does_not_contain" + ], + "description": "Comparison or Boolean operation applied by this filter." + }, + "value": { + "anyOf": [ + { + "type": "object", + "properties": { + "type": { + "type": "string", + "enum": [ + "exact" + ], + "description": "Selects the filter or filter-value variant." + }, + "value": { + "type": "string", + "description": "Literal or relative value used by the filter." + } + }, + "required": [ + "type", + "value" + ], + "additionalProperties": false + }, + { + "type": "array", + "items": { + "type": "object", + "properties": { + "type": { + "type": "string", + "enum": [ + "exact" + ], + "description": "Selects the filter or filter-value variant." + }, + "value": { + "type": "string", + "description": "Literal or relative value used by the filter." + } + }, + "required": [ + "type", + "value" + ], + "additionalProperties": false + } + } + ], + "description": "Literal or relative value used by the filter." + } + }, + "required": [ + "type", + "property", + "propertyType", + "operator", + "value" + ], + "additionalProperties": false, + "description": "Property filter for multi-select properties." + }, + { + "type": "object", + "properties": { + "type": { + "type": "string", + "enum": [ + "property" + ], + "description": "Selects the filter or filter-value variant." + }, + "property": { + "type": "string", + "description": "Exact data source property name to filter." + }, + "propertyType": { + "type": "string", + "enum": [ + "checkbox" + ], + "description": "Notion property type used to select valid operators and value shapes." + }, + "operator": { + "type": "string", + "enum": [ + "checkbox_is", + "checkbox_is_not" + ], + "description": "Comparison or Boolean operation applied by this filter." + }, + "value": { + "type": "object", + "properties": { + "type": { + "type": "string", + "enum": [ + "exact" + ], + "description": "Selects the filter or filter-value variant." + }, + "value": { + "type": "boolean", + "description": "Literal or relative value used by the filter." + } + }, + "required": [ + "type", + "value" + ], + "additionalProperties": false, + "description": "Literal or relative value used by the filter." + } + }, + "required": [ + "type", + "property", + "propertyType", + "operator", + "value" + ], + "additionalProperties": false, + "description": "Property filter for checkbox properties." + }, + { + "type": "object", + "properties": { + "type": { + "type": "string", + "enum": [ + "property" + ], + "description": "Selects the filter or filter-value variant." + }, + "property": { + "type": "string", + "description": "Exact data source property name to filter." + }, + "propertyType": { + "type": "string", + "enum": [ + "relation" + ], + "description": "Notion property type used to select valid operators and value shapes." + }, + "operator": { + "type": "string", + "enum": [ + "relation_contains", + "relation_does_not_contain" + ], + "description": "Comparison or Boolean operation applied by this filter." + }, + "value": { + "anyOf": [ + { + "type": "object", + "properties": { + "type": { + "type": "string", + "enum": [ + "exact" + ], + "description": "Selects the filter or filter-value variant." + }, + "value": { + "type": "string", + "description": "Literal or relative value used by the filter." + } + }, + "required": [ + "type", + "value" + ], + "additionalProperties": false + }, + { + "type": "array", + "items": { + "type": "object", + "properties": { + "type": { + "type": "string", + "enum": [ + "exact" + ], + "description": "Selects the filter or filter-value variant." + }, + "value": { + "type": "string", + "description": "Literal or relative value used by the filter." + } + }, + "required": [ + "type", + "value" + ], + "additionalProperties": false + } + } + ], + "description": "Literal or relative value used by the filter." + } + }, + "required": [ + "type", + "property", + "propertyType", + "operator", + "value" + ], + "additionalProperties": false, + "description": "Property filter for relation properties." + }, + { + "type": "object", + "properties": { + "type": { + "type": "string", + "enum": [ + "property" + ], + "description": "Selects the filter or filter-value variant." + }, + "property": { + "type": "string", + "description": "Exact data source property name to filter." + }, + "propertyType": { + "type": "string", + "enum": [ + "status" + ], + "description": "Notion property type used to select valid operators and value shapes." + }, + "operator": { + "type": "string", + "enum": [ + "status_is", + "status_is_not" + ], + "description": "Comparison or Boolean operation applied by this filter." + }, + "value": { + "anyOf": [ + { + "type": "object", + "properties": { + "type": { + "type": "string", + "enum": [ + "is_group", + "is_option" + ], + "description": "Selects the filter or filter-value variant." + }, + "value": { + "type": "string", + "description": "Literal or relative value used by the filter." + } + }, + "required": [ + "type", + "value" + ], + "additionalProperties": false + }, + { + "type": "array", + "items": { + "type": "object", + "properties": { + "type": { + "type": "string", + "enum": [ + "is_group", + "is_option" + ], + "description": "Selects the filter or filter-value variant." + }, + "value": { + "type": "string", + "description": "Literal or relative value used by the filter." + } + }, + "required": [ + "type", + "value" + ], + "additionalProperties": false + } + } + ], + "description": "Literal or relative value used by the filter." + } + }, + "required": [ + "type", + "property", + "propertyType", + "operator", + "value" + ], + "additionalProperties": false, + "description": "Property filter for status properties by option name." + }, + { + "type": "object", + "properties": { + "type": { + "type": "string", + "enum": [ + "property" + ], + "description": "Selects the filter or filter-value variant." + }, + "property": { + "type": "string", + "description": "Exact data source property name to filter." + }, + "propertyType": { + "type": "string", + "enum": [ + "person", + "created_by", + "last_edited_by" + ], + "description": "Notion property type used to select valid operators and value shapes." + }, + "operator": { + "type": "string", + "enum": [ + "person_contains", + "person_does_not_contain" + ], + "description": "Comparison or Boolean operation applied by this filter." + }, + "value": { + "anyOf": [ + { + "anyOf": [ + { + "type": "object", + "properties": { + "type": { + "type": "string", + "enum": [ + "exact" + ], + "description": "Selects the filter or filter-value variant." + }, + "value": { + "type": "string", + "description": "Literal or relative value used by the filter." + } + }, + "required": [ + "type", + "value" + ], + "additionalProperties": false + }, + { + "type": "object", + "properties": { + "type": { + "type": "string", + "enum": [ + "relative" + ], + "description": "Selects the filter or filter-value variant." + }, + "value": { + "type": "string", + "enum": [ + "me" + ], + "description": "Literal or relative value used by the filter." + } + }, + "required": [ + "type", + "value" + ], + "additionalProperties": false + } + ] + }, + { + "type": "array", + "items": { + "anyOf": [ + { + "type": "object", + "properties": { + "type": { + "type": "string", + "enum": [ + "exact" + ], + "description": "Selects the filter or filter-value variant." + }, + "value": { + "type": "string", + "description": "Literal or relative value used by the filter." + } + }, + "required": [ + "type", + "value" + ], + "additionalProperties": false + }, + { + "type": "object", + "properties": { + "type": { + "type": "string", + "enum": [ + "relative" + ], + "description": "Selects the filter or filter-value variant." + }, + "value": { + "type": "string", + "enum": [ + "me" + ], + "description": "Literal or relative value used by the filter." + } + }, + "required": [ + "type", + "value" + ], + "additionalProperties": false + } + ] + } + } + ], + "description": "Literal or relative value used by the filter." + } + }, + "required": [ + "type", + "property", + "propertyType", + "operator", + "value" + ], + "additionalProperties": false, + "description": "Property filter for person-like properties. Exact values use user://, bot://, organization_bot://, or space_permission_group:// URIs; relative values use me." + }, + { + "type": "object", + "properties": { + "type": { + "type": "string", + "enum": [ + "property" + ], + "description": "Selects the filter or filter-value variant." + }, + "property": { + "type": "string", + "description": "Exact data source property name to filter." + }, + "propertyType": { + "type": "string", + "enum": [ + "verification" + ], + "description": "Notion property type used to select valid operators and value shapes." + }, + "operator": { + "type": "string", + "enum": [ + "verification_is", + "verification_is_not" + ], + "description": "Comparison or Boolean operation applied by this filter." + }, + "value": { + "anyOf": [ + { + "type": "object", + "properties": { + "type": { + "type": "string", + "enum": [ + "exact" + ], + "description": "Selects the filter or filter-value variant." + }, + "value": { + "type": "string", + "enum": [ + "verified", + "expired", + "none" + ], + "description": "Literal or relative value used by the filter." + } + }, + "required": [ + "type", + "value" + ], + "additionalProperties": false + }, + { + "type": "array", + "items": { + "type": "object", + "properties": { + "type": { + "type": "string", + "enum": [ + "exact" + ], + "description": "Selects the filter or filter-value variant." + }, + "value": { + "type": "string", + "enum": [ + "verified", + "expired", + "none" + ], + "description": "Literal or relative value used by the filter." + } + }, + "required": [ + "type", + "value" + ], + "additionalProperties": false + } + } + ], + "description": "Literal or relative value used by the filter." + } + }, + "required": [ + "type", + "property", + "propertyType", + "operator", + "value" + ], + "additionalProperties": false, + "description": "Property filter for page verification state." + }, + { + "type": "object", + "properties": { + "type": { + "type": "string", + "enum": [ + "property" + ], + "description": "Selects the filter or filter-value variant." + }, + "property": { + "type": "string", + "description": "Exact data source property name to filter." + }, + "propertyType": { + "type": "string", + "enum": [ + "formula" + ], + "description": "Notion property type used to select valid operators and value shapes." + }, + "operator": { + "description": "Comparison or Boolean operation applied by this filter.", + "type": "string", + "enum": [ + "any", + "none", + "every" + ] + }, + "resultFilter": { + "anyOf": [ + { + "type": "object", + "properties": { + "type": { + "type": "string", + "enum": [ + "property" + ], + "description": "Selects the filter or filter-value variant." + }, + "property": { + "type": "string", + "description": "Exact data source property name to filter." + }, + "propertyType": { + "type": "string", + "description": "Notion property type used to select valid operators and value shapes." + }, + "operator": { + "type": "string", + "enum": [ + "is_empty", + "is_not_empty" + ], + "description": "Comparison or Boolean operation applied by this filter." + } + }, + "required": [ + "type", + "property", + "propertyType", + "operator" + ], + "additionalProperties": false, + "description": "Checks whether a property has any value." + }, + { + "type": "object", + "properties": { + "type": { + "type": "string", + "enum": [ + "property" + ], + "description": "Selects the filter or filter-value variant." + }, + "property": { + "type": "string", + "description": "Exact data source property name to filter." + }, + "propertyType": { + "type": "string", + "enum": [ + "title", + "text", + "url", + "email", + "phone_number" + ], + "description": "Notion property type used to select valid operators and value shapes." + }, + "operator": { + "type": "string", + "enum": [ + "string_is", + "string_is_not", + "string_contains", + "string_does_not_contain", + "string_starts_with", + "string_ends_with" + ], + "description": "Comparison or Boolean operation applied by this filter." + }, + "value": { + "type": "object", + "properties": { + "type": { + "type": "string", + "enum": [ + "exact" + ], + "description": "Selects the filter or filter-value variant." + }, + "value": { + "type": "string", + "description": "Literal or relative value used by the filter." + } + }, + "required": [ + "type", + "value" + ], + "additionalProperties": false, + "description": "Literal or relative value used by the filter." + } + }, + "required": [ + "type", + "property", + "propertyType", + "operator", + "value" + ], + "additionalProperties": false, + "description": "Property filter for text-like properties." + }, + { + "type": "object", + "properties": { + "type": { + "type": "string", + "enum": [ + "property" + ], + "description": "Selects the filter or filter-value variant." + }, + "property": { + "type": "string", + "description": "Exact data source property name to filter." + }, + "propertyType": { + "type": "string", + "enum": [ + "number", + "auto_increment_id" + ], + "description": "Notion property type used to select valid operators and value shapes." + }, + "operator": { + "type": "string", + "enum": [ + "number_equals", + "number_does_not_equal", + "number_greater_than", + "number_less_than", + "number_greater_than_or_equal_to", + "number_less_than_or_equal_to" + ], + "description": "Comparison or Boolean operation applied by this filter." + }, + "value": { + "type": "object", + "properties": { + "type": { + "type": "string", + "enum": [ + "exact" + ], + "description": "Selects the filter or filter-value variant." + }, + "value": { + "type": "number", + "description": "Literal or relative value used by the filter." + } + }, + "required": [ + "type", + "value" + ], + "additionalProperties": false, + "description": "Literal or relative value used by the filter." + } + }, + "required": [ + "type", + "property", + "propertyType", + "operator", + "value" + ], + "additionalProperties": false, + "description": "Property filter for number properties." + }, + { + "anyOf": [ + { + "type": "object", + "properties": { + "type": { + "type": "string", + "enum": [ + "property" + ], + "description": "Selects the filter or filter-value variant." + }, + "property": { + "type": "string", + "description": "Exact data source property name to filter." + }, + "propertyType": { + "type": "string", + "enum": [ + "date", + "created_time", + "last_edited_time", + "last_visited_time" + ], + "description": "Notion property type used to select valid operators and value shapes." + }, + "operator": { + "type": "string", + "enum": [ + "date_is", + "date_is_before", + "date_is_after", + "date_is_on_or_before", + "date_is_on_or_after" + ], + "description": "Comparison or Boolean operation applied by this filter." + }, + "value": { + "anyOf": [ + { + "type": "object", + "properties": { + "type": { + "type": "string", + "enum": [ + "exact" + ], + "description": "Selects the filter or filter-value variant." + }, + "value": { + "type": "string", + "description": "Literal or relative value used by the filter." + } + }, + "required": [ + "type", + "value" + ], + "additionalProperties": false + }, + { + "type": "object", + "properties": { + "type": { + "type": "string", + "enum": [ + "relative" + ], + "description": "Selects the filter or filter-value variant." + }, + "value": { + "type": "string", + "enum": [ + "today", + "tomorrow", + "yesterday", + "one_week_ago", + "one_week_from_now", + "one_month_ago", + "one_month_from_now" + ], + "description": "Literal or relative value used by the filter." + } + }, + "required": [ + "type", + "value" + ], + "additionalProperties": false + } + ], + "description": "Literal or relative value used by the filter." + }, + "use_end": { + "description": "For a date property, compare its end date instead of its start date.", + "type": "boolean" + } + }, + "required": [ + "type", + "property", + "propertyType", + "operator", + "value" + ], + "additionalProperties": false + }, + { + "type": "object", + "properties": { + "type": { + "type": "string", + "enum": [ + "property" + ], + "description": "Selects the filter or filter-value variant." + }, + "property": { + "type": "string", + "description": "Exact data source property name to filter." + }, + "propertyType": { + "type": "string", + "enum": [ + "date", + "created_time", + "last_edited_time", + "last_visited_time" + ], + "description": "Notion property type used to select valid operators and value shapes." + }, + "operator": { + "type": "string", + "enum": [ + "date_is_within", + "date_is_relative_to" + ], + "description": "Comparison or Boolean operation applied by this filter." + }, + "value": { + "anyOf": [ + { + "type": "object", + "properties": { + "type": { + "type": "string", + "enum": [ + "exact" + ], + "description": "Selects the filter or filter-value variant." + }, + "value": { + "type": "object", + "properties": { + "type": { + "type": "string", + "enum": [ + "daterange" + ], + "description": "Selects the filter or filter-value variant." + }, + "start_date": { + "description": "ISO 8601 date or date-time at the start of the range.", + "type": "string" + }, + "end_date": { + "description": "ISO 8601 date or date-time at the end of the range.", + "type": "string" + } + }, + "required": [ + "type" + ], + "additionalProperties": false, + "description": "Literal or relative value used by the filter." + } + }, + "required": [ + "type", + "value" + ], + "additionalProperties": false + }, + { + "type": "object", + "properties": { + "type": { + "type": "string", + "enum": [ + "relative" + ], + "description": "Selects the filter or filter-value variant." + }, + "value": { + "type": "string", + "enum": [ + "custom" + ], + "description": "Literal or relative value used by the filter." + }, + "direction": { + "type": "string", + "enum": [ + "past", + "future" + ], + "description": "Whether the custom range extends into the past or future." + }, + "unit": { + "type": "string", + "enum": [ + "year", + "month", + "week", + "day" + ], + "description": "Time unit used to measure a relative date range." + }, + "count": { + "type": "number", + "description": "Number of units in the custom relative range." + } + }, + "required": [ + "type", + "value", + "direction", + "unit", + "count" + ], + "additionalProperties": false + }, + { + "type": "object", + "properties": { + "type": { + "type": "string", + "enum": [ + "relative" + ], + "description": "Selects the filter or filter-value variant." + }, + "value": { + "type": "string", + "enum": [ + "surrounding" + ], + "description": "Literal or relative value used by the filter." + }, + "unit": { + "type": "string", + "enum": [ + "year", + "month", + "week", + "day" + ], + "description": "Time unit used to measure a relative date range." + } + }, + "required": [ + "type", + "value", + "unit" + ], + "additionalProperties": false + }, + { + "type": "object", + "properties": { + "type": { + "type": "string", + "enum": [ + "relative" + ], + "description": "Selects the filter or filter-value variant." + }, + "value": { + "type": "string", + "enum": [ + "this_week", + "the_past_week", + "the_past_month", + "the_past_year", + "the_next_week", + "the_next_month", + "the_next_year" + ], + "description": "Literal or relative value used by the filter." + } + }, + "required": [ + "type", + "value" + ], + "additionalProperties": false + } + ], + "description": "Literal or relative value used by the filter." + }, + "use_end": { + "description": "For a date property, compare its end date instead of its start date.", + "type": "boolean" + } + }, + "required": [ + "type", + "property", + "propertyType", + "operator", + "value" + ], + "additionalProperties": false + } + ], + "description": "Property filter for date properties." + }, + { + "type": "object", + "properties": { + "type": { + "type": "string", + "enum": [ + "property" + ], + "description": "Selects the filter or filter-value variant." + }, + "property": { + "type": "string", + "description": "Exact data source property name to filter." + }, + "propertyType": { + "type": "string", + "enum": [ + "select" + ], + "description": "Notion property type used to select valid operators and value shapes." + }, + "operator": { + "type": "string", + "enum": [ + "enum_is", + "enum_is_not" + ], + "description": "Comparison or Boolean operation applied by this filter." + }, + "value": { + "anyOf": [ + { + "type": "object", + "properties": { + "type": { + "type": "string", + "enum": [ + "exact" + ], + "description": "Selects the filter or filter-value variant." + }, + "value": { + "type": "string", + "description": "Literal or relative value used by the filter." + } + }, + "required": [ + "type", + "value" + ], + "additionalProperties": false + }, + { + "type": "array", + "items": { + "type": "object", + "properties": { + "type": { + "type": "string", + "enum": [ + "exact" + ], + "description": "Selects the filter or filter-value variant." + }, + "value": { + "type": "string", + "description": "Literal or relative value used by the filter." + } + }, + "required": [ + "type", + "value" + ], + "additionalProperties": false + } + } + ], + "description": "Literal or relative value used by the filter." + } + }, + "required": [ + "type", + "property", + "propertyType", + "operator", + "value" + ], + "additionalProperties": false, + "description": "Property filter for select properties by option name." + }, + { + "type": "object", + "properties": { + "type": { + "type": "string", + "enum": [ + "property" + ], + "description": "Selects the filter or filter-value variant." + }, + "property": { + "type": "string", + "description": "Exact data source property name to filter." + }, + "propertyType": { + "type": "string", + "enum": [ + "multi_select" + ], + "description": "Notion property type used to select valid operators and value shapes." + }, + "operator": { + "type": "string", + "enum": [ + "enum_contains", + "enum_does_not_contain" + ], + "description": "Comparison or Boolean operation applied by this filter." + }, + "value": { + "anyOf": [ + { + "type": "object", + "properties": { + "type": { + "type": "string", + "enum": [ + "exact" + ], + "description": "Selects the filter or filter-value variant." + }, + "value": { + "type": "string", + "description": "Literal or relative value used by the filter." + } + }, + "required": [ + "type", + "value" + ], + "additionalProperties": false + }, + { + "type": "array", + "items": { + "type": "object", + "properties": { + "type": { + "type": "string", + "enum": [ + "exact" + ], + "description": "Selects the filter or filter-value variant." + }, + "value": { + "type": "string", + "description": "Literal or relative value used by the filter." + } + }, + "required": [ + "type", + "value" + ], + "additionalProperties": false + } + } + ], + "description": "Literal or relative value used by the filter." + } + }, + "required": [ + "type", + "property", + "propertyType", + "operator", + "value" + ], + "additionalProperties": false, + "description": "Property filter for multi-select properties." + }, + { + "type": "object", + "properties": { + "type": { + "type": "string", + "enum": [ + "property" + ], + "description": "Selects the filter or filter-value variant." + }, + "property": { + "type": "string", + "description": "Exact data source property name to filter." + }, + "propertyType": { + "type": "string", + "enum": [ + "checkbox" + ], + "description": "Notion property type used to select valid operators and value shapes." + }, + "operator": { + "type": "string", + "enum": [ + "checkbox_is", + "checkbox_is_not" + ], + "description": "Comparison or Boolean operation applied by this filter." + }, + "value": { + "type": "object", + "properties": { + "type": { + "type": "string", + "enum": [ + "exact" + ], + "description": "Selects the filter or filter-value variant." + }, + "value": { + "type": "boolean", + "description": "Literal or relative value used by the filter." + } + }, + "required": [ + "type", + "value" + ], + "additionalProperties": false, + "description": "Literal or relative value used by the filter." + } + }, + "required": [ + "type", + "property", + "propertyType", + "operator", + "value" + ], + "additionalProperties": false, + "description": "Property filter for checkbox properties." + }, + { + "type": "object", + "properties": { + "type": { + "type": "string", + "enum": [ + "property" + ], + "description": "Selects the filter or filter-value variant." + }, + "property": { + "type": "string", + "description": "Exact data source property name to filter." + }, + "propertyType": { + "type": "string", + "enum": [ + "relation" + ], + "description": "Notion property type used to select valid operators and value shapes." + }, + "operator": { + "type": "string", + "enum": [ + "relation_contains", + "relation_does_not_contain" + ], + "description": "Comparison or Boolean operation applied by this filter." + }, + "value": { + "anyOf": [ + { + "type": "object", + "properties": { + "type": { + "type": "string", + "enum": [ + "exact" + ], + "description": "Selects the filter or filter-value variant." + }, + "value": { + "type": "string", + "description": "Literal or relative value used by the filter." + } + }, + "required": [ + "type", + "value" + ], + "additionalProperties": false + }, + { + "type": "array", + "items": { + "type": "object", + "properties": { + "type": { + "type": "string", + "enum": [ + "exact" + ], + "description": "Selects the filter or filter-value variant." + }, + "value": { + "type": "string", + "description": "Literal or relative value used by the filter." + } + }, + "required": [ + "type", + "value" + ], + "additionalProperties": false + } + } + ], + "description": "Literal or relative value used by the filter." + } + }, + "required": [ + "type", + "property", + "propertyType", + "operator", + "value" + ], + "additionalProperties": false, + "description": "Property filter for relation properties." + }, + { + "type": "object", + "properties": { + "type": { + "type": "string", + "enum": [ + "property" + ], + "description": "Selects the filter or filter-value variant." + }, + "property": { + "type": "string", + "description": "Exact data source property name to filter." + }, + "propertyType": { + "type": "string", + "enum": [ + "status" + ], + "description": "Notion property type used to select valid operators and value shapes." + }, + "operator": { + "type": "string", + "enum": [ + "status_is", + "status_is_not" + ], + "description": "Comparison or Boolean operation applied by this filter." + }, + "value": { + "anyOf": [ + { + "type": "object", + "properties": { + "type": { + "type": "string", + "enum": [ + "is_group", + "is_option" + ], + "description": "Selects the filter or filter-value variant." + }, + "value": { + "type": "string", + "description": "Literal or relative value used by the filter." + } + }, + "required": [ + "type", + "value" + ], + "additionalProperties": false + }, + { + "type": "array", + "items": { + "type": "object", + "properties": { + "type": { + "type": "string", + "enum": [ + "is_group", + "is_option" + ], + "description": "Selects the filter or filter-value variant." + }, + "value": { + "type": "string", + "description": "Literal or relative value used by the filter." + } + }, + "required": [ + "type", + "value" + ], + "additionalProperties": false + } + } + ], + "description": "Literal or relative value used by the filter." + } + }, + "required": [ + "type", + "property", + "propertyType", + "operator", + "value" + ], + "additionalProperties": false, + "description": "Property filter for status properties by option name." + }, + { + "type": "object", + "properties": { + "type": { + "type": "string", + "enum": [ + "property" + ], + "description": "Selects the filter or filter-value variant." + }, + "property": { + "type": "string", + "description": "Exact data source property name to filter." + }, + "propertyType": { + "type": "string", + "enum": [ + "person", + "created_by", + "last_edited_by" + ], + "description": "Notion property type used to select valid operators and value shapes." + }, + "operator": { + "type": "string", + "enum": [ + "person_contains", + "person_does_not_contain" + ], + "description": "Comparison or Boolean operation applied by this filter." + }, + "value": { + "anyOf": [ + { + "anyOf": [ + { + "type": "object", + "properties": { + "type": { + "type": "string", + "enum": [ + "exact" + ], + "description": "Selects the filter or filter-value variant." + }, + "value": { + "type": "string", + "description": "Literal or relative value used by the filter." + } + }, + "required": [ + "type", + "value" + ], + "additionalProperties": false + }, + { + "type": "object", + "properties": { + "type": { + "type": "string", + "enum": [ + "relative" + ], + "description": "Selects the filter or filter-value variant." + }, + "value": { + "type": "string", + "enum": [ + "me" + ], + "description": "Literal or relative value used by the filter." + } + }, + "required": [ + "type", + "value" + ], + "additionalProperties": false + } + ] + }, + { + "type": "array", + "items": { + "anyOf": [ + { + "type": "object", + "properties": { + "type": { + "type": "string", + "enum": [ + "exact" + ], + "description": "Selects the filter or filter-value variant." + }, + "value": { + "type": "string", + "description": "Literal or relative value used by the filter." + } + }, + "required": [ + "type", + "value" + ], + "additionalProperties": false + }, + { + "type": "object", + "properties": { + "type": { + "type": "string", + "enum": [ + "relative" + ], + "description": "Selects the filter or filter-value variant." + }, + "value": { + "type": "string", + "enum": [ + "me" + ], + "description": "Literal or relative value used by the filter." + } + }, + "required": [ + "type", + "value" + ], + "additionalProperties": false + } + ] + } + } + ], + "description": "Literal or relative value used by the filter." + } + }, + "required": [ + "type", + "property", + "propertyType", + "operator", + "value" + ], + "additionalProperties": false, + "description": "Property filter for person-like properties. Exact values use user://, bot://, organization_bot://, or space_permission_group:// URIs; relative values use me." + }, + { + "type": "object", + "properties": { + "type": { + "type": "string", + "enum": [ + "property" + ], + "description": "Selects the filter or filter-value variant." + }, + "property": { + "type": "string", + "description": "Exact data source property name to filter." + }, + "propertyType": { + "type": "string", + "enum": [ + "verification" + ], + "description": "Notion property type used to select valid operators and value shapes." + }, + "operator": { + "type": "string", + "enum": [ + "verification_is", + "verification_is_not" + ], + "description": "Comparison or Boolean operation applied by this filter." + }, + "value": { + "anyOf": [ + { + "type": "object", + "properties": { + "type": { + "type": "string", + "enum": [ + "exact" + ], + "description": "Selects the filter or filter-value variant." + }, + "value": { + "type": "string", + "enum": [ + "verified", + "expired", + "none" + ], + "description": "Literal or relative value used by the filter." + } + }, + "required": [ + "type", + "value" + ], + "additionalProperties": false + }, + { + "type": "array", + "items": { + "type": "object", + "properties": { + "type": { + "type": "string", + "enum": [ + "exact" + ], + "description": "Selects the filter or filter-value variant." + }, + "value": { + "type": "string", + "enum": [ + "verified", + "expired", + "none" + ], + "description": "Literal or relative value used by the filter." + } + }, + "required": [ + "type", + "value" + ], + "additionalProperties": false + } + } + ], + "description": "Literal or relative value used by the filter." + } + }, + "required": [ + "type", + "property", + "propertyType", + "operator", + "value" + ], + "additionalProperties": false, + "description": "Property filter for page verification state." + } + ], + "description": "Filter on the formula's result. The propertyType in the resultFilter should be the resultType of the formula." + } + }, + "required": [ + "type", + "property", + "propertyType", + "resultFilter" + ], + "additionalProperties": false, + "description": "Filter applied to a formula property." + } + ], + "description": "Filter applied to a single property." + }, + "description": "Child filters combined by the Boolean group operator." + } + }, + "required": [ + "type", + "operator", + "filters" + ], + "additionalProperties": false + } + ] + }, + "description": "Child filters combined by the Boolean group operator." + } + }, + "required": [ + "type", + "operator", + "filters" + ], + "additionalProperties": false + }, + "sort": { + "description": "Structured property sorts applied in order.", + "maxItems": 100, + "type": "array", + "items": { + "type": "object", + "properties": { + "property": { + "type": "string", + "description": "Exact data source property name to sort." + }, + "direction": { + "type": "string", + "enum": [ + "ascending", + "descending" + ], + "description": "One of: `ascending`, `descending`" + } + }, + "required": [ + "property", + "direction" + ], + "additionalProperties": false + } + }, + "limit": { + "description": "Number of rows to return (default: 50, max: 100).", + "type": "integer", + "minimum": 1, + "maximum": 100 + } + }, + "required": [ + "mode", + "data_source_url" + ], + "additionalProperties": false + } + ] + } + }, + "required": [ + "data" + ], + "$schema": "https://json-schema.org/draft/2020-12/schema", + "additionalProperties": {} + }, + "outputSchema": null, + "description": "Query Notion data sources using faithful structured rows, SQL, or a saved view.\n\nIf availability is not already known for this connection, call get_tool_access with {} before using this tool. Reuse the returned access map across tools; chec" + }, + { + "name": "notion-query-multiple-data-sources", + "title": "Query multiple Notion data sources", + "annotations": { + "readOnlyHint": true, + "destructiveHint": false, + "idempotentHint": true, + "openWorldHint": false + }, + "inputSchema": { + "type": "object", + "properties": { + "query": { + "type": "string", + "description": "Read-only SQLite query to execute against the data sources. Use a data source URL as the table name, e.g. SELECT * FROM \"collection://...\" WHERE .... Include every needed filter in WHERE (filters on views of the data source are not automatically applied). For time comparisons or ordering, normalize text timestamps with datetime(...) or date(...). SQL text values can omit rich-text mentions and formatting, and links can lose their destination. Use faithful rows mode or fetch the page before rewriting a rich-text property." + }, + "data_source_urls": { + "description": "Notion data source URLs whose SQLite tables are available to the query; each data source is exposed as a table named by its URL. Obtain them from the fetch tool, in the format: collection://f336d0bc-b841-465b-8045-024475c079dd", + "minItems": 2, + "maxItems": 100, + "type": "array", + "items": { + "type": "string" + } + }, + "params": { + "description": "Positional parameters bound to `?` placeholders in the query. Prefer parameterized queries over string interpolation. Use \"__YES__\" for checked checkboxes and \"__NO__\" for unchecked checkboxes.", + "maxItems": 100, + "type": "array", + "items": { + "anyOf": [ + { + "type": "string" + }, + { + "type": "number" + }, + { + "type": "boolean" + }, + { + "type": "null" + } + ] + } + }, + "mode": { + "description": "Optional SQL mode marker. This tool only supports SQL queries.", + "type": "string", + "enum": [ + "sql" + ] + } + }, + "required": [ + "query", + "data_source_urls" + ], + "$schema": "https://json-schema.org/draft/2020-12/schema", + "additionalProperties": false + }, + "outputSchema": null, + "description": "Query data across multiple Notion data sources using read-only SQLite SQL.\n\nIf availability is not already known for this connection, call get_tool_access with {} before using this tool. Reuse the returned access map across tools; check the" + }, + { + "name": "notion-query-meeting-notes", + "title": "Query Notion meeting notes", + "annotations": { + "readOnlyHint": true, + "destructiveHint": false, + "idempotentHint": true, + "openWorldHint": false + }, + "inputSchema": { + "type": "object", + "properties": { + "filter": { + "description": "Meeting note filter reference.\n\nTitle keyword searching uses a filter on property \"title\" (for example, string_contains). Returns up to 50 rows of matching meeting notes.\n\nFilterable properties:\n- \"title\" (text) \u2014 meeting title\n- \"attendees\" (person) \u2014 meeting attendees\n- \"created_time\" (date) \u2014 when the meeting note was created\n- \"created_by\" (person) \u2014 who created the meeting note\n- \"last_edited_time\" (date) \u2014 when the meeting note was last edited\n- \"last_edited_by\" (person) \u2014 who last edited the meeting note\n\n\nCombinator filters use \"filters\" (not \"operands\"): { \"operator\": \"and\" | \"or\", \"filters\": [ ... ] }\n\nDate filtering (recommended default: date_is_within):\n- Prefer \"date_is_within\" for relative windows like \"past N days/weeks/months\".\n- Relative (common): { type: \"relative\", value: \"the_past_week\" | \"the_past_month\" | \"this_week\" }\n- Relative (custom): { type: \"relative\", value: \"custom\", direction: \"past\" | \"future\", unit: \"day\" | \"week\" | \"month\" | \"year\", count: }\n- Exact range: { type: \"exact\", value: { type: \"daterange\", start_date: \"YYYY-MM-DD\", end_date: \"YYYY-MM-DD\" } }\n- Single-date operators (\"date_is\", \"date_is_before\", \"date_is_after\", \"date_is_on_or_before\", \"date_is_on_or_after\"):\n- Exact: { type: \"exact\", value: { type: \"date\", start_date: \"YYYY-MM-DD\" } }\n- Relative shortcuts: today | tomorrow | yesterday | one_week_ago | one_week_from_now | one_month_ago | one_month_from_now\n\n\nTitle keyword filtering (OR vs AND):\n- Use OR (\"operator\": \"or\") when unsure or for broad discovery.\n- Use AND (\"operator\": \"and\") when the user is specific and you want to narrow results.\n- Break multi-word phrases into individual terms and filter on each term separately.\n\n\nExamples:\n- Past week: {\"operator\":\"and\",\"filters\":[{\"property\":\"created_time\",\"filter\":{\"operator\":\"date_is_within\",\"value\":{\"type\":\"relative\",\"value\":\"the_past_week\"}}}]}\n- Past 3 days: {\"operator\":\"and\",\"filters\":[{\"property\":\"created_time\",\"filter\":{\"operator\":\"date_is_within\",\"value\":{\"type\":\"relative\",\"value\":\"custom\",\"direction\":\"past\",\"unit\":\"day\",\"count\":3}}}]}\n- Exact date range: {\"operator\":\"and\",\"filters\":[{\"property\":\"created_time\",\"filter\":{\"operator\":\"date_is_within\",\"value\":{\"type\":\"exact\",\"value\":{\"type\":\"daterange\",\"start_date\":\"2025-01-01\",\"end_date\":\"2025-12-31\"}}}}]}\n- Created after a date: {\"operator\":\"and\",\"filters\":[{\"property\":\"created_time\",\"filter\":{\"operator\":\"date_is_after\",\"value\":{\"type\":\"exact\",\"value\":{\"type\":\"date\",\"start_date\":\"2025-06-01\"}}}}]}\n- Specific attendee: {\"operator\":\"and\",\"filters\":[{\"property\":\"attendees\",\"filter\":{\"operator\":\"person_contains\",\"value\":[{\"type\":\"exact\",\"value\":{\"table\":\"notion_user\",\"id\":\"\"}}]}}]}\n- Attendee since a date: {\"operator\":\"and\",\"filters\":[{\"property\":\"created_time\",\"filter\":{\"operator\":\"date_is_on_or_after\",\"value\":{\"type\":\"exact\",\"value\":{\"type\":\"date\",\"start_date\":\"2025-01-01\"}}}},{\"property\":\"attendees\",\"filter\":{\"operator\":\"person_contains\",\"value\":[{\"type\":\"exact\",\"value\":{\"table\":\"notion_user\",\"id\":\"\"}}]}}]}\n- Title contains both terms: {\"operator\":\"and\",\"filters\":[{\"property\":\"title\",\"filter\":{\"operator\":\"string_contains\",\"value\":{\"type\":\"exact\",\"value\":\"design\"}}},{\"property\":\"title\",\"filter\":{\"operator\":\"string_contains\",\"value\":{\"type\":\"exact\",\"value\":\"review\"}}}]}\n- Title contains either term: {\"operator\":\"or\",\"filters\":[{\"property\":\"title\",\"filter\":{\"operator\":\"string_contains\",\"value\":{\"type\":\"exact\",\"value\":\"standup\"}}},{\"property\":\"title\",\"filter\":{\"operator\":\"string_contains\",\"value\":{\"type\":\"exact\",\"value\":\"sync\"}}}]}", + "type": "object", + "properties": { + "operator": { + "type": "string", + "enum": [ + "and", + "or" + ], + "description": "Operator for combinator filters." + }, + "filters": { + "description": "Nested filters; each may be a combinator (and/or) or property filter.", + "maxItems": 100, + "type": "array", + "items": { + "anyOf": [ + { + "type": "object", + "properties": { + "property": { + "type": "string", + "enum": [ + "title", + "attendees", + "created_time", + "created_by", + "last_edited_time", + "last_edited_by", + "notion://meeting_notes/attendees" + ], + "description": "Which meeting-note property to filter on. Prefer the short names; the schema URI form is accepted for compatibility." + }, + "filter": { + "anyOf": [ + { + "type": "object", + "properties": { + "operator": { + "type": "string", + "enum": [ + "string_is", + "string_is_not", + "string_contains", + "string_does_not_contain", + "string_starts_with", + "string_ends_with" + ], + "description": "How to compare the text." + }, + "value": { + "type": "object", + "properties": { + "type": { + "type": "string", + "enum": [ + "exact" + ], + "description": "Always `exact`" + }, + "value": { + "type": "string", + "description": "The literal text the operator compares against." + } + }, + "required": [ + "type", + "value" + ], + "additionalProperties": false, + "description": "The text to compare against." + } + }, + "required": [ + "operator", + "value" + ], + "additionalProperties": false + }, + { + "type": "object", + "properties": { + "operator": { + "type": "string", + "enum": [ + "person_contains", + "person_does_not_contain" + ], + "description": "Whether the property must contain the people listed." + }, + "value": { + "maxItems": 100, + "type": "array", + "items": { + "anyOf": [ + { + "type": "object", + "properties": { + "type": { + "type": "string", + "enum": [ + "exact" + ], + "description": "Always `exact`" + }, + "value": { + "type": "object", + "properties": { + "table": { + "type": "string", + "enum": [ + "notion_user" + ], + "description": "Always `notion_user`" + }, + "id": { + "type": "string", + "description": "The user's ID, as a UUID or the `user://` form returned by user search." + } + }, + "required": [ + "table", + "id" + ], + "additionalProperties": false, + "description": "Pointer to the Notion user to match." + } + }, + "required": [ + "type", + "value" + ], + "additionalProperties": false + }, + { + "type": "object", + "properties": { + "type": { + "type": "string", + "enum": [ + "relative" + ], + "description": "Always `relative`" + }, + "value": { + "type": "string", + "enum": [ + "me" + ], + "description": "Always `me`" + } + }, + "required": [ + "type", + "value" + ], + "additionalProperties": false + } + ] + }, + "description": "The people to compare against." + } + }, + "required": [ + "operator", + "value" + ], + "additionalProperties": false + }, + { + "type": "object", + "properties": { + "operator": { + "type": "string", + "enum": [ + "date_is", + "date_is_before", + "date_is_after", + "date_is_on_or_before", + "date_is_on_or_after" + ], + "description": "How to compare the date." + }, + "value": { + "anyOf": [ + { + "type": "object", + "properties": { + "type": { + "type": "string", + "enum": [ + "relative" + ], + "description": "Always `relative`" + }, + "value": { + "type": "string", + "enum": [ + "today", + "tomorrow", + "yesterday", + "one_week_ago", + "one_week_from_now", + "one_month_ago", + "one_month_from_now" + ], + "description": "One of: `today`, `tomorrow`, `yesterday`, `one_week_ago`, `one_week_from_now`, `one_month_ago`, `one_month_from_now`" + } + }, + "required": [ + "type", + "value" + ], + "additionalProperties": false + }, + { + "type": "object", + "properties": { + "type": { + "type": "string", + "enum": [ + "exact" + ], + "description": "Always `exact`" + }, + "value": { + "anyOf": [ + { + "type": "object", + "properties": { + "type": { + "type": "string", + "enum": [ + "date" + ], + "description": "Always `date`" + }, + "start_date": { + "type": "string", + "format": "date", + "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$", + "description": "The calendar date as an ISO 8601 date string." + } + }, + "required": [ + "type", + "start_date" + ], + "additionalProperties": false + }, + { + "type": "object", + "properties": { + "type": { + "type": "string", + "enum": [ + "datetime" + ], + "description": "Always `datetime`" + }, + "start_date": { + "type": "string", + "format": "date", + "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$", + "description": "The calendar date as an ISO 8601 date string." + }, + "start_time": { + "type": "string", + "description": "The time of day in 24-hour HH:MM format." + }, + "time_zone": { + "type": "string", + "description": "The IANA time zone name the time is interpreted in." + } + }, + "required": [ + "type", + "start_date", + "start_time", + "time_zone" + ], + "additionalProperties": false + } + ], + "description": "Use the is_empty operator to match an unset date." + } + }, + "required": [ + "type", + "value" + ], + "additionalProperties": false + } + ], + "description": "The date to compare against." + }, + "use_end": { + "description": "Compare against the end of a date range rather than its start.", + "type": "boolean" + } + }, + "required": [ + "operator", + "value" + ], + "additionalProperties": false + }, + { + "type": "object", + "properties": { + "operator": { + "type": "string", + "enum": [ + "date_is_within", + "date_is_relative_to" + ], + "description": "How to compare the date against the range." + }, + "value": { + "anyOf": [ + { + "type": "object", + "properties": { + "type": { + "type": "string", + "enum": [ + "relative" + ], + "description": "Always `relative`" + }, + "value": { + "type": "string", + "enum": [ + "custom" + ], + "description": "Always `custom`" + }, + "direction": { + "type": "string", + "enum": [ + "past", + "future" + ], + "description": "Whether the window runs backwards or forwards from now." + }, + "unit": { + "type": "string", + "enum": [ + "year", + "month", + "week", + "day" + ], + "description": "One of: `year`, `month`, `week`, `day`" + }, + "count": { + "type": "integer", + "minimum": 1, + "maximum": 9007199254740991, + "description": "How many units wide the window is." + } + }, + "required": [ + "type", + "value", + "direction", + "unit", + "count" + ], + "additionalProperties": false + }, + { + "type": "object", + "properties": { + "type": { + "type": "string", + "enum": [ + "relative" + ], + "description": "Always `relative`" + }, + "value": { + "type": "string", + "enum": [ + "surrounding" + ], + "description": "Always `surrounding`" + }, + "unit": { + "type": "string", + "enum": [ + "year", + "month", + "week", + "day" + ], + "description": "One of: `year`, `month`, `week`, `day`" + } + }, + "required": [ + "type", + "value", + "unit" + ], + "additionalProperties": false + }, + { + "type": "object", + "properties": { + "type": { + "type": "string", + "enum": [ + "relative" + ], + "description": "Always `relative`" + }, + "value": { + "type": "string", + "enum": [ + "this_week", + "the_past_week", + "the_past_month", + "the_past_year", + "the_next_week", + "the_next_month", + "the_next_year" + ], + "description": "One of: `this_week`, `the_past_week`, `the_past_month`, `the_past_year`, `the_next_week`, `the_next_month`, `the_next_year`" + } + }, + "required": [ + "type", + "value" + ], + "additionalProperties": false + }, + { + "type": "object", + "properties": { + "type": { + "type": "string", + "enum": [ + "exact" + ], + "description": "Always `exact`" + }, + "value": { + "type": "object", + "properties": { + "type": { + "type": "string", + "enum": [ + "daterange" + ], + "description": "Always `daterange`" + }, + "start_date": { + "description": "Inclusive start of the range as an ISO 8601 date string, if any.", + "type": "string", + "format": "date", + "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$" + }, + "end_date": { + "description": "Inclusive end of the range as an ISO 8601 date string, if any.", + "type": "string", + "format": "date", + "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$" + } + }, + "required": [ + "type" + ], + "additionalProperties": false, + "description": "Use the is_empty operator to match an unset date." + } + }, + "required": [ + "type", + "value" + ], + "additionalProperties": false + } + ], + "description": "The range to compare against." + }, + "use_end": { + "description": "Compare against the end of a date range rather than its start.", + "type": "boolean" + } + }, + "required": [ + "operator", + "value" + ], + "additionalProperties": false + }, + { + "type": "object", + "properties": { + "operator": { + "type": "string", + "enum": [ + "is_empty", + "is_not_empty" + ], + "description": "Whether the property must be empty or set." + } + }, + "required": [ + "operator" + ], + "additionalProperties": false + } + ], + "description": "The comparison to apply. Use the arm matching the property's type." + } + }, + "required": [ + "property", + "filter" + ], + "additionalProperties": false + }, + { + "type": "object", + "properties": { + "operator": { + "type": "string", + "enum": [ + "and", + "or" + ], + "description": "Whether every child must match, or any of them." + }, + "filters": { + "maxItems": 100, + "type": "array", + "items": { + "type": "object", + "properties": { + "property": { + "type": "string", + "enum": [ + "title", + "attendees", + "created_time", + "created_by", + "last_edited_time", + "last_edited_by", + "notion://meeting_notes/attendees" + ], + "description": "Which meeting-note property to filter on. Prefer the short names; the schema URI form is accepted for compatibility." + }, + "filter": { + "anyOf": [ + { + "type": "object", + "properties": { + "operator": { + "type": "string", + "enum": [ + "string_is", + "string_is_not", + "string_contains", + "string_does_not_contain", + "string_starts_with", + "string_ends_with" + ], + "description": "How to compare the text." + }, + "value": { + "type": "object", + "properties": { + "type": { + "type": "string", + "enum": [ + "exact" + ], + "description": "Always `exact`" + }, + "value": { + "type": "string", + "description": "The literal text the operator compares against." + } + }, + "required": [ + "type", + "value" + ], + "additionalProperties": false, + "description": "The text to compare against." + } + }, + "required": [ + "operator", + "value" + ], + "additionalProperties": false + }, + { + "type": "object", + "properties": { + "operator": { + "type": "string", + "enum": [ + "person_contains", + "person_does_not_contain" + ], + "description": "Whether the property must contain the people listed." + }, + "value": { + "maxItems": 100, + "type": "array", + "items": { + "anyOf": [ + { + "type": "object", + "properties": { + "type": { + "type": "string", + "enum": [ + "exact" + ], + "description": "Always `exact`" + }, + "value": { + "type": "object", + "properties": { + "table": { + "type": "string", + "enum": [ + "notion_user" + ], + "description": "Always `notion_user`" + }, + "id": { + "type": "string", + "description": "The user's ID, as a UUID or the `user://` form returned by user search." + } + }, + "required": [ + "table", + "id" + ], + "additionalProperties": false, + "description": "Pointer to the Notion user to match." + } + }, + "required": [ + "type", + "value" + ], + "additionalProperties": false + }, + { + "type": "object", + "properties": { + "type": { + "type": "string", + "enum": [ + "relative" + ], + "description": "Always `relative`" + }, + "value": { + "type": "string", + "enum": [ + "me" + ], + "description": "Always `me`" + } + }, + "required": [ + "type", + "value" + ], + "additionalProperties": false + } + ] + }, + "description": "The people to compare against." + } + }, + "required": [ + "operator", + "value" + ], + "additionalProperties": false + }, + { + "type": "object", + "properties": { + "operator": { + "type": "string", + "enum": [ + "date_is", + "date_is_before", + "date_is_after", + "date_is_on_or_before", + "date_is_on_or_after" + ], + "description": "How to compare the date." + }, + "value": { + "anyOf": [ + { + "type": "object", + "properties": { + "type": { + "type": "string", + "enum": [ + "relative" + ], + "description": "Always `relative`" + }, + "value": { + "type": "string", + "enum": [ + "today", + "tomorrow", + "yesterday", + "one_week_ago", + "one_week_from_now", + "one_month_ago", + "one_month_from_now" + ], + "description": "One of: `today`, `tomorrow`, `yesterday`, `one_week_ago`, `one_week_from_now`, `one_month_ago`, `one_month_from_now`" + } + }, + "required": [ + "type", + "value" + ], + "additionalProperties": false + }, + { + "type": "object", + "properties": { + "type": { + "type": "string", + "enum": [ + "exact" + ], + "description": "Always `exact`" + }, + "value": { + "anyOf": [ + { + "type": "object", + "properties": { + "type": { + "type": "string", + "enum": [ + "date" + ], + "description": "Always `date`" + }, + "start_date": { + "type": "string", + "format": "date", + "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$", + "description": "The calendar date as an ISO 8601 date string." + } + }, + "required": [ + "type", + "start_date" + ], + "additionalProperties": false + }, + { + "type": "object", + "properties": { + "type": { + "type": "string", + "enum": [ + "datetime" + ], + "description": "Always `datetime`" + }, + "start_date": { + "type": "string", + "format": "date", + "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$", + "description": "The calendar date as an ISO 8601 date string." + }, + "start_time": { + "type": "string", + "description": "The time of day in 24-hour HH:MM format." + }, + "time_zone": { + "type": "string", + "description": "The IANA time zone name the time is interpreted in." + } + }, + "required": [ + "type", + "start_date", + "start_time", + "time_zone" + ], + "additionalProperties": false + } + ], + "description": "Use the is_empty operator to match an unset date." + } + }, + "required": [ + "type", + "value" + ], + "additionalProperties": false + } + ], + "description": "The date to compare against." + }, + "use_end": { + "description": "Compare against the end of a date range rather than its start.", + "type": "boolean" + } + }, + "required": [ + "operator", + "value" + ], + "additionalProperties": false + }, + { + "type": "object", + "properties": { + "operator": { + "type": "string", + "enum": [ + "date_is_within", + "date_is_relative_to" + ], + "description": "How to compare the date against the range." + }, + "value": { + "anyOf": [ + { + "type": "object", + "properties": { + "type": { + "type": "string", + "enum": [ + "relative" + ], + "description": "Always `relative`" + }, + "value": { + "type": "string", + "enum": [ + "custom" + ], + "description": "Always `custom`" + }, + "direction": { + "type": "string", + "enum": [ + "past", + "future" + ], + "description": "Whether the window runs backwards or forwards from now." + }, + "unit": { + "type": "string", + "enum": [ + "year", + "month", + "week", + "day" + ], + "description": "One of: `year`, `month`, `week`, `day`" + }, + "count": { + "type": "integer", + "minimum": 1, + "maximum": 9007199254740991, + "description": "How many units wide the window is." + } + }, + "required": [ + "type", + "value", + "direction", + "unit", + "count" + ], + "additionalProperties": false + }, + { + "type": "object", + "properties": { + "type": { + "type": "string", + "enum": [ + "relative" + ], + "description": "Always `relative`" + }, + "value": { + "type": "string", + "enum": [ + "surrounding" + ], + "description": "Always `surrounding`" + }, + "unit": { + "type": "string", + "enum": [ + "year", + "month", + "week", + "day" + ], + "description": "One of: `year`, `month`, `week`, `day`" + } + }, + "required": [ + "type", + "value", + "unit" + ], + "additionalProperties": false + }, + { + "type": "object", + "properties": { + "type": { + "type": "string", + "enum": [ + "relative" + ], + "description": "Always `relative`" + }, + "value": { + "type": "string", + "enum": [ + "this_week", + "the_past_week", + "the_past_month", + "the_past_year", + "the_next_week", + "the_next_month", + "the_next_year" + ], + "description": "One of: `this_week`, `the_past_week`, `the_past_month`, `the_past_year`, `the_next_week`, `the_next_month`, `the_next_year`" + } + }, + "required": [ + "type", + "value" + ], + "additionalProperties": false + }, + { + "type": "object", + "properties": { + "type": { + "type": "string", + "enum": [ + "exact" + ], + "description": "Always `exact`" + }, + "value": { + "type": "object", + "properties": { + "type": { + "type": "string", + "enum": [ + "daterange" + ], + "description": "Always `daterange`" + }, + "start_date": { + "description": "Inclusive start of the range as an ISO 8601 date string, if any.", + "type": "string", + "format": "date", + "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$" + }, + "end_date": { + "description": "Inclusive end of the range as an ISO 8601 date string, if any.", + "type": "string", + "format": "date", + "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$" + } + }, + "required": [ + "type" + ], + "additionalProperties": false, + "description": "Use the is_empty operator to match an unset date." + } + }, + "required": [ + "type", + "value" + ], + "additionalProperties": false + } + ], + "description": "The range to compare against." + }, + "use_end": { + "description": "Compare against the end of a date range rather than its start.", + "type": "boolean" + } + }, + "required": [ + "operator", + "value" + ], + "additionalProperties": false + }, + { + "type": "object", + "properties": { + "operator": { + "type": "string", + "enum": [ + "is_empty", + "is_not_empty" + ], + "description": "Whether the property must be empty or set." + } + }, + "required": [ + "operator" + ], + "additionalProperties": false + } + ], + "description": "The comparison to apply. Use the arm matching the property's type." + } + }, + "required": [ + "property", + "filter" + ], + "additionalProperties": false + }, + "description": "The conditions in this group. A group with no conditions matches nothing, so send at least one." + } + }, + "required": [ + "operator", + "filters" + ], + "additionalProperties": false + } + ] + } + } + }, + "required": [ + "operator" + ], + "additionalProperties": {} + } + }, + "$schema": "https://json-schema.org/draft/2020-12/schema", + "additionalProperties": {} + }, + "outputSchema": null, + "description": "Query the current user's meeting notes data source.\n\nUse search first to resolve people IDs for attendee filters. By default, results already include meetings where the current user is an attendee or creator; do not add a current-user filte" + }, + { + "name": "notion-list-private-pages", + "title": "List private pages", + "annotations": { + "readOnlyHint": true, + "destructiveHint": false, + "idempotentHint": true, + "openWorldHint": false + }, + "inputSchema": { + "type": "object", + "properties": { + "limit": { + "description": "Maximum results to return (1-200).", + "type": "number" + }, + "cursor": { + "description": "Opaque pagination cursor from the previous response.", + "type": "string" + } + }, + "$schema": "https://json-schema.org/draft/2020-12/schema", + "additionalProperties": false + }, + "outputSchema": null, + "description": "List the current user's top-level pages and databases in their Private sidebar section. Use this to browse private workspace structure. For content searches, including keywords and titles, use ai_search when get_tool_access reports it is av" + }, + { + "name": "notion-list-shared-pages", + "title": "List shared pages", + "annotations": { + "readOnlyHint": true, + "destructiveHint": false, + "idempotentHint": true, + "openWorldHint": false + }, + "inputSchema": { + "type": "object", + "properties": { + "limit": { + "description": "Maximum results to return (1-200).", + "type": "number" + }, + "cursor": { + "description": "Opaque pagination cursor from the previous response.", + "type": "string" + } + }, + "$schema": "https://json-schema.org/draft/2020-12/schema", + "additionalProperties": false + }, + "outputSchema": null, + "description": "List pages and databases in the current user's Shared sidebar section. Use this to browse content shared directly with the user. For content searches, including keywords and titles, use ai_search when get_tool_access reports it is available" + }, + { + "name": "notion-list-favorite-pages", + "title": "List favorite pages", + "annotations": { + "readOnlyHint": true, + "destructiveHint": false, + "idempotentHint": true, + "openWorldHint": false + }, + "inputSchema": { + "type": "object", + "properties": { + "limit": { + "description": "Maximum results to return (1-200).", + "type": "number" + }, + "cursor": { + "description": "Opaque pagination cursor from the previous response.", + "type": "string" + } + }, + "$schema": "https://json-schema.org/draft/2020-12/schema", + "additionalProperties": false + }, + "outputSchema": null, + "description": "List the current user's favorite pages and databases in sidebar order. Use this when the user refers to a favorite or pinned workspace item. Follow cursor pagination when the complete list is needed." + }, + { + "name": "notion-list-recent-pages", + "title": "List recent pages", + "annotations": { + "readOnlyHint": true, + "destructiveHint": false, + "idempotentHint": true, + "openWorldHint": false + }, + "inputSchema": { + "type": "object", + "properties": { + "limit": { + "description": "Maximum results to return (1-200).", + "type": "number" + }, + "cursor": { + "description": "Opaque pagination cursor from the previous response.", + "type": "string" + } + }, + "$schema": "https://json-schema.org/draft/2020-12/schema", + "additionalProperties": false + }, + "outputSchema": null, + "description": "List pages and databases the current user recently viewed, ranked by recency and visit frequency. Use this to recover likely navigation context when the user refers to something they were recently working on. Follow cursor pagination when t" + }, + { + "name": "notion-search-agents", + "title": "Search workspace agents", + "annotations": { + "readOnlyHint": true, + "destructiveHint": false, + "idempotentHint": true, + "openWorldHint": false + }, + "inputSchema": { + "type": "object", + "properties": { + "scope": { + "type": "string", + "enum": [ + "favorites", + "workspace" + ], + "description": "Which agents to list: \"favorites\" for the current user's favorite agents, or \"workspace\" for agents shared with the workspace." + }, + "query": { + "description": "Search text matched against agent names and descriptions. Queries return one page and cannot use a cursor. When omitted, favorites are returned in sidebar order and workspace agents are returned newest first.", + "type": "string" + }, + "limit": { + "description": "Maximum results to return (1-200).", + "type": "number" + }, + "cursor": { + "description": "Opaque pagination cursor from the previous response.", + "type": "string" + } + }, + "required": [ + "scope" + ], + "$schema": "https://json-schema.org/draft/2020-12/schema", + "additionalProperties": false + }, + "outputSchema": null, + "description": "Search agents by name or description, or browse the current user's favorite agents and the workspace's newest agents. Queries return one page. Without a query, follow nextCursor until it is omitted, even when a bounded workspace page is emp" + }, + { + "name": "notion-search-sessions", + "title": "Search accessible agent sessions", + "annotations": { + "readOnlyHint": true, + "destructiveHint": false, + "idempotentHint": true, + "openWorldHint": false + }, + "inputSchema": { + "type": "object", + "properties": { + "question": { + "type": "string", + "description": "What you want to find in past sessions." + }, + "lookback": { + "description": "How far back to search, such as \"30d\" or \"1y\". Leave it out to search the past year.", + "type": "string" + } + }, + "required": [ + "question" + ], + "$schema": "https://json-schema.org/draft/2020-12/schema", + "additionalProperties": {} + }, + "outputSchema": null, + "description": "Search past agent sessions by topic in a periodically refreshed index and return matching session URLs and excerpts. Recently created or updated sessions may not appear; use query_sessions for recent sessions.\n\nIf availability is not alread" + }, + { + "name": "notion-query-sessions", + "title": "Query accessible agent sessions", + "annotations": { + "readOnlyHint": true, + "destructiveHint": false, + "idempotentHint": true, + "openWorldHint": false + }, + "inputSchema": { + "type": "object", + "properties": { + "query": { + "description": "A case-insensitive substring search over session titles.", + "type": "string", + "maxLength": 2000 + }, + "filter": { + "description": "A session property filter, or an and/or compound filter nested up to two levels deep.", + "anyOf": [ + { + "type": "object", + "properties": { + "property": { + "type": "string", + "enum": [ + "id" + ], + "description": "Filter sessions by id." + }, + "string": { + "type": "object", + "properties": { + "equals": { + "type": "string", + "description": "Return sessions with this exact value." + } + }, + "required": [ + "equals" + ], + "additionalProperties": false, + "description": "An exact string comparison." + } + }, + "required": [ + "property", + "string" + ], + "additionalProperties": false + }, + { + "type": "object", + "properties": { + "property": { + "type": "string", + "enum": [ + "agent_id" + ], + "description": "Filter sessions by agent_id." + }, + "string": { + "type": "object", + "properties": { + "equals": { + "type": "string", + "description": "Return sessions with this exact value." + } + }, + "required": [ + "equals" + ], + "additionalProperties": false, + "description": "An exact string comparison." + } + }, + "required": [ + "property", + "string" + ], + "additionalProperties": false + }, + { + "type": "object", + "properties": { + "property": { + "type": "string", + "enum": [ + "status" + ], + "description": "Filter sessions by status." + }, + "status": { + "type": "object", + "properties": { + "equals": { + "description": "Return sessions with this status.", + "type": "string", + "enum": [ + "queued", + "in_progress", + "requires_action", + "completed", + "failed", + "canceled", + "terminated" + ] + }, + "in": { + "description": "Return sessions with any of these statuses.", + "maxItems": 7, + "type": "array", + "items": { + "type": "string", + "enum": [ + "queued", + "in_progress", + "requires_action", + "completed", + "failed", + "canceled", + "terminated" + ] + } + } + }, + "additionalProperties": false, + "description": "A session status comparison." + } + }, + "required": [ + "property", + "status" + ], + "additionalProperties": false + }, + { + "type": "object", + "properties": { + "property": { + "type": "string", + "enum": [ + "created_at", + "updated_at" + ], + "description": "The session timestamp to compare." + }, + "timestamp": { + "type": "object", + "properties": { + "before": { + "description": "Return sessions before this time.", + "type": "string" + }, + "after": { + "description": "Return sessions after this time.", + "type": "string" + }, + "on_or_before": { + "description": "Return sessions at or before this time.", + "type": "string" + }, + "on_or_after": { + "description": "Return sessions at or after this time.", + "type": "string" + } + }, + "additionalProperties": false, + "description": "A timestamp range." + } + }, + "required": [ + "property", + "timestamp" + ], + "additionalProperties": false + }, + { + "type": "object", + "properties": { + "and": { + "maxItems": 100, + "type": "array", + "items": { + "anyOf": [ + { + "type": "object", + "properties": { + "property": { + "type": "string", + "enum": [ + "id" + ], + "description": "Filter sessions by id." + }, + "string": { + "type": "object", + "properties": { + "equals": { + "type": "string", + "description": "Return sessions with this exact value." + } + }, + "required": [ + "equals" + ], + "additionalProperties": false, + "description": "An exact string comparison." + } + }, + "required": [ + "property", + "string" + ], + "additionalProperties": false + }, + { + "type": "object", + "properties": { + "property": { + "type": "string", + "enum": [ + "agent_id" + ], + "description": "Filter sessions by agent_id." + }, + "string": { + "type": "object", + "properties": { + "equals": { + "type": "string", + "description": "Return sessions with this exact value." + } + }, + "required": [ + "equals" + ], + "additionalProperties": false, + "description": "An exact string comparison." + } + }, + "required": [ + "property", + "string" + ], + "additionalProperties": false + }, + { + "type": "object", + "properties": { + "property": { + "type": "string", + "enum": [ + "status" + ], + "description": "Filter sessions by status." + }, + "status": { + "type": "object", + "properties": { + "equals": { + "description": "Return sessions with this status.", + "type": "string", + "enum": [ + "queued", + "in_progress", + "requires_action", + "completed", + "failed", + "canceled", + "terminated" + ] + }, + "in": { + "description": "Return sessions with any of these statuses.", + "maxItems": 7, + "type": "array", + "items": { + "type": "string", + "enum": [ + "queued", + "in_progress", + "requires_action", + "completed", + "failed", + "canceled", + "terminated" + ] + } + } + }, + "additionalProperties": false, + "description": "A session status comparison." + } + }, + "required": [ + "property", + "status" + ], + "additionalProperties": false + }, + { + "type": "object", + "properties": { + "property": { + "type": "string", + "enum": [ + "created_at", + "updated_at" + ], + "description": "The session timestamp to compare." + }, + "timestamp": { + "type": "object", + "properties": { + "before": { + "description": "Return sessions before this time.", + "type": "string" + }, + "after": { + "description": "Return sessions after this time.", + "type": "string" + }, + "on_or_before": { + "description": "Return sessions at or before this time.", + "type": "string" + }, + "on_or_after": { + "description": "Return sessions at or after this time.", + "type": "string" + } + }, + "additionalProperties": false, + "description": "A timestamp range." + } + }, + "required": [ + "property", + "timestamp" + ], + "additionalProperties": false + }, + { + "type": "object", + "properties": { + "and": { + "maxItems": 100, + "type": "array", + "items": { + "anyOf": [ + { + "type": "object", + "properties": { + "property": { + "type": "string", + "enum": [ + "id" + ], + "description": "Filter sessions by id." + }, + "string": { + "type": "object", + "properties": { + "equals": { + "type": "string", + "description": "Return sessions with this exact value." + } + }, + "required": [ + "equals" + ], + "additionalProperties": false, + "description": "An exact string comparison." + } + }, + "required": [ + "property", + "string" + ], + "additionalProperties": false + }, + { + "type": "object", + "properties": { + "property": { + "type": "string", + "enum": [ + "agent_id" + ], + "description": "Filter sessions by agent_id." + }, + "string": { + "type": "object", + "properties": { + "equals": { + "type": "string", + "description": "Return sessions with this exact value." + } + }, + "required": [ + "equals" + ], + "additionalProperties": false, + "description": "An exact string comparison." + } + }, + "required": [ + "property", + "string" + ], + "additionalProperties": false + }, + { + "type": "object", + "properties": { + "property": { + "type": "string", + "enum": [ + "status" + ], + "description": "Filter sessions by status." + }, + "status": { + "type": "object", + "properties": { + "equals": { + "description": "Return sessions with this status.", + "type": "string", + "enum": [ + "queued", + "in_progress", + "requires_action", + "completed", + "failed", + "canceled", + "terminated" + ] + }, + "in": { + "description": "Return sessions with any of these statuses.", + "maxItems": 7, + "type": "array", + "items": { + "type": "string", + "enum": [ + "queued", + "in_progress", + "requires_action", + "completed", + "failed", + "canceled", + "terminated" + ] + } + } + }, + "additionalProperties": false, + "description": "A session status comparison." + } + }, + "required": [ + "property", + "status" + ], + "additionalProperties": false + }, + { + "type": "object", + "properties": { + "property": { + "type": "string", + "enum": [ + "created_at", + "updated_at" + ], + "description": "The session timestamp to compare." + }, + "timestamp": { + "type": "object", + "properties": { + "before": { + "description": "Return sessions before this time.", + "type": "string" + }, + "after": { + "description": "Return sessions after this time.", + "type": "string" + }, + "on_or_before": { + "description": "Return sessions at or before this time.", + "type": "string" + }, + "on_or_after": { + "description": "Return sessions at or after this time.", + "type": "string" + } + }, + "additionalProperties": false, + "description": "A timestamp range." + } + }, + "required": [ + "property", + "timestamp" + ], + "additionalProperties": false + } + ] + }, + "description": "Return sessions that match every child filter." + } + }, + "required": [ + "and" + ], + "additionalProperties": false + }, + { + "type": "object", + "properties": { + "or": { + "maxItems": 100, + "type": "array", + "items": { + "anyOf": [ + { + "type": "object", + "properties": { + "property": { + "type": "string", + "enum": [ + "id" + ], + "description": "Filter sessions by id." + }, + "string": { + "type": "object", + "properties": { + "equals": { + "type": "string", + "description": "Return sessions with this exact value." + } + }, + "required": [ + "equals" + ], + "additionalProperties": false, + "description": "An exact string comparison." + } + }, + "required": [ + "property", + "string" + ], + "additionalProperties": false + }, + { + "type": "object", + "properties": { + "property": { + "type": "string", + "enum": [ + "agent_id" + ], + "description": "Filter sessions by agent_id." + }, + "string": { + "type": "object", + "properties": { + "equals": { + "type": "string", + "description": "Return sessions with this exact value." + } + }, + "required": [ + "equals" + ], + "additionalProperties": false, + "description": "An exact string comparison." + } + }, + "required": [ + "property", + "string" + ], + "additionalProperties": false + }, + { + "type": "object", + "properties": { + "property": { + "type": "string", + "enum": [ + "status" + ], + "description": "Filter sessions by status." + }, + "status": { + "type": "object", + "properties": { + "equals": { + "description": "Return sessions with this status.", + "type": "string", + "enum": [ + "queued", + "in_progress", + "requires_action", + "completed", + "failed", + "canceled", + "terminated" + ] + }, + "in": { + "description": "Return sessions with any of these statuses.", + "maxItems": 7, + "type": "array", + "items": { + "type": "string", + "enum": [ + "queued", + "in_progress", + "requires_action", + "completed", + "failed", + "canceled", + "terminated" + ] + } + } + }, + "additionalProperties": false, + "description": "A session status comparison." + } + }, + "required": [ + "property", + "status" + ], + "additionalProperties": false + }, + { + "type": "object", + "properties": { + "property": { + "type": "string", + "enum": [ + "created_at", + "updated_at" + ], + "description": "The session timestamp to compare." + }, + "timestamp": { + "type": "object", + "properties": { + "before": { + "description": "Return sessions before this time.", + "type": "string" + }, + "after": { + "description": "Return sessions after this time.", + "type": "string" + }, + "on_or_before": { + "description": "Return sessions at or before this time.", + "type": "string" + }, + "on_or_after": { + "description": "Return sessions at or after this time.", + "type": "string" + } + }, + "additionalProperties": false, + "description": "A timestamp range." + } + }, + "required": [ + "property", + "timestamp" + ], + "additionalProperties": false + } + ] + }, + "description": "Return sessions that match any child filter." + } + }, + "required": [ + "or" + ], + "additionalProperties": false + } + ] + }, + "description": "Return sessions that match every child filter." + } + }, + "required": [ + "and" + ], + "additionalProperties": false + }, + { + "type": "object", + "properties": { + "or": { + "maxItems": 100, + "type": "array", + "items": { + "anyOf": [ + { + "type": "object", + "properties": { + "property": { + "type": "string", + "enum": [ + "id" + ], + "description": "Filter sessions by id." + }, + "string": { + "type": "object", + "properties": { + "equals": { + "type": "string", + "description": "Return sessions with this exact value." + } + }, + "required": [ + "equals" + ], + "additionalProperties": false, + "description": "An exact string comparison." + } + }, + "required": [ + "property", + "string" + ], + "additionalProperties": false + }, + { + "type": "object", + "properties": { + "property": { + "type": "string", + "enum": [ + "agent_id" + ], + "description": "Filter sessions by agent_id." + }, + "string": { + "type": "object", + "properties": { + "equals": { + "type": "string", + "description": "Return sessions with this exact value." + } + }, + "required": [ + "equals" + ], + "additionalProperties": false, + "description": "An exact string comparison." + } + }, + "required": [ + "property", + "string" + ], + "additionalProperties": false + }, + { + "type": "object", + "properties": { + "property": { + "type": "string", + "enum": [ + "status" + ], + "description": "Filter sessions by status." + }, + "status": { + "type": "object", + "properties": { + "equals": { + "description": "Return sessions with this status.", + "type": "string", + "enum": [ + "queued", + "in_progress", + "requires_action", + "completed", + "failed", + "canceled", + "terminated" + ] + }, + "in": { + "description": "Return sessions with any of these statuses.", + "maxItems": 7, + "type": "array", + "items": { + "type": "string", + "enum": [ + "queued", + "in_progress", + "requires_action", + "completed", + "failed", + "canceled", + "terminated" + ] + } + } + }, + "additionalProperties": false, + "description": "A session status comparison." + } + }, + "required": [ + "property", + "status" + ], + "additionalProperties": false + }, + { + "type": "object", + "properties": { + "property": { + "type": "string", + "enum": [ + "created_at", + "updated_at" + ], + "description": "The session timestamp to compare." + }, + "timestamp": { + "type": "object", + "properties": { + "before": { + "description": "Return sessions before this time.", + "type": "string" + }, + "after": { + "description": "Return sessions after this time.", + "type": "string" + }, + "on_or_before": { + "description": "Return sessions at or before this time.", + "type": "string" + }, + "on_or_after": { + "description": "Return sessions at or after this time.", + "type": "string" + } + }, + "additionalProperties": false, + "description": "A timestamp range." + } + }, + "required": [ + "property", + "timestamp" + ], + "additionalProperties": false + }, + { + "type": "object", + "properties": { + "and": { + "maxItems": 100, + "type": "array", + "items": { + "anyOf": [ + { + "type": "object", + "properties": { + "property": { + "type": "string", + "enum": [ + "id" + ], + "description": "Filter sessions by id." + }, + "string": { + "type": "object", + "properties": { + "equals": { + "type": "string", + "description": "Return sessions with this exact value." + } + }, + "required": [ + "equals" + ], + "additionalProperties": false, + "description": "An exact string comparison." + } + }, + "required": [ + "property", + "string" + ], + "additionalProperties": false + }, + { + "type": "object", + "properties": { + "property": { + "type": "string", + "enum": [ + "agent_id" + ], + "description": "Filter sessions by agent_id." + }, + "string": { + "type": "object", + "properties": { + "equals": { + "type": "string", + "description": "Return sessions with this exact value." + } + }, + "required": [ + "equals" + ], + "additionalProperties": false, + "description": "An exact string comparison." + } + }, + "required": [ + "property", + "string" + ], + "additionalProperties": false + }, + { + "type": "object", + "properties": { + "property": { + "type": "string", + "enum": [ + "status" + ], + "description": "Filter sessions by status." + }, + "status": { + "type": "object", + "properties": { + "equals": { + "description": "Return sessions with this status.", + "type": "string", + "enum": [ + "queued", + "in_progress", + "requires_action", + "completed", + "failed", + "canceled", + "terminated" + ] + }, + "in": { + "description": "Return sessions with any of these statuses.", + "maxItems": 7, + "type": "array", + "items": { + "type": "string", + "enum": [ + "queued", + "in_progress", + "requires_action", + "completed", + "failed", + "canceled", + "terminated" + ] + } + } + }, + "additionalProperties": false, + "description": "A session status comparison." + } + }, + "required": [ + "property", + "status" + ], + "additionalProperties": false + }, + { + "type": "object", + "properties": { + "property": { + "type": "string", + "enum": [ + "created_at", + "updated_at" + ], + "description": "The session timestamp to compare." + }, + "timestamp": { + "type": "object", + "properties": { + "before": { + "description": "Return sessions before this time.", + "type": "string" + }, + "after": { + "description": "Return sessions after this time.", + "type": "string" + }, + "on_or_before": { + "description": "Return sessions at or before this time.", + "type": "string" + }, + "on_or_after": { + "description": "Return sessions at or after this time.", + "type": "string" + } + }, + "additionalProperties": false, + "description": "A timestamp range." + } + }, + "required": [ + "property", + "timestamp" + ], + "additionalProperties": false + } + ] + }, + "description": "Return sessions that match every child filter." + } + }, + "required": [ + "and" + ], + "additionalProperties": false + }, + { + "type": "object", + "properties": { + "or": { + "maxItems": 100, + "type": "array", + "items": { + "anyOf": [ + { + "type": "object", + "properties": { + "property": { + "type": "string", + "enum": [ + "id" + ], + "description": "Filter sessions by id." + }, + "string": { + "type": "object", + "properties": { + "equals": { + "type": "string", + "description": "Return sessions with this exact value." + } + }, + "required": [ + "equals" + ], + "additionalProperties": false, + "description": "An exact string comparison." + } + }, + "required": [ + "property", + "string" + ], + "additionalProperties": false + }, + { + "type": "object", + "properties": { + "property": { + "type": "string", + "enum": [ + "agent_id" + ], + "description": "Filter sessions by agent_id." + }, + "string": { + "type": "object", + "properties": { + "equals": { + "type": "string", + "description": "Return sessions with this exact value." + } + }, + "required": [ + "equals" + ], + "additionalProperties": false, + "description": "An exact string comparison." + } + }, + "required": [ + "property", + "string" + ], + "additionalProperties": false + }, + { + "type": "object", + "properties": { + "property": { + "type": "string", + "enum": [ + "status" + ], + "description": "Filter sessions by status." + }, + "status": { + "type": "object", + "properties": { + "equals": { + "description": "Return sessions with this status.", + "type": "string", + "enum": [ + "queued", + "in_progress", + "requires_action", + "completed", + "failed", + "canceled", + "terminated" + ] + }, + "in": { + "description": "Return sessions with any of these statuses.", + "maxItems": 7, + "type": "array", + "items": { + "type": "string", + "enum": [ + "queued", + "in_progress", + "requires_action", + "completed", + "failed", + "canceled", + "terminated" + ] + } + } + }, + "additionalProperties": false, + "description": "A session status comparison." + } + }, + "required": [ + "property", + "status" + ], + "additionalProperties": false + }, + { + "type": "object", + "properties": { + "property": { + "type": "string", + "enum": [ + "created_at", + "updated_at" + ], + "description": "The session timestamp to compare." + }, + "timestamp": { + "type": "object", + "properties": { + "before": { + "description": "Return sessions before this time.", + "type": "string" + }, + "after": { + "description": "Return sessions after this time.", + "type": "string" + }, + "on_or_before": { + "description": "Return sessions at or before this time.", + "type": "string" + }, + "on_or_after": { + "description": "Return sessions at or after this time.", + "type": "string" + } + }, + "additionalProperties": false, + "description": "A timestamp range." + } + }, + "required": [ + "property", + "timestamp" + ], + "additionalProperties": false + } + ] + }, + "description": "Return sessions that match any child filter." + } + }, + "required": [ + "or" + ], + "additionalProperties": false + } + ] + }, + "description": "Return sessions that match any child filter." + } + }, + "required": [ + "or" + ], + "additionalProperties": false + } + ] + }, + "sorts": { + "description": "Ordered sort precedence. Defaults to updated_at descending.", + "minItems": 1, + "maxItems": 2, + "type": "array", + "items": { + "type": "object", + "properties": { + "property": { + "type": "string", + "enum": [ + "created_at", + "updated_at" + ], + "description": "One of: `created_at`, `updated_at`" + }, + "direction": { + "type": "string", + "enum": [ + "ascending", + "descending" + ], + "description": "One of: `ascending`, `descending`" + } + }, + "required": [ + "property", + "direction" + ], + "additionalProperties": false + } + }, + "start_cursor": { + "description": "The continuation cursor returned by the previous page.", + "type": "string" + }, + "page_size": { + "description": "The number of sessions to return. Maximum: 100.", + "type": "integer", + "minimum": 1, + "maximum": 100 + } + }, + "$schema": "https://json-schema.org/draft/2020-12/schema", + "additionalProperties": false + }, + "outputSchema": null, + "description": "List agent sessions available to the integration. Filter, sort, or search by title. A bounded page can be empty while has_more is true; follow next_cursor until has_more is false.\n\nIf availability is not already known for this connection, c" + }, + { + "name": "notion-spawn-session", + "title": "Start a Custom Agent session", + "annotations": { + "readOnlyHint": false, + "destructiveHint": true, + "idempotentHint": false, + "openWorldHint": false + }, + "inputSchema": { + "type": "object", + "properties": { + "agent_url": { + "type": "string", + "minLength": 1, + "description": "Published Custom Agent URL in agent:/// format, as returned by search_agents." + }, + "initial_message": { + "type": "string", + "minLength": 1, + "description": "Initial message for the new session." + } + }, + "required": [ + "agent_url", + "initial_message" + ], + "$schema": "https://json-schema.org/draft/2020-12/schema", + "additionalProperties": {} + }, + "outputSchema": null, + "description": "Start a session with a published Custom Agent. Use get_session_status or wait_session to check its progress.\n\nIf availability is not already known for this connection, call get_tool_access with {} before using this tool. Reuse the returned " + }, + { + "name": "notion-get-session-status", + "title": "Get Custom Agent session status", + "annotations": { + "readOnlyHint": true, + "destructiveHint": false, + "idempotentHint": false, + "openWorldHint": false + }, + "inputSchema": { + "type": "object", + "properties": { + "session_url": { + "type": "string", + "minLength": 1, + "description": "Use the complete session_url returned by session tools, unchanged. Format: session:///. Shorthand session:// and thread:// use the connected workspace. Fully qualified URLs must refer to that workspace." + } + }, + "required": [ + "session_url" + ], + "$schema": "https://json-schema.org/draft/2020-12/schema", + "additionalProperties": {} + }, + "outputSchema": null, + "description": "Get the latest turn's status for a Custom Agent session without waiting.\n\nIf availability is not already known for this connection, call get_tool_access with {} before using this tool. Reuse the returned access map across tools; check the s" + }, + { + "name": "notion-wait-session", + "title": "Wait for a Custom Agent session", + "annotations": { + "readOnlyHint": true, + "destructiveHint": false, + "idempotentHint": false, + "openWorldHint": false + }, + "inputSchema": { + "type": "object", + "properties": { + "session_url": { + "type": "string", + "minLength": 1, + "description": "Use the complete session_url returned by session tools, unchanged. Format: session:///. Shorthand session:// and thread:// use the connected workspace. Fully qualified URLs must refer to that workspace." + }, + "seconds": { + "type": "integer", + "minimum": 1, + "maximum": 60, + "description": "Maximum number of seconds to wait." + } + }, + "required": [ + "session_url", + "seconds" + ], + "$schema": "https://json-schema.org/draft/2020-12/schema", + "additionalProperties": {} + }, + "outputSchema": null, + "description": "Wait for the latest turn in a Custom Agent session to stop running.\n\nIf availability is not already known for this connection, call get_tool_access with {} before using this tool. Reuse the returned access map across tools; check the status" + }, + { + "name": "notion-stop-session", + "title": "Stop a Custom Agent session", + "annotations": { + "readOnlyHint": false, + "destructiveHint": true, + "idempotentHint": false, + "openWorldHint": false + }, + "inputSchema": { + "type": "object", + "properties": { + "session_url": { + "type": "string", + "minLength": 1, + "description": "Use the complete session_url returned by session tools, unchanged. Format: session:///. Shorthand session:// and thread:// use the connected workspace. Fully qualified URLs must refer to that workspace." + } + }, + "required": [ + "session_url" + ], + "$schema": "https://json-schema.org/draft/2020-12/schema", + "additionalProperties": {} + }, + "outputSchema": null, + "description": "Stop a running Custom Agent session you can access.\n\nIf availability is not already known for this connection, call get_tool_access with {} before using this tool. Reuse the returned access map across tools; check the status and restricted_" + }, + { + "name": "notion-send-message-to-session", + "title": "Send a message to a Custom Agent session", + "annotations": { + "readOnlyHint": false, + "destructiveHint": true, + "idempotentHint": false, + "openWorldHint": false + }, + "inputSchema": { + "type": "object", + "properties": { + "session_url": { + "type": "string", + "minLength": 1, + "description": "Use the complete session_url returned by session tools, unchanged. Format: session:///. Shorthand session:// and thread:// use the connected workspace. Fully qualified URLs must refer to that workspace." + }, + "message": { + "type": "string", + "minLength": 1, + "description": "Follow-up message to send." + } + }, + "required": [ + "session_url", + "message" + ], + "$schema": "https://json-schema.org/draft/2020-12/schema", + "additionalProperties": {} + }, + "outputSchema": null, + "description": "Send a follow-up message to a Custom Agent session you can access.\n\nIf availability is not already known for this connection, call get_tool_access with {} before using this tool. Reuse the returned access map across tools; check the status " + }, + { + "name": "notion-list-session-events", + "title": "List Custom Agent session events", + "annotations": { + "readOnlyHint": true, + "destructiveHint": false, + "idempotentHint": false, + "openWorldHint": false + }, + "inputSchema": { + "type": "object", + "properties": { + "session_url": { + "type": "string", + "minLength": 1, + "description": "Use the complete session_url returned by session tools, unchanged. Format: session:///. Shorthand session:// and thread:// use the connected workspace. Fully qualified URLs must refer to that workspace." + }, + "count": { + "type": "integer", + "minimum": 1, + "maximum": 100, + "description": "Maximum number of committed events to return." + }, + "before_sequence": { + "description": "Load the previous page of events ending before this sequence number.", + "type": "integer", + "minimum": 1, + "maximum": 9007199254740991 + }, + "after_sequence": { + "description": "Load the next page of events starting after this sequence number.", + "type": "integer", + "minimum": 1, + "maximum": 9007199254740991 + } + }, + "required": [ + "session_url", + "count" + ], + "$schema": "https://json-schema.org/draft/2020-12/schema", + "additionalProperties": {} + }, + "outputSchema": null, + "description": "List short summaries of saved events in a Custom Agent session.\n\nIf availability is not already known for this connection, call get_tool_access with {} before using this tool. Reuse the returned access map across tools; check the status and" + }, + { + "name": "notion-read-session-event", + "title": "Read a Custom Agent session event", + "annotations": { + "readOnlyHint": true, + "destructiveHint": false, + "idempotentHint": false, + "openWorldHint": false + }, + "inputSchema": { + "type": "object", + "properties": { + "session_url": { + "type": "string", + "minLength": 1, + "description": "Use the complete session_url returned by session tools, unchanged. Format: session:///. Shorthand session:// and thread:// use the connected workspace. Fully qualified URLs must refer to that workspace." + }, + "sequence": { + "type": "integer", + "minimum": 1, + "maximum": 9007199254740991, + "description": "Committed event sequence number to read." + } + }, + "required": [ + "session_url", + "sequence" + ], + "$schema": "https://json-schema.org/draft/2020-12/schema", + "additionalProperties": {} + }, + "outputSchema": null, + "description": "Read the full visible content of one saved Custom Agent session event.\n\nIf availability is not already known for this connection, call get_tool_access with {} before using this tool. Reuse the returned access map across tools; check the sta" + }, + { + "name": "notion-create-view", + "title": "Create a database view", + "annotations": { + "readOnlyHint": false, + "destructiveHint": false, + "idempotentHint": false, + "openWorldHint": false + }, + "inputSchema": { + "type": "object", + "properties": { + "data_source_id": { + "type": "string", + "description": "The data source (collection) ID. Accepts a collection:// URI from tags or a bare UUID." + }, + "name": { + "type": "string", + "description": "The name of the view." + }, + "type": { + "type": "string", + "enum": [ + "table", + "board", + "list", + "calendar", + "timeline", + "gallery", + "form", + "chart", + "map", + "dashboard" + ], + "description": "The type of view to create." + }, + "database_id": { + "description": "The database to add a view tab to. Accepts a Notion URL or a bare UUID. Mutually exclusive with `parent_page_id`; exactly one must be provided.", + "type": "string" + }, + "parent_page_id": { + "description": "A page to create an inline linked database view on, like the UI /linked command. Accepts a Notion URL or a bare UUID. The new linked view block is appended at the end of the page and references `data_source_id`. Mutually exclusive with `database_id`; exactly one must be provided.", + "type": "string" + }, + "configure": { + "description": "View configuration DSL directives and examples:\n- FILTER \"Property\" = \"value\" \u2014 filter rows. Relation values must be a page URL or UUID; person values must be a user URI (user://), user UUID, or \"me\". Names are not supported for either.\n- QUICK FILTER \"Property\" \u2014 add a quick filter to the view's filter bar with no criteria; add a condition to preselect one (QUICK FILTER \"Status\" = \"Done\")\n- SORT BY \"Property\" ASC \u2014 sort rows\n- GROUP BY \"Property\" \u2014 group by property (required for board views)\n- CALENDAR BY \"Property\" \u2014 date property (required for calendar views)\n- TIMELINE BY \"Start\" TO \"End\" \u2014 date range (required for timeline views)\n- MAP BY \"Property\" \u2014 location property (required for map views)\n- CHART column|bar|line|donut|number \u2014 chart type with optional AGGREGATE, COLOR, HEIGHT, SORT, STACK BY, CAPTION\n- FORM CLOSE|OPEN \u2014 close/open form submissions\n- FORM ANONYMOUS true|false \u2014 toggle anonymous submissions\n- FORM PERMISSIONS none|reader|editor \u2014 set submission permissions\n- SHOW \"Prop1\", \"Prop2\" \u2014 set visible properties\n- COVER \"Property\" \u2014 cover image property\n\n\nSHOW \"Name\", \"Status\", \"Due Date\"\nGROUP BY \"Status\"\nFILTER \"Status\" = \"In Progress\"; SORT BY \"Due Date\" ASC\nCALENDAR BY \"Due Date\"\nTIMELINE BY \"Start\" TO \"End\"\nFILTER \"Company\" = \"Acme\"", + "type": "string" + } + }, + "required": [ + "data_source_id", + "name", + "type" + ], + "$schema": "https://json-schema.org/draft/2020-12/schema", + "additionalProperties": {} + }, + "outputSchema": null, + "description": "Create a new view on a Notion database.\n\nUse fetch first to get database_id, parent_page_id, and the collection:// data_source_id. The caller needs edit access to the database or parent page and access to the data source.\n\nProvide exactly o" + }, + { + "name": "notion-update-view", + "title": "Update a database view", + "annotations": { + "readOnlyHint": false, + "destructiveHint": false, + "idempotentHint": false, + "openWorldHint": false + }, + "inputSchema": { + "type": "object", + "properties": { + "view_id": { + "type": "string", + "description": "The view to update. Accepts a view:// URI, a Notion URL with ?v= parameter, or a bare UUID." + }, + "name": { + "description": "New name for the view.", + "type": "string" + }, + "configure": { + "description": "View configuration DSL string. Supports FILTER, QUICK FILTER, SORT BY, GROUP BY, CALENDAR BY, TIMELINE BY, MAP BY, CHART, FORM, SHOW, HIDE, COVER, WRAP CELLS, FREEZE COLUMNS, and CLEAR directives.", + "type": "string" + } + }, + "required": [ + "view_id" + ], + "$schema": "https://json-schema.org/draft/2020-12/schema", + "additionalProperties": {} + }, + "outputSchema": null, + "description": "Update a view's name, filters, sorts, or display configuration.\n\nUse \"fetch\" to get view IDs from database responses. Only include fields\nyou want to change. The \"configure\" param uses the same DSL as create_view.\nUse CLEAR to remove settin" + }, + { + "name": "notion-show-advanced-analysis-next-steps", + "title": "Show the full version of Notion MCP", + "annotations": { + "readOnlyHint": true, + "destructiveHint": false, + "idempotentHint": false, + "openWorldHint": false + }, + "inputSchema": { + "type": "object", + "properties": {}, + "$schema": "https://json-schema.org/draft/2020-12/schema", + "default": {}, + "additionalProperties": false + }, + "outputSchema": { + "type": "object", + "properties": { + "kind": { + "type": "string", + "enum": [ + "query_multiple_data_sources_full_version", + "query_multiple_data_sources_full_version_not_displayed" + ] + }, + "action": { + "type": "string", + "enum": [ + "start_trial", + "request_trial", + "learn_more" + ] + }, + "client_name": { + "type": "string", + "minLength": 1, + "maxLength": 64 + }, + "destination_url": { + "type": "string", + "format": "uri" + } + }, + "required": [ + "kind" + ], + "$schema": "https://json-schema.org/draft/2020-12/schema", + "additionalProperties": false + }, + "description": "Use this exactly once at the end of a turn when query_multiple_data_sources requires the full version of Notion MCP. Call with no arguments. Do not call this once per failed query, and do not call it again if it has already been called in t" + }, + { + "name": "notion-check-mcp-next-steps", + "title": "Check Notion MCP next steps", + "annotations": { + "readOnlyHint": true, + "destructiveHint": false, + "idempotentHint": false, + "openWorldHint": false + }, + "inputSchema": { + "type": "object", + "properties": {}, + "$schema": "https://json-schema.org/draft/2020-12/schema", + "default": {}, + "additionalProperties": false + }, + "outputSchema": { + "type": "object", + "properties": { + "kind": { + "type": "string", + "enum": [ + "mcp_business_education", + "mcp_business_education_not_displayed" + ] + }, + "action": { + "type": "string", + "enum": [ + "start_trial", + "request_trial", + "learn_more" + ] + }, + "client_name": { + "type": "string", + "minLength": 1, + "maxLength": 64 + }, + "destination_url": { + "type": "string", + "format": "uri" + } + }, + "required": [ + "kind" + ], + "$schema": "https://json-schema.org/draft/2020-12/schema", + "additionalProperties": false + }, + "description": "When to call: Only when a Notion fetch result instructs you to. Finish all Notion tool calls needed for the current request, then call at most once with no arguments. Never call it per fetch or failure, without that instruction, or retry it" + } + ] +} \ No newline at end of file diff --git a/backend/__tests__/unit/services/hostedMcpEntry.test.js b/backend/__tests__/unit/services/hostedMcpEntry.test.js index b6fcb64c46..9a694a610c 100644 --- a/backend/__tests__/unit/services/hostedMcpEntry.test.js +++ b/backend/__tests__/unit/services/hostedMcpEntry.test.js @@ -22,6 +22,7 @@ const LINEAR_FIRST_CAPTURE = require('../../fixtures/hostedMcp/linear-tools-list const LINEAR_CAPTURE = require('../../fixtures/hostedMcp/linear-tools-list-2026-10-14.json'); const ATLASSIAN_CAPTURE = require('../../fixtures/hostedMcp/atlassian-tools-list-2026-10-09.json'); const AIRTABLE_CAPTURE = require('../../fixtures/hostedMcp/airtable-tools-list-2026-10-09.json'); +const NOTION_CAPTURE = require('../../fixtures/hostedMcp/notion-tools-list-2026-10-01.json'); const ENTRY_TEXT = 'ENTRY TEXT the pin agreed to.'; const VENDOR_TEXT = 'VENDOR TEXT nobody reviewed.'; @@ -564,15 +565,15 @@ describe('the comparison is cached per row, and an outage is not cacheable', () }); describe('the shipped catalogue cannot land half-wired', () => { - test('ships Linear, Google Calendar, Atlassian, then Airtable, and lookup names the requested entry', () => { + test('ships the hosted-MCP catalogue and lookup names the requested entry', () => { // The catalogue is the one place that says what an instance offers before // any member has connected anything. Its ordering follows the build plan. - expect(HOSTED_MCP_ENTRIES.map((entry) => entry.id)).toEqual(['linear', 'google-calendar', 'atlassian', 'airtable']); + expect(HOSTED_MCP_ENTRIES.map((entry) => entry.id)).toEqual(['linear', 'google-calendar', 'atlassian', 'airtable', 'notion']); const catalogue = [linear(), linear({ id: 'notion', title: 'Notion' })]; expect(findHostedMcpEntry(catalogue, 'notion').title).toBe('Notion'); expect(findHostedMcpEntry(catalogue, 'linear').title).toBe('Linear'); expect(findHostedMcpEntry(catalogue, 'atlassian')).toBeUndefined(); - expect(findHostedMcpEntry(HOSTED_MCP_ENTRIES, 'notion')).toBeUndefined(); + expect(findHostedMcpEntry(HOSTED_MCP_ENTRIES, 'notion').title).toBe('Notion'); expect(findHostedMcpEntry(HOSTED_MCP_ENTRIES, 'linear').title).toBe('Linear'); expect(findHostedMcpEntry(HOSTED_MCP_ENTRIES, 'google-calendar').title).toBe('Google Calendar'); }); @@ -737,6 +738,39 @@ describe('the shipped catalogue cannot land half-wired', () => { expect(capture.tools).toHaveLength(46); }); + test('the Notion pin contains captured workspace tools and excludes Notion agent sessions', () => { + const entry = findHostedMcpEntry(HOSTED_MCP_ENTRIES, 'notion'); + const capture = NOTION_CAPTURE; + expect(entry.resource).toBe(capture.server); + expect(entry.client).toBe('cimd'); + expect(entry.scopes).toEqual([capture.tokenShape.scope]); + expect(entry.tools).toHaveLength(26); + const measured = new Map(capture.tools.map((tool) => [tool.name, tool])); + for (const tool of entry.tools) { + const source = measured.get(tool.upstreamName); + expect(source).toBeDefined(); + expect(tool.name).toBe(tool.upstreamName.replace(/-/g, '_')); + expect(canonicalJson(tool.inputSchema)).toBe(canonicalJson(source.inputSchema)); + expect(tool.annotations).toMatchObject({ + readOnlyHint: source.annotations.readOnlyHint, + destructiveHint: source.annotations.destructiveHint, + }); + expect(tool.class).toBe(source.annotations.readOnlyHint ? 'read' : 'write'); + expect(Boolean(tool.irreversible)).toBe(Boolean(source.annotations.destructiveHint) + || tool.upstreamName === 'notion-move-pages'); + } + const names = entry.tools.map((tool) => tool.upstreamName); + expect(names).toContain('notion-create-pages'); + expect(names).toContain('notion-create-comment'); + expect(names).toContain('notion-query-data-sources'); + expect(names).not.toContain('notion-spawn-session'); + expect(names).not.toContain('notion-send-message-to-session'); + expect(names).not.toContain('notion-search-sessions'); + expect(names).not.toContain('notion-upload-skill'); + expect(entryToolProjections(entry).find((tool) => tool.name === 'notion.notion_move_pages')) + .toMatchObject({ requiredWriteMode: 'write-with-confirm', irreversible: true }); + }); + test('the Linear pin is the measured list minus caller-chosen fetch paths', () => { // The latest capture `connector-ops` took (2026-10-14) is committed beside // this suite, so the pin's schemas are compared with the measurement rather diff --git a/backend/integrations/hostedMcp/entries.ts b/backend/integrations/hostedMcp/entries.ts index 8d70c2f40d..ff97346998 100644 --- a/backend/integrations/hostedMcp/entries.ts +++ b/backend/integrations/hostedMcp/entries.ts @@ -16,8 +16,11 @@ import { AIRTABLE_ENTRY } from './airtable'; import { ATLASSIAN_ENTRY } from './atlassian'; import { GOOGLE_CALENDAR_ENTRY } from './googleCalendar'; import { LINEAR_ENTRY } from './linear'; +import { NOTION_ENTRY } from './notion'; -export const HOSTED_MCP_ENTRIES: HostedMcpEntry[] = [LINEAR_ENTRY, GOOGLE_CALENDAR_ENTRY, ATLASSIAN_ENTRY, AIRTABLE_ENTRY]; +export const HOSTED_MCP_ENTRIES: HostedMcpEntry[] = [ + LINEAR_ENTRY, GOOGLE_CALENDAR_ENTRY, ATLASSIAN_ENTRY, AIRTABLE_ENTRY, NOTION_ENTRY, +]; /** * Seven entry-local defects that would otherwise be silent, checked at module diff --git a/backend/integrations/hostedMcp/notion.ts b/backend/integrations/hostedMcp/notion.ts new file mode 100644 index 0000000000..cc8518b5de --- /dev/null +++ b/backend/integrations/hostedMcp/notion.ts @@ -0,0 +1,8213 @@ +/** + * Notion hosted MCP entry (TASK-240). Schemas and annotations were transcribed + * from connector-ops's consenting tools/list capture at 2026-10-01T11:18:41Z. + * Re-pin against the 2026-10-19 capture before the review gate. + * + * Notion's agent-session and skill tools are excluded: a Commonly grant should + * act on pages and databases, not start or message a separate Notion agent. + * Destructive operations and moves keep the irreversible floor in addition to + * the hosted write-with-confirm mode. + */ +import type { HostedMcpEntry, HostedMcpPinnedTool } from '../../services/hostedMcpEntryService'; + +const pin = ( + upstreamName: string, + description: string, + toolClass: 'read' | 'write', + inputSchema: Record, + annotations: { readOnlyHint: boolean; destructiveHint: boolean }, + irreversible = false, +): HostedMcpPinnedTool => ({ + name: upstreamName.replace(/-/g, '_'), + upstreamName, + description, + class: toolClass, + inputSchema, + annotations, + ...(irreversible ? { irreversible: true } : {}), +}); + +export const NOTION_ENTRY: HostedMcpEntry = { + id: 'notion', + title: 'Notion', + description: 'Pages, comments and databases in your Notion workspace.', + resource: 'https://mcp.notion.com/mcp', + issuer: 'https://mcp.notion.com', + client: 'cimd', + scopes: ['default'], + revoke: { + page: 'https://www.notion.so/settings', + endpoint: 'https://mcp.notion.com/token', + }, + tools: [ + pin( + "notion-search", + "Search pages and databases in the connected Notion workspace.", + 'read', + { + type: "object", + properties: { + query: { + type: "string", + description: "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.", + }, + query_type: { + description: "Specify type of the query as either \"internal\" or \"user\". Always include this input if performing \"user\" search.", + type: "string", + enum: [ + "internal", + "user", + ], + }, + data_source_url: { + description: "Optionally restrict keyword search to a data source URL returned in a tag.", + type: "string", + }, + page_url: { + description: "Optionally restrict keyword search to a page and its descendants. Accepts a Notion page URL or ID.", + type: "string", + }, + teamspace_id: { + description: "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.", + type: "string", + }, + filters: { + description: "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.", + type: "object", + properties: { + created_date_range: { + description: "Optional filter to only produce search results created within the specified date range.", + type: "object", + properties: { + start_date: { + description: "The start date of the date range as an ISO 8601 date string, if any.", + type: "string", + format: "date", + pattern: "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$", + }, + end_date: { + description: "The end date of the date range as an ISO 8601 date string, if any.", + type: "string", + format: "date", + pattern: "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$", + }, + }, + additionalProperties: false, + }, + created_by_user_ids: { + description: "Optional filter to only produce search results created by the Notion users that have the specified user IDs.", + maxItems: 100, + type: "array", + items: { + type: "string", + }, + }, + edited_by_user_ids: { + description: "Optional filter to only produce search results edited by the Notion users that have the specified user IDs. Available on the Business plan.", + maxItems: 100, + type: "array", + items: { + type: "string", + }, + }, + last_edited_date_range: { + description: "Optional filter to only produce search results last edited within the specified date range. Available on the Business plan.", + type: "object", + properties: { + start_date: { + description: "The start date of the date range as an ISO 8601 date string, if any.", + type: "string", + format: "date", + pattern: "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$", + }, + end_date: { + description: "The end date of the date range as an ISO 8601 date string, if any.", + type: "string", + format: "date", + pattern: "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$", + }, + }, + additionalProperties: false, + }, + teamspace_ids: { + description: "Optional filter to only produce search results inside one of the specified teamspaces. Selecting more than one teamspace is available on the Business plan; use teamspace_id for one teamspace on other plans.", + maxItems: 100, + type: "array", + items: { + type: "string", + }, + }, + title_only: { + description: "When true, match the query only against page and database titles instead of page content. Available on the Business plan.", + type: "boolean", + }, + content_status: { + description: "Which pages to include by status. Omit for the default live pages. Supplying this field, even with the default value, requires Business access.", + type: "string", + enum: [ + "all_with_archived", + "all_without_archived", + "verified_only", + "archived_only", + ], + }, + }, + additionalProperties: {}, + }, + sort: { + description: "Result ordering for Notion workspace search. Omit for the default \"relevance\" ordering. \"last_edited\" and \"created\" require Business access.", + type: "string", + enum: [ + "relevance", + "last_edited", + "created", + ], + }, + page_size: { + description: "Maximum number of results to return (default 10). Lower values reduce response size.", + type: "integer", + minimum: 1, + maximum: 50, + }, + max_highlight_length: { + description: "Maximum character length for result highlights (default 200). Set to 0 to omit highlights entirely.", + type: "integer", + minimum: 0, + maximum: 500, + }, + }, + required: [ + "query", + ], + $schema: "https://json-schema.org/draft/2020-12/schema", + additionalProperties: {}, + }, + { readOnlyHint: true, destructiveHint: false }, + ), + pin( + "notion-ai-search", + "Search connected Notion content with Notion AI.", + 'read', + { + type: "object", + properties: { + query: { + type: "string", + description: "Exact keywords, a page title, a project name, or a concise natural-language question. Keywords are valid; a question is not required. Preserve distinctive names and identifiers. Prefer one topic per call, ideally under 50 words. Provide a non-empty query unless intentionally browsing Notion with filters or a non-relevance sort.", + }, + query_type: { + description: "Omit or use \"internal\" for content search. Use \"user\" to look up a workspace user by name or email.", + type: "string", + enum: [ + "internal", + "user", + ], + }, + data_source_url: { + description: "Optionally restrict search to a data source URL returned in a tag. Omit when searching the whole workspace.", + type: "string", + }, + page_url: { + description: "Optionally restrict search to a page and its descendants. Accepts a Notion page URL or ID. Omit when searching the whole workspace.", + type: "string", + }, + teamspace_id: { + description: "Optionally restrict search to a teamspace ID.", + type: "string", + }, + filters: { + description: "Optional exact filters for Notion pages and databases. Supplying an effective filter selects Notion-only workspace search so the filter is enforced exactly. Omit for unified search across Notion and connected sources. Keep filter fields nested here. Some filters require Business access.", + type: "object", + properties: { + created_date_range: { + description: "Optional filter to only produce search results created within the specified date range.", + type: "object", + properties: { + start_date: { + description: "The start date of the date range as an ISO 8601 date string, if any.", + type: "string", + format: "date", + pattern: "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$", + }, + end_date: { + description: "The end date of the date range as an ISO 8601 date string, if any.", + type: "string", + format: "date", + pattern: "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$", + }, + }, + additionalProperties: false, + }, + created_by_user_ids: { + description: "Optional filter to only produce search results created by the Notion users that have the specified user IDs.", + maxItems: 100, + type: "array", + items: { + type: "string", + }, + }, + edited_by_user_ids: { + description: "Optional filter to only produce search results edited by the Notion users that have the specified user IDs. Available on the Business plan.", + maxItems: 100, + type: "array", + items: { + type: "string", + }, + }, + last_edited_date_range: { + description: "Optional filter to only produce search results last edited within the specified date range. Available on the Business plan.", + type: "object", + properties: { + start_date: { + description: "The start date of the date range as an ISO 8601 date string, if any.", + type: "string", + format: "date", + pattern: "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$", + }, + end_date: { + description: "The end date of the date range as an ISO 8601 date string, if any.", + type: "string", + format: "date", + pattern: "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$", + }, + }, + additionalProperties: false, + }, + teamspace_ids: { + description: "Optional filter to only produce search results inside one of the specified teamspaces. Selecting more than one teamspace is available on the Business plan; use teamspace_id for one teamspace on other plans.", + maxItems: 100, + type: "array", + items: { + type: "string", + }, + }, + title_only: { + description: "When true, match the query only against page and database titles instead of page content. Available on the Business plan.", + type: "boolean", + }, + content_status: { + description: "Which pages to include by status. Omit for the default live pages. Supplying this field, even with the default value, requires Business access.", + type: "string", + enum: [ + "all_with_archived", + "all_without_archived", + "verified_only", + "archived_only", + ], + }, + }, + additionalProperties: false, + }, + sort: { + description: "Omit for the default \"relevance\" ordering. \"last_edited\" and \"created\" select Notion-only workspace search and require Business access.", + type: "string", + enum: [ + "relevance", + "last_edited", + "created", + ], + }, + page_size: { + description: "Maximum number of results to return (default 10).", + type: "integer", + minimum: 1, + maximum: 50, + }, + max_highlight_length: { + description: "Maximum result highlight length (default 200). Set to 0 to omit highlights.", + type: "integer", + minimum: 0, + maximum: 500, + }, + }, + required: [ + "query", + ], + $schema: "https://json-schema.org/draft/2020-12/schema", + additionalProperties: false, + }, + { readOnlyHint: true, destructiveHint: false }, + ), + pin( + "notion-get-tool-access", + "Read current Notion tool availability and search restrictions.", + 'read', + { + type: "object", + properties: { + tool_names: { + description: "Optional RunTool names to include, such as search and ai_search. Omit to return all tools visible to this connection. Unknown or unexposed names are omitted. An empty list returns an empty map.", + maxItems: 100, + type: "array", + items: { + type: "string", + minLength: 1, + maxLength: 100, + }, + }, + }, + $schema: "https://json-schema.org/draft/2020-12/schema", + additionalProperties: false, + }, + { readOnlyHint: true, destructiveHint: false }, + ), + pin( + "notion-fetch", + "Read one Notion page, database, data source or saved view.", + 'read', + { + type: "object", + properties: { + id: { + type: "string", + description: "The ID or URL of the Notion page, database, or data source to fetch. Supports notion.so URLs, Notion Sites URLs (*.notion.site), raw UUIDs, and data source URLs (collection://...). Pass a notion://docs/* URI to read that documentation resource. Also accepts an explicit saved view URL (view://...) from a database response. If a database block ID returns a validation error, use the collection:// URL from that error. Example: notion://docs/enhanced-markdown-spec.", + }, + include_transcript: { + description: "Whether to include meeting note transcripts. Defaults to false. When true, full transcripts are included; when false, a placeholder with the meeting note URL is shown instead.", + type: "boolean", + }, + include_discussions: { + description: "Whether to include discussion/comment indicators in the page output. When true, adds a summary with discussion count, preview snippets, and discussion:// URLs. Use with the get_comments tool to retrieve full discussion content. Defaults to false.", + type: "boolean", + }, + }, + required: [ + "id", + ], + $schema: "https://json-schema.org/draft/2020-12/schema", + additionalProperties: {}, + }, + { readOnlyHint: true, destructiveHint: false }, + ), + pin( + "notion-create-pages", + "Create pages in the connected Notion workspace.", + 'write', + { + type: "object", + properties: { + pages: { + description: "The pages to create.", + maxItems: 100, + type: "array", + items: { + type: "object", + properties: { + properties: { + description: "The properties of the new page, which is a JSON map of property names to SQLite values.\nFor pages in a database, use the SQLite schema definition shown in .\nFor pages outside of a database, the only allowed property is \"title\", which is the title of the page and is automatically shown at the top of the page as a large heading.\n**IMPORTANT**: Some property types require specific formats:\n- Date properties: Split into \"date:{property}:start\", \"date:{property}:end\" (optional), and \"date:{property}:is_datetime\" (0 or 1)\n- Place properties: Split into \"place:{property}:name\", \"place:{property}:address\", \"place:{property}:latitude\", \"place:{property}:longitude\", and \"place:{property}:google_place_id\" (optional)\n- Number properties: Use JavaScript numbers (not strings)\n- Checkbox properties: Use \"__YES__\" for checked, \"__NO__\" for unchecked\n- Relation properties: Use an array of related page URLs or page IDs, e.g. [\"https://www.notion.so/26ab1f9f4c5f80b18d3bd10a6b1d2f4e\", \"26ab1f9f-4c5f-80b1-8d3b-d10a6b1d2f4e\"]\n- Person properties: Use an array of user IDs, user or agent URLs, or group references copied from fetch output (\"space_permission_group-\"). Bare group UUIDs are also supported.\n- Files properties: Use a JSON array of file IDs, Notion Folder URLs, and/or tags copied from fetch output. Folders are stored as native Folder references, not ordinary links.\n\n\n**Special property naming**: Properties named \"id\" or \"url\" (case insensitive) must be prefixed with \"userDefined:\" (e.g., \"userDefined:URL\", \"userDefined:id\")", + type: "object", + propertyNames: { + type: "string", + }, + additionalProperties: { + anyOf: [ + { + type: "string", + }, + { + type: "number", + }, + { + maxItems: 100, + type: "array", + items: { + type: "string", + }, + }, + { + type: "null", + }, + ], + }, + }, + content: { + description: "The content of the new page, using Notion Markdown. For people and dates, use user and date mentions rather than plain text; notion://docs/enhanced-markdown-spec gives the syntax.", + type: "string", + }, + template_id: { + description: "The ID of a template to apply to this page. When specified, do not provide 'content' as the template will provide it. Properties can still be set alongside the template. Get template IDs from the section in the fetch tool results. Template application is asynchronous: the page starts blank and content appears shortly after.", + type: "string", + }, + icon: { + description: "An emoji character (e.g. \"🚀\"), a custom emoji by name (e.g. \":rocket_ship:\"), a Notion icon identifier as returned by fetch (e.g. \"icons/pizza_blue\"), or an external image URL. Use \"none\" to explicitly set no icon. Omit to leave unchanged. Keep the title free of a duplicate leading emoji because the icon renders separately.", + type: "string", + }, + cover: { + description: "An external image URL for the page cover. Use \"none\" to explicitly set no cover. Omit to leave unchanged.", + type: "string", + }, + is_skill: { + description: "Set to true only when the user asks for reusable instructions or a repeatable workflow. Do not mark ordinary reference pages, one-time documents, or drafts as skills. Before creating a skill, read the MCP resource `notion://docs/skills` through your MCP client's resource-reading interface. If your client does not support reading MCP resources, call the Notion \"fetch\" tool with this URI instead. Do NOT pass this URI to any other URL-fetching tool. False has the same effect as omitting the field.", + type: "boolean", + }, + preserve_internal_links: { + description: "Preserve internal Markdown links instead of converting them to native mentions.", + type: "boolean", + }, + }, + additionalProperties: false, + }, + }, + creation_mode: { + description: "If the user explicitly names a private or shared destination, omit \"creation_mode\" and use that parent. Otherwise, use \"draft\" when the user clearly wants a durable page but has not named a destination. Prefer this explicit draft mode over omitting the parent. Draft mode is server-enforced: it creates a private workspace-level page and cannot be combined with \"parent\". Create it without first asking where it should live. After creation, tell the user it is private and offer to move it once they name a destination.", + type: "string", + enum: [ + "draft", + ], + }, + parent: { + description: "All pages in one call share this parent. Otherwise use a page (page_id), database page (database_id), or data source (data_source_id). A database_id cannot be used when the database has more than one data source; fetch it and use the right collection:// URL as data_source_id. If omitted, pages are private at the workspace level. When no destination is named, prefer explicit \"creation_mode\": \"draft\" over omitting the parent.", + anyOf: [ + { + type: "object", + properties: { + page_id: { + type: "string", + description: "The ID of the parent page (with or without dashes), for example, 195de9221179449fab8075a27c979105", + }, + type: { + description: "Always `page_id`", + type: "string", + enum: [ + "page_id", + ], + }, + }, + required: [ + "page_id", + ], + additionalProperties: {}, + }, + { + type: "object", + properties: { + database_id: { + type: "string", + description: "The ID of the parent database (with or without dashes), for example, 195de9221179449fab8075a27c979105", + }, + type: { + description: "Always `database_id`", + type: "string", + enum: [ + "database_id", + ], + }, + }, + required: [ + "database_id", + ], + additionalProperties: {}, + }, + { + type: "object", + properties: { + data_source_id: { + type: "string", + description: "The ID of the parent data source (collection), with or without dashes. For example, f336d0bc-b841-465b-8045-024475c079dd", + }, + type: { + description: "Always `data_source_id`", + type: "string", + enum: [ + "data_source_id", + ], + }, + }, + required: [ + "data_source_id", + ], + additionalProperties: {}, + }, + ], + }, + allow_async: { + description: "Default to true for page creation. Set to false only when the next step needs the created pages immediately, or when async execution rejects the request as too large. When this create operation is accepted for background execution, it returns an async_task result. Use get_async_task to wait for a succeeded status before taking a dependent action on the pages. For pages created with template_id, a succeeded status does not mean template content is ready; fetch and retry until it is ready before changing or relying on that content. If omitted or false, the tool keeps the existing synchronous result shape.", + type: "boolean", + }, + }, + required: [ + "pages", + ], + $schema: "https://json-schema.org/draft/2020-12/schema", + additionalProperties: {}, + }, + { readOnlyHint: false, destructiveHint: false }, + ), + pin( + "notion-update-page", + "Update or archive a Notion page.", + 'write', + { + type: "object", + properties: { + page_id: { + type: "string", + description: "The ID of the page to update, with or without dashes.", + }, + command: { + type: "string", + enum: [ + "update_properties", + "update_content", + "replace_content", + "insert_content", + "apply_template", + "update_verification", + ], + description: "The update command to execute.", + }, + properties: { + description: "Required for \"update_properties\" command. A JSON object that updates the page's properties.\nFor pages in a database, fetch the page or its data source first and use the exact property names and SQLite schema definition shown in .\nFor pages outside of a database, the only allowed property is \"title\", which is the title of the page in inline markdown format.\nFor a Files property, an uploaded file can be provided as {\"type\":\"file_upload\",\"file_upload\":{\"id\":\"\"}} inside the property's array.\nUse null to remove a property's value.\n**IMPORTANT**: Some property types require specific formats:\n- Date properties: Split into \"date:{property}:start\", \"date:{property}:end\" (optional), and \"date:{property}:is_datetime\" (0 or 1)\n- Place properties: Split into \"place:{property}:name\", \"place:{property}:address\", \"place:{property}:latitude\", \"place:{property}:longitude\", and \"place:{property}:google_place_id\" (optional)\n- Number properties: Use JavaScript numbers (not strings)\n- Checkbox properties: Use \"__YES__\" for checked, \"__NO__\" for unchecked\n- Relation properties: Use an array of related page URLs or page IDs, e.g. [\"https://www.notion.so/26ab1f9f4c5f80b18d3bd10a6b1d2f4e\", \"26ab1f9f-4c5f-80b1-8d3b-d10a6b1d2f4e\"]\n- Person properties: Use an array of user IDs, user or agent URLs, or group references copied from fetch output (\"space_permission_group-\"). Bare group UUIDs are also supported.\n- Files properties: Use a JSON array of file IDs, Notion Folder URLs, and/or tags copied from fetch output. Folders are stored as native Folder references, not ordinary links.\n\n\n**Special property naming**: Properties named \"id\" or \"url\" (case insensitive) must be prefixed with \"userDefined:\" (e.g., \"userDefined:URL\", \"userDefined:id\")", + type: "object", + propertyNames: { + type: "string", + }, + additionalProperties: { + anyOf: [ + { + type: "string", + }, + { + type: "number", + }, + { + maxItems: 100, + type: "array", + items: { + anyOf: [ + { + type: "string", + }, + { + type: "object", + properties: { + type: { + type: "string", + enum: [ + "file_upload", + ], + description: "Always `file_upload`", + }, + file_upload: { + type: "object", + properties: { + id: { + type: "string", + description: "ID of a file upload returned by create_file_upload or create_attachment.", + }, + }, + required: [ + "id", + ], + additionalProperties: {}, + description: "The uploaded file to attach to the Files property.", + }, + }, + required: [ + "type", + "file_upload", + ], + additionalProperties: {}, + }, + ], + }, + }, + { + type: "null", + }, + ], + }, + }, + new_str: { + description: "Required for \"replace_content\" command. The new content string to replace the entire page content with. Preserve child pages and databases with their exact fetched or tags. For people and dates, use user and date mentions rather than plain text; notion://docs/enhanced-markdown-spec gives the syntax.", + type: "string", + }, + content: { + description: "Required for \"insert_content\" command. The markdown content to insert into the page. For people and dates, use user and date mentions rather than plain text; notion://docs/enhanced-markdown-spec gives the syntax.", + type: "string", + }, + content_updates: { + description: "Required for \"update_content\" command. An array of search-and-replace operations, each with old_str (content to find) and new_str (replacement content).", + maxItems: 100, + type: "array", + items: { + type: "object", + properties: { + old_str: { + type: "string", + minLength: 1, + description: "The existing content string to find and replace. Must exactly match the page content.", + }, + new_str: { + type: "string", + description: "The new content string to replace old_str with. For people and dates, use user and date mentions rather than plain text; notion://docs/enhanced-markdown-spec gives the syntax.", + }, + replace_all_matches: { + description: "If true, replaces all occurrences of old_str. If false (default), the operation fails if there are multiple matches.", + type: "boolean", + }, + }, + required: [ + "old_str", + "new_str", + ], + additionalProperties: {}, + }, + }, + position: { + description: "Optional for \"insert_content\" command. Use {\"type\":\"start\"} to prepend content or {\"type\":\"end\"} to append content. Omit to append.", + anyOf: [ + { + type: "object", + properties: { + type: { + type: "string", + enum: [ + "start", + ], + description: "Insert the content at the start of the page.", + }, + }, + required: [ + "type", + ], + additionalProperties: {}, + }, + { + type: "object", + properties: { + type: { + type: "string", + enum: [ + "end", + ], + description: "Insert the content at the end of the page.", + }, + }, + required: [ + "type", + ], + additionalProperties: {}, + }, + ], + }, + allow_deleting_content: { + description: "Optional for \"replace_content\" and \"update_content\" commands. Set to true to allow deletion of child pages and databases that are not referenced in the new content. If false or omitted, the operation will fail with an error listing the pages/databases that would be deleted. Show that list and ask the user for confirmation before retrying with true.", + type: "boolean", + }, + template_id: { + description: "Required for \"apply_template\" command. The ID of a template to apply to this page; any page ID can be used as a template. Template content is appended to any existing page content asynchronously.", + type: "string", + }, + verification_status: { + description: "Required for \"update_verification\" command. Set to \"verified\" to mark the page as verified, or \"unverified\" to remove verification. Requires a Business or Enterprise plan unless the page is in a wiki. When updating verification, the owner will be automatically set to the authenticated actor.", + type: "string", + enum: [ + "verified", + "unverified", + ], + }, + verification_expiry_days: { + description: "Optional for \"update_verification\" command when verification_status is \"verified\". Number of days until verification expires (e.g. 7, 30, 90). Omit for indefinite verification.", + type: "integer", + minimum: 1, + maximum: 9007199254740991, + }, + icon: { + description: "An emoji character (e.g. \"🚀\"), a custom emoji by name (e.g. \":rocket_ship:\"), a Notion icon identifier as returned by fetch (e.g. \"icons/pizza_blue\"), or an external image URL. Use \"none\" to remove the icon. Omit to leave unchanged. Can be set alongside any command. Keep the title free of a duplicate leading emoji because the icon renders separately.", + type: "string", + }, + cover: { + description: "An external image URL for the page cover. Use \"none\" to remove the cover. Omit to leave unchanged. Can be set alongside any command.", + type: "string", + }, + is_skill: { + description: "Set to true to mark this page as a skill, or false to remove the skill designation. Can be set alongside any command. To change only skill status, use \"update_properties\" and omit \"properties\".", + type: "boolean", + }, + allow_async: { + description: "Default to true for page updates. Set to false only when the next step needs the updated page immediately, or when async execution rejects the request as too large. When this update operation is accepted for background execution, it returns an async_task result. Use get_async_task to wait for a succeeded status before taking a dependent action on the page. For apply_template, a succeeded status does not mean template content is ready; fetch and retry until it is ready before changing or relying on that content. If omitted or false, the tool waits for a synchronous result when possible, but may still return a pollable async_task response if queued execution exceeds the synchronous wait deadline.", + type: "boolean", + }, + }, + required: [ + "page_id", + "command", + ], + $schema: "https://json-schema.org/draft/2020-12/schema", + additionalProperties: {}, + }, + { readOnlyHint: false, destructiveHint: true }, + true, + ), + pin( + "notion-move-pages", + "Move Notion pages or databases to a new parent.", + 'write', + { + type: "object", + properties: { + page_or_database_ids: { + description: "An array of up to 100 page or database IDs to move. IDs are v4 UUIDs and can be supplied with or without dashes (e.g. extracted from a or URL given by the \"search\" or \"fetch\" tool). Data Sources under Databases can't be moved individually.", + minItems: 1, + maxItems: 100, + type: "array", + items: { + type: "string", + }, + }, + new_parent: { + description: "The new parent under which the pages will be moved. This can be a page, the workspace, a database, or a specific data source under a database when there are multiple. Moving pages to the workspace level adds them as private pages and should rarely be used.", + anyOf: [ + { + type: "object", + properties: { + page_id: { + type: "string", + description: "The ID of the parent page (with or without dashes), for example, 195de9221179449fab8075a27c979105", + }, + type: { + description: "Always `page_id`", + type: "string", + enum: [ + "page_id", + ], + }, + }, + required: [ + "page_id", + ], + additionalProperties: {}, + }, + { + type: "object", + properties: { + database_id: { + type: "string", + description: "The ID of the parent database (with or without dashes), for example, 195de9221179449fab8075a27c979105", + }, + type: { + description: "Always `database_id`", + type: "string", + enum: [ + "database_id", + ], + }, + }, + required: [ + "database_id", + ], + additionalProperties: {}, + }, + { + type: "object", + properties: { + data_source_id: { + type: "string", + description: "The ID of the parent data source (collection), with or without dashes. For example, f336d0bc-b841-465b-8045-024475c079dd", + }, + type: { + description: "Always `data_source_id`", + type: "string", + enum: [ + "data_source_id", + ], + }, + }, + required: [ + "data_source_id", + ], + additionalProperties: {}, + }, + { + type: "object", + properties: { + type: { + type: "string", + enum: [ + "workspace", + ], + description: "The parent type.", + }, + }, + required: [ + "type", + ], + additionalProperties: {}, + }, + ], + }, + }, + required: [ + "page_or_database_ids", + "new_parent", + ], + $schema: "https://json-schema.org/draft/2020-12/schema", + additionalProperties: {}, + }, + { readOnlyHint: false, destructiveHint: false }, + true, + ), + pin( + "notion-duplicate-page", + "Duplicate a Notion page.", + 'write', + { + type: "object", + properties: { + page_id: { + type: "string", + description: "The ID of the page to duplicate. This is a v4 UUID, with or without dashes, and can be parsed from a Notion page URL.", + }, + }, + required: [ + "page_id", + ], + $schema: "https://json-schema.org/draft/2020-12/schema", + additionalProperties: {}, + }, + { readOnlyHint: false, destructiveHint: false }, + ), + pin( + "notion-create-database", + "Create a Notion database.", + 'write', + { + type: "object", + properties: { + parent: { + description: "The parent under which to create the new database. If omitted, the database will be created as a private page at the workspace level.", + type: "object", + properties: { + page_id: { + type: "string", + description: "The ID of the parent page, with or without dashes.", + }, + type: { + description: "Always `page_id`", + type: "string", + enum: [ + "page_id", + ], + }, + }, + required: [ + "page_id", + ], + additionalProperties: {}, + }, + title: { + description: "The title of the new database.", + type: "string", + }, + description: { + description: "The description of the new database.", + type: "string", + }, + schema: { + description: "SQL DDL CREATE TABLE statement defining the database schema. Cannot be combined with database_type. Column names must be double-quoted and type options use single quotes.\n\nProperty type syntax:\n- Simple: TITLE, RICH_TEXT, DATE, PEOPLE, CHECKBOX, URL, EMAIL, PHONE_NUMBER, STATUS, FILES\n- SELECT('opt':color, ...) / MULTI_SELECT('opt':color, ...)\n- NUMBER [FORMAT 'dollar'] / FORMULA('expression')\n- RELATION('ds') for a one-way relation\n- RELATION('ds', DUAL) for a two-way relation\n- RELATION('ds', DUAL 'Children') with a synced property name\n- RELATION('ds', DUAL 'Children' 'children') with a synced name and synced_id (for self-relations)\n- ROLLUP('rel_prop', 'target_prop', 'function')\n- UNIQUE_ID [PREFIX 'X'] / CREATED_TIME / LAST_EDITED_TIME\n- Any column: COMMENT 'description text' Colors: default, gray, brown, orange, yellow, green, blue, purple, pink, red.\n\n\nExamples:\n- Minimal: CREATE TABLE (\"Name\" TITLE)\n- With options: CREATE TABLE (\"Name\" TITLE, \"Budget\" NUMBER FORMAT 'dollar', \"Tags\" MULTI_SELECT('eng':blue, 'design':pink), \"Task ID\" UNIQUE_ID PREFIX 'PRJ')\n- Self-relations are a two-step flow: create the database, then use its data source ID with update_data_source to add paired properties such as RELATION('ds', DUAL 'Children' 'children').", + type: "string", + }, + database_type: { + description: "Create a canonical typed database with Notion's required properties and metadata. Supported types: tasks, projects, skills. Example: tasks. Use title \"Tasks\" when needed.", + type: "string", + enum: [ + "tasks", + "projects", + "skills", + ], + }, + }, + $schema: "https://json-schema.org/draft/2020-12/schema", + additionalProperties: {}, + }, + { readOnlyHint: false, destructiveHint: false }, + ), + pin( + "notion-create-folder", + "Create a Notion folder.", + 'write', + { + type: "object", + properties: { + parent: { + description: "Where to create the Folder.", + anyOf: [ + { + type: "object", + properties: { + page_id: { + type: "string", + description: "The ID of the page that will own the Folder.", + }, + }, + required: [ + "page_id", + ], + additionalProperties: false, + }, + { + type: "object", + properties: { + folder_id: { + type: "string", + description: "The ID of the Folder that will contain the new Folder.", + }, + }, + required: [ + "folder_id", + ], + additionalProperties: false, + }, + ], + }, + title: { + type: "string", + description: "The title of the new Folder.", + }, + }, + required: [ + "parent", + "title", + ], + $schema: "https://json-schema.org/draft/2020-12/schema", + additionalProperties: {}, + }, + { readOnlyHint: false, destructiveHint: false }, + ), + pin( + "notion-update-folder", + "Update a Notion folder.", + 'write', + { + type: "object", + properties: { + folder_id: { + type: "string", + description: "The ID of the Folder to update.", + }, + command: { + type: "string", + enum: [ + "add_files", + "remove_files", + "add_subfolder", + ], + description: "The Folder update to apply.", + }, + file_upload_ids: { + description: "Required for add_files. One or more file upload IDs returned by the file upload tools.", + minItems: 1, + maxItems: 100, + type: "array", + items: { + type: "string", + }, + }, + file_urls: { + description: "Required for remove_files. The exact file URLs shown in the Folder's latest fetch output.", + minItems: 1, + maxItems: 100, + type: "array", + items: { + type: "string", + }, + }, + title: { + description: "Required for add_subfolder. The new Folder's title.", + type: "string", + }, + }, + required: [ + "folder_id", + "command", + ], + $schema: "https://json-schema.org/draft/2020-12/schema", + additionalProperties: false, + }, + { readOnlyHint: false, destructiveHint: true }, + true, + ), + pin( + "notion-update-data-source", + "Update a Notion data source schema or layout.", + 'write', + { + type: "object", + properties: { + data_source_id: { + type: "string", + description: "The data source to update. Accepts a collection:// URI from tags, a bare UUID, or a database ID (only if the database has a single data source).", + }, + statements: { + description: "Semicolon-separated SQL DDL statements to update the schema. Supports ADD COLUMN, DROP COLUMN, RENAME COLUMN, and ALTER COLUMN SET.\n\nProperty type syntax:\n- Simple: TITLE, RICH_TEXT, DATE, PEOPLE, CHECKBOX, URL, EMAIL, PHONE_NUMBER, STATUS, FILES\n- SELECT('opt':color, ...) / MULTI_SELECT('opt':color, ...)\n- NUMBER [FORMAT 'dollar'] / FORMULA('expression')\n- RELATION('ds') for a one-way relation\n- RELATION('ds', DUAL) for a two-way relation\n- RELATION('ds', DUAL 'Children') with a synced property name\n- RELATION('ds', DUAL 'Children' 'children') with a synced name and synced_id (for self-relations)\n- ROLLUP('rel_prop', 'target_prop', 'function')\n- UNIQUE_ID [PREFIX 'X'] / CREATED_TIME / LAST_EDITED_TIME\n- Any column: COMMENT 'description text' Colors: default, gray, brown, orange, yellow, green, blue, purple, pink, red.\n\n\nExamples:\n- ADD COLUMN \"Priority\" SELECT('High':red, 'Medium':yellow, 'Low':green); ADD COLUMN \"Due Date\" DATE\n- RENAME COLUMN \"Status\" TO \"Project Status\"\n- DROP COLUMN \"Old Property\"\n- For a self-relation, add both relation properties in one call with matching DUAL names and IDs, such as ADD COLUMN \"Parent\" RELATION('ds', DUAL 'Children' 'children').", + type: "string", + }, + title: { + description: "The new title of the data source.", + type: "string", + }, + description: { + description: "The new description of the data source.", + type: "string", + }, + is_inline: { + description: "Whether the database should display inline (true) or as full page (false). Only applicable for single-source databases.", + type: "boolean", + }, + in_trash: { + description: "Move data source to trash. Cannot be undone without Notion UI.", + type: "boolean", + }, + page_layout: { + description: "Replaces the data source's page layout. Refer to existing properties by name. See notion://docs/database-page-layouts. Example: {\"main\":[{\"type\":\"title\",\"pinnedProperties\":[\"Status\",\"Owner\"]},{\"type\":\"editor\"},{\"type\":\"discussions\"}],\"sidebar\":[{\"type\":\"properties\"}]}.", + type: "object", + properties: { + main: { + type: "array", + items: { + anyOf: [ + { + type: "object", + properties: { + type: { + type: "string", + enum: [ + "cover", + "properties", + "editor", + "discussions", + "relations", + "backlinks", + "page_sections", + "bottom_controls", + ], + description: "The module type.", + }, + }, + required: [ + "type", + ], + additionalProperties: false, + }, + { + type: "object", + properties: { + type: { + type: "string", + enum: [ + "title", + ], + description: "The module type.", + }, + pinnedProperties: { + description: "Property names to show under the title.", + type: "array", + items: { + type: "string", + }, + }, + propertyLabels: { + description: "Whether pinned properties show their names.", + type: "string", + enum: [ + "show", + "hide", + ], + }, + }, + required: [ + "type", + ], + additionalProperties: false, + }, + { + type: "object", + properties: { + type: { + type: "string", + enum: [ + "property", + ], + description: "The module type.", + }, + property: { + type: "string", + description: "The name of the property to show.", + }, + config: { + description: "How the property looks.", + type: "object", + properties: { + style: { + type: "string", + enum: [ + "compact", + "large", + "small", + "landscape", + "portrait", + "square", + "map", + "text", + ], + description: "Display style. Which styles apply depends on the property type.", + }, + }, + required: [ + "style", + ], + additionalProperties: false, + }, + }, + required: [ + "type", + "property", + ], + additionalProperties: false, + }, + { + type: "object", + properties: { + type: { + type: "string", + enum: [ + "views", + ], + description: "The module type.", + }, + relation: { + type: "string", + description: "The name of a two-way relation property whose related pages show as a view.", + }, + }, + required: [ + "type", + "relation", + ], + additionalProperties: false, + }, + ], + }, + description: "Main area modules in order. Include a title, an editor (unless the layout has a tab), and discussions.", + }, + sidebar: { + description: "Sidebar modules in order. Only properties and property modules are allowed.", + type: "array", + items: { + anyOf: [ + { + type: "object", + properties: { + type: { + type: "string", + enum: [ + "properties", + ], + description: "The module type.", + }, + }, + required: [ + "type", + ], + additionalProperties: false, + }, + { + type: "object", + properties: { + type: { + type: "string", + enum: [ + "property", + ], + description: "The module type.", + }, + property: { + type: "string", + description: "The name of the property to show.", + }, + config: { + description: "How the property looks.", + type: "object", + properties: { + style: { + type: "string", + enum: [ + "compact", + "large", + "small", + "landscape", + "portrait", + "square", + "map", + "text", + ], + description: "Display style. Which styles apply depends on the property type.", + }, + }, + required: [ + "style", + ], + additionalProperties: false, + }, + }, + required: [ + "type", + "property", + ], + additionalProperties: false, + }, + ], + }, + }, + tab: { + description: "Puts page content in a tab next to database views. Omit for a simple layout.", + type: "object", + properties: { + id: { + description: "The existing tab ID from fetch. Omit for a new tab. Starts with view_tab_.", + type: "string", + }, + modules: { + type: "array", + items: { + anyOf: [ + { + type: "object", + properties: { + type: { + type: "string", + enum: [ + "properties", + "editor", + "discussions", + "relations", + ], + description: "The module type.", + }, + }, + required: [ + "type", + ], + additionalProperties: false, + }, + { + type: "object", + properties: { + type: { + type: "string", + enum: [ + "property", + ], + description: "The module type.", + }, + property: { + type: "string", + description: "The name of the property to show.", + }, + config: { + description: "How the property looks.", + type: "object", + properties: { + style: { + type: "string", + enum: [ + "compact", + "large", + "small", + "landscape", + "portrait", + "square", + "map", + "text", + ], + description: "Display style. Which styles apply depends on the property type.", + }, + }, + required: [ + "style", + ], + additionalProperties: false, + }, + }, + required: [ + "type", + "property", + ], + additionalProperties: false, + }, + ], + }, + description: "Tab modules in order. Must include an editor. Only properties, property modules, discussions, relations, and the editor are allowed.", + }, + }, + required: [ + "modules", + ], + additionalProperties: false, + }, + format: { + description: "Page display options.", + type: "object", + properties: { + propertyIcons: { + description: "Whether property icons show on the page.", + type: "string", + enum: [ + "show", + "hide", + ], + }, + pageFullWidth: { + description: "Whether pages open at full width.", + type: "boolean", + }, + }, + additionalProperties: false, + }, + }, + required: [ + "main", + ], + additionalProperties: false, + }, + }, + required: [ + "data_source_id", + ], + $schema: "https://json-schema.org/draft/2020-12/schema", + additionalProperties: {}, + }, + { readOnlyHint: false, destructiveHint: true }, + true, + ), + pin( + "notion-create-comment", + "Add a comment to Notion content.", + 'write', + { + type: "object", + properties: { + page_id: { + type: "string", + description: "The ID of the page to comment on (with or without dashes).", + }, + discussion_id: { + description: "The ID or URL of an existing discussion to reply to (e.g., discussion://pageId/blockId/discussionId).", + type: "string", + }, + selection_with_ellipsis: { + description: "Unique start and end snippet of the content to comment on. DO NOT provide the entire string. Instead, provide up to the first ~10 characters, an ellipsis, and then up to the last ~10 characters. Make sure you provide enough of the start and end snippet to uniquely identify the content. For example: \"# Section heading...last paragraph.\"", + type: "string", + }, + rich_text: { + description: "An array of rich text objects that represent the content of the comment. Provide exactly one of rich_text or markdown.", + maxItems: 100, + type: "array", + items: { + allOf: [ + { + type: "object", + properties: { + annotations: { + description: "All rich text objects contain an annotations object that sets the styling for the rich text.", + type: "object", + properties: { + bold: { + description: "Whether the text is formatted as bold.", + type: "boolean", + }, + italic: { + description: "Whether the text is formatted as italic.", + type: "boolean", + }, + strikethrough: { + description: "Whether the text is formatted with a strikethrough.", + type: "boolean", + }, + underline: { + description: "Whether the text is formatted with an underline.", + type: "boolean", + }, + code: { + description: "Whether the text is formatted as code.", + type: "boolean", + }, + color: { + description: "The color of the text.", + type: "string", + }, + }, + additionalProperties: {}, + }, + }, + additionalProperties: {}, + }, + { + anyOf: [ + { + type: "object", + properties: { + type: { + description: "Always `text`", + type: "string", + enum: [ + "text", + ], + }, + text: { + type: "object", + properties: { + content: { + type: "string", + maxLength: 2000, + description: "The actual text content of the text.", + }, + link: { + description: "An object with information about any inline link in this text, if included.", + anyOf: [ + { + type: "object", + properties: { + url: { + type: "string", + description: "The URL of the link.", + }, + }, + required: [ + "url", + ], + additionalProperties: {}, + }, + { + type: "null", + }, + ], + }, + }, + required: [ + "content", + ], + additionalProperties: false, + description: "If a rich text object's type value is `text`, then the corresponding text field contains an object including the text content and any inline link.", + }, + }, + required: [ + "text", + ], + additionalProperties: {}, + }, + { + type: "object", + properties: { + type: { + description: "Always `mention`", + type: "string", + enum: [ + "mention", + ], + }, + mention: { + anyOf: [ + { + type: "object", + properties: { + type: { + description: "Always `user`", + type: "string", + enum: [ + "user", + ], + }, + user: { + type: "object", + properties: { + id: { + type: "string", + description: "The ID of the user.", + }, + object: { + description: "The user object type name.", + type: "string", + enum: [ + "user", + ], + }, + }, + required: [ + "id", + ], + additionalProperties: {}, + description: "Details of the user mention.", + }, + }, + required: [ + "user", + ], + additionalProperties: {}, + }, + { + type: "object", + properties: { + type: { + description: "Always `date`", + type: "string", + enum: [ + "date", + ], + }, + date: { + type: "object", + properties: { + start: { + type: "string", + format: "date", + pattern: "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$", + description: "The start date of the date object.", + }, + end: { + description: "The end date of the date object, if any.", + anyOf: [ + { + type: "string", + format: "date", + pattern: "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$", + }, + { + type: "null", + }, + ], + }, + time_zone: { + description: "The time zone of the date object, if any. E.g. America/Los_Angeles, Europe/London, etc.", + anyOf: [ + { + type: "string", + }, + { + type: "null", + }, + ], + }, + }, + required: [ + "start", + ], + additionalProperties: false, + description: "Details of the date mention.", + }, + }, + required: [ + "date", + ], + additionalProperties: {}, + }, + { + type: "object", + properties: { + type: { + description: "Always `page`", + type: "string", + enum: [ + "page", + ], + }, + page: { + type: "object", + properties: { + id: { + type: "string", + description: "The ID of the page in the mention.", + }, + }, + required: [ + "id", + ], + additionalProperties: {}, + description: "Details of the page mention.", + }, + }, + required: [ + "page", + ], + additionalProperties: {}, + }, + { + type: "object", + properties: { + type: { + description: "Always `database`", + type: "string", + enum: [ + "database", + ], + }, + database: { + type: "object", + properties: { + id: { + type: "string", + description: "The ID of the database in the mention.", + }, + }, + required: [ + "id", + ], + additionalProperties: {}, + description: "Details of the database mention.", + }, + }, + required: [ + "database", + ], + additionalProperties: {}, + }, + { + type: "object", + properties: { + type: { + description: "Always `template_mention`", + type: "string", + enum: [ + "template_mention", + ], + }, + template_mention: { + anyOf: [ + { + type: "object", + properties: { + type: { + description: "Always `template_mention_date`", + type: "string", + enum: [ + "template_mention_date", + ], + }, + template_mention_date: { + type: "string", + enum: [ + "today", + "now", + ], + description: "The date of the template mention.", + }, + }, + required: [ + "template_mention_date", + ], + additionalProperties: false, + }, + { + type: "object", + properties: { + type: { + description: "Always `template_mention_user`", + type: "string", + enum: [ + "template_mention_user", + ], + }, + template_mention_user: { + type: "string", + enum: [ + "me", + ], + description: "The user of the template mention.", + }, + }, + required: [ + "template_mention_user", + ], + additionalProperties: false, + }, + ], + description: "Details of the template mention.", + }, + }, + required: [ + "template_mention", + ], + additionalProperties: {}, + }, + { + type: "object", + properties: { + type: { + description: "Always `custom_emoji`", + type: "string", + enum: [ + "custom_emoji", + ], + }, + custom_emoji: { + type: "object", + properties: { + id: { + type: "string", + description: "The ID of the custom emoji.", + }, + name: { + description: "The name of the custom emoji.", + type: "string", + }, + url: { + description: "The URL of the custom emoji.", + type: "string", + }, + }, + required: [ + "id", + ], + additionalProperties: {}, + description: "Details of the custom emoji mention.", + }, + }, + required: [ + "custom_emoji", + ], + additionalProperties: {}, + }, + ], + description: "Mention objects represent an inline mention of a database, date, link preview mention, page, template mention, or user. A mention is created in the Notion UI when a user types `@` followed by the name of the reference.", + }, + }, + required: [ + "mention", + ], + additionalProperties: {}, + }, + { + type: "object", + properties: { + type: { + description: "Always `equation`", + type: "string", + enum: [ + "equation", + ], + }, + equation: { + type: "object", + properties: { + expression: { + type: "string", + description: "A KaTeX compatible string.", + }, + }, + required: [ + "expression", + ], + additionalProperties: {}, + description: "Notion supports inline LaTeX equations as rich text objects with a type value of `equation`.", + }, + }, + required: [ + "equation", + ], + additionalProperties: {}, + }, + ], + }, + ], + }, + }, + markdown: { + description: "The content of the comment as a Markdown string. Provide exactly one of markdown or rich_text. For exact syntax, read the MCP resource `notion://docs/enhanced-markdown-spec` through your MCP client's resource-reading interface, or call the Notion \"fetch\" tool with this URI if your client does not support reading MCP resources. Do NOT pass this URI to any other URL-fetching tool. Use only the Rich text types and Mentions syntax that comments support. Comments support inline formatting (bold, italic, strikethrough, underline, code, links), inline math using $`Equation`$, and user/page/database/date mention tags such as . To attach a file created by create-file-upload or create-attachment, include its returned suggested_markdown on a separate line; up to three file attachments are supported. Do not use UI shortcuts like @today, @name, [[page]], or autocomplete-style emoji syntax; those are editor affordances, not markdown syntax. Mention tags must include a real url where required by the spec. Other block-level Markdown such as fenced code blocks, headings, lists, tables, and blockquotes is stored as plain comment text rather than rendered as blocks. Example: Looks good..", + type: "string", + }, + }, + required: [ + "page_id", + ], + $schema: "https://json-schema.org/draft/2020-12/schema", + additionalProperties: {}, + }, + { readOnlyHint: false, destructiveHint: false }, + ), + pin( + "notion-get-comments", + "Read comments on a Notion page.", + 'read', + { + type: "object", + properties: { + page_id: { + type: "string", + description: "Identifier for a Notion page.", + }, + include_resolved: { + description: "Include resolved discussions in the response. Defaults to false.", + type: "boolean", + }, + include_all_blocks: { + description: "Include discussions on child blocks, not just page-level discussions. Defaults to false.", + type: "boolean", + }, + discussion_id: { + description: "Fetch a specific discussion by ID or discussion URL (e.g., discussion://pageId/blockId/discussionId).", + type: "string", + }, + }, + required: [ + "page_id", + ], + $schema: "https://json-schema.org/draft/2020-12/schema", + additionalProperties: {}, + }, + { readOnlyHint: true, destructiveHint: false }, + ), + pin( + "notion-get-async-task", + "Read the status of a Notion task started by another tool.", + 'read', + { + type: "object", + properties: { + task_id: { + type: "string", + minLength: 1, + description: "The ID of the async task to retrieve, as returned in the async_task response of the tool that started it.", + }, + }, + required: [ + "task_id", + ], + $schema: "https://json-schema.org/draft/2020-12/schema", + additionalProperties: {}, + }, + { readOnlyHint: true, destructiveHint: false }, + ), + pin( + "notion-get-teams", + "List teams in the connected Notion workspace.", + 'read', + { + type: "object", + properties: { + query: { + description: "Optional search query to filter teams by name (case-insensitive).", + type: "string", + minLength: 1, + maxLength: 100, + }, + }, + $schema: "https://json-schema.org/draft/2020-12/schema", + additionalProperties: {}, + }, + { readOnlyHint: true, destructiveHint: false }, + ), + pin( + "notion-get-users", + "List users in the connected Notion workspace.", + 'read', + { + type: "object", + properties: { + query: { + description: "Optional search query to filter users by name or email (case-insensitive).", + type: "string", + minLength: 1, + maxLength: 100, + }, + start_cursor: { + description: "Cursor for pagination. Use the next_cursor value from the previous response to get the next page.", + type: "string", + minLength: 1, + }, + page_size: { + description: "Number of users to return per page (1–100; default 100).", + type: "integer", + minimum: 1, + maximum: 100, + }, + user_id: { + description: "Return only the user matching this ID. Pass \"self\" to fetch the current user.", + type: "string", + minLength: 1, + maxLength: 100, + }, + }, + $schema: "https://json-schema.org/draft/2020-12/schema", + additionalProperties: {}, + }, + { readOnlyHint: true, destructiveHint: false }, + ), + pin( + "notion-query-data-sources", + "Query rows in a Notion data source.", + 'read', + { + type: "object", + properties: { + data: { + description: "Mode parameter reference and examples.\n\nSQL mode:\n- Checkbox values: use \"__YES__\" for checked, \"__NO__\" for unchecked\n\n\nRows mode: Return up to 100 rows with faithful rich-text property values and optional structured filters and sorts.\n\nExample:\n{\"mode\":\"rows\",\"data_source_url\":\"collection://f336d0bc-b841-465b-8045-024475c079dd\",\"filter\":{\"type\":\"group\",\"operator\":\"and\",\"filters\":[{\"type\":\"property\",\"property\":\"Status\",\"propertyType\":\"select\",\"operator\":\"enum_is\",\"value\":{\"type\":\"exact\",\"value\":\"In Progress\"}}]},\"limit\":20}\n\nExamples:\n- Simple SQL: {\"data_source_urls\":[\"collection://f336d0bc-b841-465b-8045-024475c079dd\"],\"query\":\"SELECT * FROM [collection://f336d0bc-b841-465b-8045-024475c079dd] LIMIT 10\"}\n- SQL parameters: {\"mode\":\"sql\",\"data_source_urls\":[\"collection://abc123\"],\"query\":\"SELECT * FROM [collection://abc123] WHERE Status = ? AND Priority = ?\",\"params\":[\"In Progress\",\"High\"]}\n- Checkbox query: {\"data_source_urls\":[\"collection://def456\"],\"query\":\"SELECT * FROM [collection://def456] WHERE Completed = ?\",\"params\":[\"__YES__\"]}\n\nView mode: Execute a specific database view's query with its filters and sorts. Omit \"is_archived\" or set it to false for non-archived rows. Set \"is_archived\": true to apply the view inside the archived partition. When the response has \"has_more\": true, pass its \"next_cursor\" as \"start_cursor\" in a follow-up view-mode request with the same \"is_archived\" value.\n\nExample:\n{\"mode\":\"view\",\"view_url\":\"https://www.notion.so/workspace/Tasks-DB-abc123?v=def456\",\"is_archived\":false}", + anyOf: [ + { + type: "object", + properties: { + data_source_urls: { + maxItems: 100, + type: "array", + items: { + type: "string", + }, + description: "Notion data source URLs whose SQLite tables are available to the query; each data source is exposed as a table named by its URL. Obtain them from the fetch tool, in the format: collection://f336d0bc-b841-465b-8045-024475c079dd", + }, + query: { + type: "string", + description: "Read-only SQLite query to execute against the data sources. Use a data source URL as the table name, e.g. SELECT * FROM \"collection://...\" WHERE .... Include every needed filter in WHERE (filters on views of the data source are not automatically applied). For time comparisons or ordering, normalize text timestamps with datetime(...) or date(...). SQL text values can omit rich-text mentions and formatting, and links can lose their destination. Use faithful rows mode or fetch the page before rewriting a rich-text property.", + }, + mode: { + description: "Optional mode parameter. Defaults to 'sql' if not specified. SQL mode does not accept is_archived; that parameter belongs only to view mode.", + type: "string", + enum: [ + "sql", + ], + }, + params: { + description: "Positional parameters bound to `?` placeholders in the query. Prefer parameterized queries over string interpolation. Use \"__YES__\" for checked checkboxes and \"__NO__\" for unchecked checkboxes.", + maxItems: 100, + type: "array", + items: { + anyOf: [ + { + type: "string", + }, + { + type: "number", + }, + { + type: "boolean", + }, + { + type: "null", + }, + ], + }, + }, + }, + required: [ + "data_source_urls", + "query", + ], + additionalProperties: false, + }, + { + type: "object", + properties: { + mode: { + type: "string", + enum: [ + "view", + ], + description: "Mode for executing a database view's existing query", + }, + view_url: { + type: "string", + description: "URL of a specific database view to query. Example: https://www.notion.so/workspace/db-id?v=view-id", + }, + start_cursor: { + description: "Cursor for pagination. Use the next_cursor value from the previous response to get the next page.", + type: "string", + minLength: 1, + maxLength: 200, + }, + page_size: { + description: "Number of rows to return per page (default: 100, max: 100).", + type: "integer", + minimum: 1, + maximum: 100, + }, + is_archived: { + description: "Optional archive selector. Omitted or false queries non-archived rows only; true queries archived rows only.", + type: "boolean", + }, + }, + required: [ + "mode", + "view_url", + ], + additionalProperties: false, + }, + { + type: "object", + properties: { + mode: { + type: "string", + enum: [ + "rows", + ], + description: "Return data source rows with rich-text mentions, links, formatting, dates, and equations preserved.", + }, + data_source_url: { + type: "string", + description: "One Notion data source URL obtained from a fetch result.", + }, + filter: { + description: "Structured filter using exact property names from the data source schema. Supports an outer Boolean group plus one nested group level.", + type: "object", + properties: { + type: { + type: "string", + enum: [ + "group", + ], + description: "Selects the filter or filter-value variant.", + }, + operator: { + type: "string", + enum: [ + "and", + "or", + ], + description: "Comparison or Boolean operation applied by this filter.", + }, + filters: { + maxItems: 100, + type: "array", + items: { + anyOf: [ + { + anyOf: [ + { + type: "object", + properties: { + type: { + type: "string", + enum: [ + "property", + ], + description: "Selects the filter or filter-value variant.", + }, + property: { + type: "string", + description: "Exact data source property name to filter.", + }, + propertyType: { + type: "string", + description: "Notion property type used to select valid operators and value shapes.", + }, + operator: { + type: "string", + enum: [ + "is_empty", + "is_not_empty", + ], + description: "Comparison or Boolean operation applied by this filter.", + }, + }, + required: [ + "type", + "property", + "propertyType", + "operator", + ], + additionalProperties: false, + description: "Checks whether a property has any value.", + }, + { + type: "object", + properties: { + type: { + type: "string", + enum: [ + "property", + ], + description: "Selects the filter or filter-value variant.", + }, + property: { + type: "string", + description: "Exact data source property name to filter.", + }, + propertyType: { + type: "string", + enum: [ + "title", + "text", + "url", + "email", + "phone_number", + ], + description: "Notion property type used to select valid operators and value shapes.", + }, + operator: { + type: "string", + enum: [ + "string_is", + "string_is_not", + "string_contains", + "string_does_not_contain", + "string_starts_with", + "string_ends_with", + ], + description: "Comparison or Boolean operation applied by this filter.", + }, + value: { + type: "object", + properties: { + type: { + type: "string", + enum: [ + "exact", + ], + description: "Selects the filter or filter-value variant.", + }, + value: { + type: "string", + description: "Literal or relative value used by the filter.", + }, + }, + required: [ + "type", + "value", + ], + additionalProperties: false, + description: "Literal or relative value used by the filter.", + }, + }, + required: [ + "type", + "property", + "propertyType", + "operator", + "value", + ], + additionalProperties: false, + description: "Property filter for text-like properties.", + }, + { + type: "object", + properties: { + type: { + type: "string", + enum: [ + "property", + ], + description: "Selects the filter or filter-value variant.", + }, + property: { + type: "string", + description: "Exact data source property name to filter.", + }, + propertyType: { + type: "string", + enum: [ + "number", + "auto_increment_id", + ], + description: "Notion property type used to select valid operators and value shapes.", + }, + operator: { + type: "string", + enum: [ + "number_equals", + "number_does_not_equal", + "number_greater_than", + "number_less_than", + "number_greater_than_or_equal_to", + "number_less_than_or_equal_to", + ], + description: "Comparison or Boolean operation applied by this filter.", + }, + value: { + type: "object", + properties: { + type: { + type: "string", + enum: [ + "exact", + ], + description: "Selects the filter or filter-value variant.", + }, + value: { + type: "number", + description: "Literal or relative value used by the filter.", + }, + }, + required: [ + "type", + "value", + ], + additionalProperties: false, + description: "Literal or relative value used by the filter.", + }, + }, + required: [ + "type", + "property", + "propertyType", + "operator", + "value", + ], + additionalProperties: false, + description: "Property filter for number properties.", + }, + { + anyOf: [ + { + type: "object", + properties: { + type: { + type: "string", + enum: [ + "property", + ], + description: "Selects the filter or filter-value variant.", + }, + property: { + type: "string", + description: "Exact data source property name to filter.", + }, + propertyType: { + type: "string", + enum: [ + "date", + "created_time", + "last_edited_time", + "last_visited_time", + ], + description: "Notion property type used to select valid operators and value shapes.", + }, + operator: { + type: "string", + enum: [ + "date_is", + "date_is_before", + "date_is_after", + "date_is_on_or_before", + "date_is_on_or_after", + ], + description: "Comparison or Boolean operation applied by this filter.", + }, + value: { + anyOf: [ + { + type: "object", + properties: { + type: { + type: "string", + enum: [ + "exact", + ], + description: "Selects the filter or filter-value variant.", + }, + value: { + type: "string", + description: "Literal or relative value used by the filter.", + }, + }, + required: [ + "type", + "value", + ], + additionalProperties: false, + }, + { + type: "object", + properties: { + type: { + type: "string", + enum: [ + "relative", + ], + description: "Selects the filter or filter-value variant.", + }, + value: { + type: "string", + enum: [ + "today", + "tomorrow", + "yesterday", + "one_week_ago", + "one_week_from_now", + "one_month_ago", + "one_month_from_now", + ], + description: "Literal or relative value used by the filter.", + }, + }, + required: [ + "type", + "value", + ], + additionalProperties: false, + }, + ], + description: "Literal or relative value used by the filter.", + }, + use_end: { + description: "For a date property, compare its end date instead of its start date.", + type: "boolean", + }, + }, + required: [ + "type", + "property", + "propertyType", + "operator", + "value", + ], + additionalProperties: false, + }, + { + type: "object", + properties: { + type: { + type: "string", + enum: [ + "property", + ], + description: "Selects the filter or filter-value variant.", + }, + property: { + type: "string", + description: "Exact data source property name to filter.", + }, + propertyType: { + type: "string", + enum: [ + "date", + "created_time", + "last_edited_time", + "last_visited_time", + ], + description: "Notion property type used to select valid operators and value shapes.", + }, + operator: { + type: "string", + enum: [ + "date_is_within", + "date_is_relative_to", + ], + description: "Comparison or Boolean operation applied by this filter.", + }, + value: { + anyOf: [ + { + type: "object", + properties: { + type: { + type: "string", + enum: [ + "exact", + ], + description: "Selects the filter or filter-value variant.", + }, + value: { + type: "object", + properties: { + type: { + type: "string", + enum: [ + "daterange", + ], + description: "Selects the filter or filter-value variant.", + }, + start_date: { + description: "ISO 8601 date or date-time at the start of the range.", + type: "string", + }, + end_date: { + description: "ISO 8601 date or date-time at the end of the range.", + type: "string", + }, + }, + required: [ + "type", + ], + additionalProperties: false, + description: "Literal or relative value used by the filter.", + }, + }, + required: [ + "type", + "value", + ], + additionalProperties: false, + }, + { + type: "object", + properties: { + type: { + type: "string", + enum: [ + "relative", + ], + description: "Selects the filter or filter-value variant.", + }, + value: { + type: "string", + enum: [ + "custom", + ], + description: "Literal or relative value used by the filter.", + }, + direction: { + type: "string", + enum: [ + "past", + "future", + ], + description: "Whether the custom range extends into the past or future.", + }, + unit: { + type: "string", + enum: [ + "year", + "month", + "week", + "day", + ], + description: "Time unit used to measure a relative date range.", + }, + count: { + type: "number", + description: "Number of units in the custom relative range.", + }, + }, + required: [ + "type", + "value", + "direction", + "unit", + "count", + ], + additionalProperties: false, + }, + { + type: "object", + properties: { + type: { + type: "string", + enum: [ + "relative", + ], + description: "Selects the filter or filter-value variant.", + }, + value: { + type: "string", + enum: [ + "surrounding", + ], + description: "Literal or relative value used by the filter.", + }, + unit: { + type: "string", + enum: [ + "year", + "month", + "week", + "day", + ], + description: "Time unit used to measure a relative date range.", + }, + }, + required: [ + "type", + "value", + "unit", + ], + additionalProperties: false, + }, + { + type: "object", + properties: { + type: { + type: "string", + enum: [ + "relative", + ], + description: "Selects the filter or filter-value variant.", + }, + value: { + type: "string", + enum: [ + "this_week", + "the_past_week", + "the_past_month", + "the_past_year", + "the_next_week", + "the_next_month", + "the_next_year", + ], + description: "Literal or relative value used by the filter.", + }, + }, + required: [ + "type", + "value", + ], + additionalProperties: false, + }, + ], + description: "Literal or relative value used by the filter.", + }, + use_end: { + description: "For a date property, compare its end date instead of its start date.", + type: "boolean", + }, + }, + required: [ + "type", + "property", + "propertyType", + "operator", + "value", + ], + additionalProperties: false, + }, + ], + description: "Property filter for date properties.", + }, + { + type: "object", + properties: { + type: { + type: "string", + enum: [ + "property", + ], + description: "Selects the filter or filter-value variant.", + }, + property: { + type: "string", + description: "Exact data source property name to filter.", + }, + propertyType: { + type: "string", + enum: [ + "select", + ], + description: "Notion property type used to select valid operators and value shapes.", + }, + operator: { + type: "string", + enum: [ + "enum_is", + "enum_is_not", + ], + description: "Comparison or Boolean operation applied by this filter.", + }, + value: { + anyOf: [ + { + type: "object", + properties: { + type: { + type: "string", + enum: [ + "exact", + ], + description: "Selects the filter or filter-value variant.", + }, + value: { + type: "string", + description: "Literal or relative value used by the filter.", + }, + }, + required: [ + "type", + "value", + ], + additionalProperties: false, + }, + { + type: "array", + items: { + type: "object", + properties: { + type: { + type: "string", + enum: [ + "exact", + ], + description: "Selects the filter or filter-value variant.", + }, + value: { + type: "string", + description: "Literal or relative value used by the filter.", + }, + }, + required: [ + "type", + "value", + ], + additionalProperties: false, + }, + }, + ], + description: "Literal or relative value used by the filter.", + }, + }, + required: [ + "type", + "property", + "propertyType", + "operator", + "value", + ], + additionalProperties: false, + description: "Property filter for select properties by option name.", + }, + { + type: "object", + properties: { + type: { + type: "string", + enum: [ + "property", + ], + description: "Selects the filter or filter-value variant.", + }, + property: { + type: "string", + description: "Exact data source property name to filter.", + }, + propertyType: { + type: "string", + enum: [ + "multi_select", + ], + description: "Notion property type used to select valid operators and value shapes.", + }, + operator: { + type: "string", + enum: [ + "enum_contains", + "enum_does_not_contain", + ], + description: "Comparison or Boolean operation applied by this filter.", + }, + value: { + anyOf: [ + { + type: "object", + properties: { + type: { + type: "string", + enum: [ + "exact", + ], + description: "Selects the filter or filter-value variant.", + }, + value: { + type: "string", + description: "Literal or relative value used by the filter.", + }, + }, + required: [ + "type", + "value", + ], + additionalProperties: false, + }, + { + type: "array", + items: { + type: "object", + properties: { + type: { + type: "string", + enum: [ + "exact", + ], + description: "Selects the filter or filter-value variant.", + }, + value: { + type: "string", + description: "Literal or relative value used by the filter.", + }, + }, + required: [ + "type", + "value", + ], + additionalProperties: false, + }, + }, + ], + description: "Literal or relative value used by the filter.", + }, + }, + required: [ + "type", + "property", + "propertyType", + "operator", + "value", + ], + additionalProperties: false, + description: "Property filter for multi-select properties.", + }, + { + type: "object", + properties: { + type: { + type: "string", + enum: [ + "property", + ], + description: "Selects the filter or filter-value variant.", + }, + property: { + type: "string", + description: "Exact data source property name to filter.", + }, + propertyType: { + type: "string", + enum: [ + "checkbox", + ], + description: "Notion property type used to select valid operators and value shapes.", + }, + operator: { + type: "string", + enum: [ + "checkbox_is", + "checkbox_is_not", + ], + description: "Comparison or Boolean operation applied by this filter.", + }, + value: { + type: "object", + properties: { + type: { + type: "string", + enum: [ + "exact", + ], + description: "Selects the filter or filter-value variant.", + }, + value: { + type: "boolean", + description: "Literal or relative value used by the filter.", + }, + }, + required: [ + "type", + "value", + ], + additionalProperties: false, + description: "Literal or relative value used by the filter.", + }, + }, + required: [ + "type", + "property", + "propertyType", + "operator", + "value", + ], + additionalProperties: false, + description: "Property filter for checkbox properties.", + }, + { + type: "object", + properties: { + type: { + type: "string", + enum: [ + "property", + ], + description: "Selects the filter or filter-value variant.", + }, + property: { + type: "string", + description: "Exact data source property name to filter.", + }, + propertyType: { + type: "string", + enum: [ + "relation", + ], + description: "Notion property type used to select valid operators and value shapes.", + }, + operator: { + type: "string", + enum: [ + "relation_contains", + "relation_does_not_contain", + ], + description: "Comparison or Boolean operation applied by this filter.", + }, + value: { + anyOf: [ + { + type: "object", + properties: { + type: { + type: "string", + enum: [ + "exact", + ], + description: "Selects the filter or filter-value variant.", + }, + value: { + type: "string", + description: "Literal or relative value used by the filter.", + }, + }, + required: [ + "type", + "value", + ], + additionalProperties: false, + }, + { + type: "array", + items: { + type: "object", + properties: { + type: { + type: "string", + enum: [ + "exact", + ], + description: "Selects the filter or filter-value variant.", + }, + value: { + type: "string", + description: "Literal or relative value used by the filter.", + }, + }, + required: [ + "type", + "value", + ], + additionalProperties: false, + }, + }, + ], + description: "Literal or relative value used by the filter.", + }, + }, + required: [ + "type", + "property", + "propertyType", + "operator", + "value", + ], + additionalProperties: false, + description: "Property filter for relation properties.", + }, + { + type: "object", + properties: { + type: { + type: "string", + enum: [ + "property", + ], + description: "Selects the filter or filter-value variant.", + }, + property: { + type: "string", + description: "Exact data source property name to filter.", + }, + propertyType: { + type: "string", + enum: [ + "status", + ], + description: "Notion property type used to select valid operators and value shapes.", + }, + operator: { + type: "string", + enum: [ + "status_is", + "status_is_not", + ], + description: "Comparison or Boolean operation applied by this filter.", + }, + value: { + anyOf: [ + { + type: "object", + properties: { + type: { + type: "string", + enum: [ + "is_group", + "is_option", + ], + description: "Selects the filter or filter-value variant.", + }, + value: { + type: "string", + description: "Literal or relative value used by the filter.", + }, + }, + required: [ + "type", + "value", + ], + additionalProperties: false, + }, + { + type: "array", + items: { + type: "object", + properties: { + type: { + type: "string", + enum: [ + "is_group", + "is_option", + ], + description: "Selects the filter or filter-value variant.", + }, + value: { + type: "string", + description: "Literal or relative value used by the filter.", + }, + }, + required: [ + "type", + "value", + ], + additionalProperties: false, + }, + }, + ], + description: "Literal or relative value used by the filter.", + }, + }, + required: [ + "type", + "property", + "propertyType", + "operator", + "value", + ], + additionalProperties: false, + description: "Property filter for status properties by option name.", + }, + { + type: "object", + properties: { + type: { + type: "string", + enum: [ + "property", + ], + description: "Selects the filter or filter-value variant.", + }, + property: { + type: "string", + description: "Exact data source property name to filter.", + }, + propertyType: { + type: "string", + enum: [ + "person", + "created_by", + "last_edited_by", + ], + description: "Notion property type used to select valid operators and value shapes.", + }, + operator: { + type: "string", + enum: [ + "person_contains", + "person_does_not_contain", + ], + description: "Comparison or Boolean operation applied by this filter.", + }, + value: { + anyOf: [ + { + anyOf: [ + { + type: "object", + properties: { + type: { + type: "string", + enum: [ + "exact", + ], + description: "Selects the filter or filter-value variant.", + }, + value: { + type: "string", + description: "Literal or relative value used by the filter.", + }, + }, + required: [ + "type", + "value", + ], + additionalProperties: false, + }, + { + type: "object", + properties: { + type: { + type: "string", + enum: [ + "relative", + ], + description: "Selects the filter or filter-value variant.", + }, + value: { + type: "string", + enum: [ + "me", + ], + description: "Literal or relative value used by the filter.", + }, + }, + required: [ + "type", + "value", + ], + additionalProperties: false, + }, + ], + }, + { + type: "array", + items: { + anyOf: [ + { + type: "object", + properties: { + type: { + type: "string", + enum: [ + "exact", + ], + description: "Selects the filter or filter-value variant.", + }, + value: { + type: "string", + description: "Literal or relative value used by the filter.", + }, + }, + required: [ + "type", + "value", + ], + additionalProperties: false, + }, + { + type: "object", + properties: { + type: { + type: "string", + enum: [ + "relative", + ], + description: "Selects the filter or filter-value variant.", + }, + value: { + type: "string", + enum: [ + "me", + ], + description: "Literal or relative value used by the filter.", + }, + }, + required: [ + "type", + "value", + ], + additionalProperties: false, + }, + ], + }, + }, + ], + description: "Literal or relative value used by the filter.", + }, + }, + required: [ + "type", + "property", + "propertyType", + "operator", + "value", + ], + additionalProperties: false, + description: "Property filter for person-like properties. Exact values use user://, bot://, organization_bot://, or space_permission_group:// URIs; relative values use me.", + }, + { + type: "object", + properties: { + type: { + type: "string", + enum: [ + "property", + ], + description: "Selects the filter or filter-value variant.", + }, + property: { + type: "string", + description: "Exact data source property name to filter.", + }, + propertyType: { + type: "string", + enum: [ + "verification", + ], + description: "Notion property type used to select valid operators and value shapes.", + }, + operator: { + type: "string", + enum: [ + "verification_is", + "verification_is_not", + ], + description: "Comparison or Boolean operation applied by this filter.", + }, + value: { + anyOf: [ + { + type: "object", + properties: { + type: { + type: "string", + enum: [ + "exact", + ], + description: "Selects the filter or filter-value variant.", + }, + value: { + type: "string", + enum: [ + "verified", + "expired", + "none", + ], + description: "Literal or relative value used by the filter.", + }, + }, + required: [ + "type", + "value", + ], + additionalProperties: false, + }, + { + type: "array", + items: { + type: "object", + properties: { + type: { + type: "string", + enum: [ + "exact", + ], + description: "Selects the filter or filter-value variant.", + }, + value: { + type: "string", + enum: [ + "verified", + "expired", + "none", + ], + description: "Literal or relative value used by the filter.", + }, + }, + required: [ + "type", + "value", + ], + additionalProperties: false, + }, + }, + ], + description: "Literal or relative value used by the filter.", + }, + }, + required: [ + "type", + "property", + "propertyType", + "operator", + "value", + ], + additionalProperties: false, + description: "Property filter for page verification state.", + }, + { + type: "object", + properties: { + type: { + type: "string", + enum: [ + "property", + ], + description: "Selects the filter or filter-value variant.", + }, + property: { + type: "string", + description: "Exact data source property name to filter.", + }, + propertyType: { + type: "string", + enum: [ + "formula", + ], + description: "Notion property type used to select valid operators and value shapes.", + }, + operator: { + description: "Comparison or Boolean operation applied by this filter.", + type: "string", + enum: [ + "any", + "none", + "every", + ], + }, + resultFilter: { + anyOf: [ + { + type: "object", + properties: { + type: { + type: "string", + enum: [ + "property", + ], + description: "Selects the filter or filter-value variant.", + }, + property: { + type: "string", + description: "Exact data source property name to filter.", + }, + propertyType: { + type: "string", + description: "Notion property type used to select valid operators and value shapes.", + }, + operator: { + type: "string", + enum: [ + "is_empty", + "is_not_empty", + ], + description: "Comparison or Boolean operation applied by this filter.", + }, + }, + required: [ + "type", + "property", + "propertyType", + "operator", + ], + additionalProperties: false, + description: "Checks whether a property has any value.", + }, + { + type: "object", + properties: { + type: { + type: "string", + enum: [ + "property", + ], + description: "Selects the filter or filter-value variant.", + }, + property: { + type: "string", + description: "Exact data source property name to filter.", + }, + propertyType: { + type: "string", + enum: [ + "title", + "text", + "url", + "email", + "phone_number", + ], + description: "Notion property type used to select valid operators and value shapes.", + }, + operator: { + type: "string", + enum: [ + "string_is", + "string_is_not", + "string_contains", + "string_does_not_contain", + "string_starts_with", + "string_ends_with", + ], + description: "Comparison or Boolean operation applied by this filter.", + }, + value: { + type: "object", + properties: { + type: { + type: "string", + enum: [ + "exact", + ], + description: "Selects the filter or filter-value variant.", + }, + value: { + type: "string", + description: "Literal or relative value used by the filter.", + }, + }, + required: [ + "type", + "value", + ], + additionalProperties: false, + description: "Literal or relative value used by the filter.", + }, + }, + required: [ + "type", + "property", + "propertyType", + "operator", + "value", + ], + additionalProperties: false, + description: "Property filter for text-like properties.", + }, + { + type: "object", + properties: { + type: { + type: "string", + enum: [ + "property", + ], + description: "Selects the filter or filter-value variant.", + }, + property: { + type: "string", + description: "Exact data source property name to filter.", + }, + propertyType: { + type: "string", + enum: [ + "number", + "auto_increment_id", + ], + description: "Notion property type used to select valid operators and value shapes.", + }, + operator: { + type: "string", + enum: [ + "number_equals", + "number_does_not_equal", + "number_greater_than", + "number_less_than", + "number_greater_than_or_equal_to", + "number_less_than_or_equal_to", + ], + description: "Comparison or Boolean operation applied by this filter.", + }, + value: { + type: "object", + properties: { + type: { + type: "string", + enum: [ + "exact", + ], + description: "Selects the filter or filter-value variant.", + }, + value: { + type: "number", + description: "Literal or relative value used by the filter.", + }, + }, + required: [ + "type", + "value", + ], + additionalProperties: false, + description: "Literal or relative value used by the filter.", + }, + }, + required: [ + "type", + "property", + "propertyType", + "operator", + "value", + ], + additionalProperties: false, + description: "Property filter for number properties.", + }, + { + anyOf: [ + { + type: "object", + properties: { + type: { + type: "string", + enum: [ + "property", + ], + description: "Selects the filter or filter-value variant.", + }, + property: { + type: "string", + description: "Exact data source property name to filter.", + }, + propertyType: { + type: "string", + enum: [ + "date", + "created_time", + "last_edited_time", + "last_visited_time", + ], + description: "Notion property type used to select valid operators and value shapes.", + }, + operator: { + type: "string", + enum: [ + "date_is", + "date_is_before", + "date_is_after", + "date_is_on_or_before", + "date_is_on_or_after", + ], + description: "Comparison or Boolean operation applied by this filter.", + }, + value: { + anyOf: [ + { + type: "object", + properties: { + type: { + type: "string", + enum: [ + "exact", + ], + description: "Selects the filter or filter-value variant.", + }, + value: { + type: "string", + description: "Literal or relative value used by the filter.", + }, + }, + required: [ + "type", + "value", + ], + additionalProperties: false, + }, + { + type: "object", + properties: { + type: { + type: "string", + enum: [ + "relative", + ], + description: "Selects the filter or filter-value variant.", + }, + value: { + type: "string", + enum: [ + "today", + "tomorrow", + "yesterday", + "one_week_ago", + "one_week_from_now", + "one_month_ago", + "one_month_from_now", + ], + description: "Literal or relative value used by the filter.", + }, + }, + required: [ + "type", + "value", + ], + additionalProperties: false, + }, + ], + description: "Literal or relative value used by the filter.", + }, + use_end: { + description: "For a date property, compare its end date instead of its start date.", + type: "boolean", + }, + }, + required: [ + "type", + "property", + "propertyType", + "operator", + "value", + ], + additionalProperties: false, + }, + { + type: "object", + properties: { + type: { + type: "string", + enum: [ + "property", + ], + description: "Selects the filter or filter-value variant.", + }, + property: { + type: "string", + description: "Exact data source property name to filter.", + }, + propertyType: { + type: "string", + enum: [ + "date", + "created_time", + "last_edited_time", + "last_visited_time", + ], + description: "Notion property type used to select valid operators and value shapes.", + }, + operator: { + type: "string", + enum: [ + "date_is_within", + "date_is_relative_to", + ], + description: "Comparison or Boolean operation applied by this filter.", + }, + value: { + anyOf: [ + { + type: "object", + properties: { + type: { + type: "string", + enum: [ + "exact", + ], + description: "Selects the filter or filter-value variant.", + }, + value: { + type: "object", + properties: { + type: { + type: "string", + enum: [ + "daterange", + ], + description: "Selects the filter or filter-value variant.", + }, + start_date: { + description: "ISO 8601 date or date-time at the start of the range.", + type: "string", + }, + end_date: { + description: "ISO 8601 date or date-time at the end of the range.", + type: "string", + }, + }, + required: [ + "type", + ], + additionalProperties: false, + description: "Literal or relative value used by the filter.", + }, + }, + required: [ + "type", + "value", + ], + additionalProperties: false, + }, + { + type: "object", + properties: { + type: { + type: "string", + enum: [ + "relative", + ], + description: "Selects the filter or filter-value variant.", + }, + value: { + type: "string", + enum: [ + "custom", + ], + description: "Literal or relative value used by the filter.", + }, + direction: { + type: "string", + enum: [ + "past", + "future", + ], + description: "Whether the custom range extends into the past or future.", + }, + unit: { + type: "string", + enum: [ + "year", + "month", + "week", + "day", + ], + description: "Time unit used to measure a relative date range.", + }, + count: { + type: "number", + description: "Number of units in the custom relative range.", + }, + }, + required: [ + "type", + "value", + "direction", + "unit", + "count", + ], + additionalProperties: false, + }, + { + type: "object", + properties: { + type: { + type: "string", + enum: [ + "relative", + ], + description: "Selects the filter or filter-value variant.", + }, + value: { + type: "string", + enum: [ + "surrounding", + ], + description: "Literal or relative value used by the filter.", + }, + unit: { + type: "string", + enum: [ + "year", + "month", + "week", + "day", + ], + description: "Time unit used to measure a relative date range.", + }, + }, + required: [ + "type", + "value", + "unit", + ], + additionalProperties: false, + }, + { + type: "object", + properties: { + type: { + type: "string", + enum: [ + "relative", + ], + description: "Selects the filter or filter-value variant.", + }, + value: { + type: "string", + enum: [ + "this_week", + "the_past_week", + "the_past_month", + "the_past_year", + "the_next_week", + "the_next_month", + "the_next_year", + ], + description: "Literal or relative value used by the filter.", + }, + }, + required: [ + "type", + "value", + ], + additionalProperties: false, + }, + ], + description: "Literal or relative value used by the filter.", + }, + use_end: { + description: "For a date property, compare its end date instead of its start date.", + type: "boolean", + }, + }, + required: [ + "type", + "property", + "propertyType", + "operator", + "value", + ], + additionalProperties: false, + }, + ], + description: "Property filter for date properties.", + }, + { + type: "object", + properties: { + type: { + type: "string", + enum: [ + "property", + ], + description: "Selects the filter or filter-value variant.", + }, + property: { + type: "string", + description: "Exact data source property name to filter.", + }, + propertyType: { + type: "string", + enum: [ + "select", + ], + description: "Notion property type used to select valid operators and value shapes.", + }, + operator: { + type: "string", + enum: [ + "enum_is", + "enum_is_not", + ], + description: "Comparison or Boolean operation applied by this filter.", + }, + value: { + anyOf: [ + { + type: "object", + properties: { + type: { + type: "string", + enum: [ + "exact", + ], + description: "Selects the filter or filter-value variant.", + }, + value: { + type: "string", + description: "Literal or relative value used by the filter.", + }, + }, + required: [ + "type", + "value", + ], + additionalProperties: false, + }, + { + type: "array", + items: { + type: "object", + properties: { + type: { + type: "string", + enum: [ + "exact", + ], + description: "Selects the filter or filter-value variant.", + }, + value: { + type: "string", + description: "Literal or relative value used by the filter.", + }, + }, + required: [ + "type", + "value", + ], + additionalProperties: false, + }, + }, + ], + description: "Literal or relative value used by the filter.", + }, + }, + required: [ + "type", + "property", + "propertyType", + "operator", + "value", + ], + additionalProperties: false, + description: "Property filter for select properties by option name.", + }, + { + type: "object", + properties: { + type: { + type: "string", + enum: [ + "property", + ], + description: "Selects the filter or filter-value variant.", + }, + property: { + type: "string", + description: "Exact data source property name to filter.", + }, + propertyType: { + type: "string", + enum: [ + "multi_select", + ], + description: "Notion property type used to select valid operators and value shapes.", + }, + operator: { + type: "string", + enum: [ + "enum_contains", + "enum_does_not_contain", + ], + description: "Comparison or Boolean operation applied by this filter.", + }, + value: { + anyOf: [ + { + type: "object", + properties: { + type: { + type: "string", + enum: [ + "exact", + ], + description: "Selects the filter or filter-value variant.", + }, + value: { + type: "string", + description: "Literal or relative value used by the filter.", + }, + }, + required: [ + "type", + "value", + ], + additionalProperties: false, + }, + { + type: "array", + items: { + type: "object", + properties: { + type: { + type: "string", + enum: [ + "exact", + ], + description: "Selects the filter or filter-value variant.", + }, + value: { + type: "string", + description: "Literal or relative value used by the filter.", + }, + }, + required: [ + "type", + "value", + ], + additionalProperties: false, + }, + }, + ], + description: "Literal or relative value used by the filter.", + }, + }, + required: [ + "type", + "property", + "propertyType", + "operator", + "value", + ], + additionalProperties: false, + description: "Property filter for multi-select properties.", + }, + { + type: "object", + properties: { + type: { + type: "string", + enum: [ + "property", + ], + description: "Selects the filter or filter-value variant.", + }, + property: { + type: "string", + description: "Exact data source property name to filter.", + }, + propertyType: { + type: "string", + enum: [ + "checkbox", + ], + description: "Notion property type used to select valid operators and value shapes.", + }, + operator: { + type: "string", + enum: [ + "checkbox_is", + "checkbox_is_not", + ], + description: "Comparison or Boolean operation applied by this filter.", + }, + value: { + type: "object", + properties: { + type: { + type: "string", + enum: [ + "exact", + ], + description: "Selects the filter or filter-value variant.", + }, + value: { + type: "boolean", + description: "Literal or relative value used by the filter.", + }, + }, + required: [ + "type", + "value", + ], + additionalProperties: false, + description: "Literal or relative value used by the filter.", + }, + }, + required: [ + "type", + "property", + "propertyType", + "operator", + "value", + ], + additionalProperties: false, + description: "Property filter for checkbox properties.", + }, + { + type: "object", + properties: { + type: { + type: "string", + enum: [ + "property", + ], + description: "Selects the filter or filter-value variant.", + }, + property: { + type: "string", + description: "Exact data source property name to filter.", + }, + propertyType: { + type: "string", + enum: [ + "relation", + ], + description: "Notion property type used to select valid operators and value shapes.", + }, + operator: { + type: "string", + enum: [ + "relation_contains", + "relation_does_not_contain", + ], + description: "Comparison or Boolean operation applied by this filter.", + }, + value: { + anyOf: [ + { + type: "object", + properties: { + type: { + type: "string", + enum: [ + "exact", + ], + description: "Selects the filter or filter-value variant.", + }, + value: { + type: "string", + description: "Literal or relative value used by the filter.", + }, + }, + required: [ + "type", + "value", + ], + additionalProperties: false, + }, + { + type: "array", + items: { + type: "object", + properties: { + type: { + type: "string", + enum: [ + "exact", + ], + description: "Selects the filter or filter-value variant.", + }, + value: { + type: "string", + description: "Literal or relative value used by the filter.", + }, + }, + required: [ + "type", + "value", + ], + additionalProperties: false, + }, + }, + ], + description: "Literal or relative value used by the filter.", + }, + }, + required: [ + "type", + "property", + "propertyType", + "operator", + "value", + ], + additionalProperties: false, + description: "Property filter for relation properties.", + }, + { + type: "object", + properties: { + type: { + type: "string", + enum: [ + "property", + ], + description: "Selects the filter or filter-value variant.", + }, + property: { + type: "string", + description: "Exact data source property name to filter.", + }, + propertyType: { + type: "string", + enum: [ + "status", + ], + description: "Notion property type used to select valid operators and value shapes.", + }, + operator: { + type: "string", + enum: [ + "status_is", + "status_is_not", + ], + description: "Comparison or Boolean operation applied by this filter.", + }, + value: { + anyOf: [ + { + type: "object", + properties: { + type: { + type: "string", + enum: [ + "is_group", + "is_option", + ], + description: "Selects the filter or filter-value variant.", + }, + value: { + type: "string", + description: "Literal or relative value used by the filter.", + }, + }, + required: [ + "type", + "value", + ], + additionalProperties: false, + }, + { + type: "array", + items: { + type: "object", + properties: { + type: { + type: "string", + enum: [ + "is_group", + "is_option", + ], + description: "Selects the filter or filter-value variant.", + }, + value: { + type: "string", + description: "Literal or relative value used by the filter.", + }, + }, + required: [ + "type", + "value", + ], + additionalProperties: false, + }, + }, + ], + description: "Literal or relative value used by the filter.", + }, + }, + required: [ + "type", + "property", + "propertyType", + "operator", + "value", + ], + additionalProperties: false, + description: "Property filter for status properties by option name.", + }, + { + type: "object", + properties: { + type: { + type: "string", + enum: [ + "property", + ], + description: "Selects the filter or filter-value variant.", + }, + property: { + type: "string", + description: "Exact data source property name to filter.", + }, + propertyType: { + type: "string", + enum: [ + "person", + "created_by", + "last_edited_by", + ], + description: "Notion property type used to select valid operators and value shapes.", + }, + operator: { + type: "string", + enum: [ + "person_contains", + "person_does_not_contain", + ], + description: "Comparison or Boolean operation applied by this filter.", + }, + value: { + anyOf: [ + { + anyOf: [ + { + type: "object", + properties: { + type: { + type: "string", + enum: [ + "exact", + ], + description: "Selects the filter or filter-value variant.", + }, + value: { + type: "string", + description: "Literal or relative value used by the filter.", + }, + }, + required: [ + "type", + "value", + ], + additionalProperties: false, + }, + { + type: "object", + properties: { + type: { + type: "string", + enum: [ + "relative", + ], + description: "Selects the filter or filter-value variant.", + }, + value: { + type: "string", + enum: [ + "me", + ], + description: "Literal or relative value used by the filter.", + }, + }, + required: [ + "type", + "value", + ], + additionalProperties: false, + }, + ], + }, + { + type: "array", + items: { + anyOf: [ + { + type: "object", + properties: { + type: { + type: "string", + enum: [ + "exact", + ], + description: "Selects the filter or filter-value variant.", + }, + value: { + type: "string", + description: "Literal or relative value used by the filter.", + }, + }, + required: [ + "type", + "value", + ], + additionalProperties: false, + }, + { + type: "object", + properties: { + type: { + type: "string", + enum: [ + "relative", + ], + description: "Selects the filter or filter-value variant.", + }, + value: { + type: "string", + enum: [ + "me", + ], + description: "Literal or relative value used by the filter.", + }, + }, + required: [ + "type", + "value", + ], + additionalProperties: false, + }, + ], + }, + }, + ], + description: "Literal or relative value used by the filter.", + }, + }, + required: [ + "type", + "property", + "propertyType", + "operator", + "value", + ], + additionalProperties: false, + description: "Property filter for person-like properties. Exact values use user://, bot://, organization_bot://, or space_permission_group:// URIs; relative values use me.", + }, + { + type: "object", + properties: { + type: { + type: "string", + enum: [ + "property", + ], + description: "Selects the filter or filter-value variant.", + }, + property: { + type: "string", + description: "Exact data source property name to filter.", + }, + propertyType: { + type: "string", + enum: [ + "verification", + ], + description: "Notion property type used to select valid operators and value shapes.", + }, + operator: { + type: "string", + enum: [ + "verification_is", + "verification_is_not", + ], + description: "Comparison or Boolean operation applied by this filter.", + }, + value: { + anyOf: [ + { + type: "object", + properties: { + type: { + type: "string", + enum: [ + "exact", + ], + description: "Selects the filter or filter-value variant.", + }, + value: { + type: "string", + enum: [ + "verified", + "expired", + "none", + ], + description: "Literal or relative value used by the filter.", + }, + }, + required: [ + "type", + "value", + ], + additionalProperties: false, + }, + { + type: "array", + items: { + type: "object", + properties: { + type: { + type: "string", + enum: [ + "exact", + ], + description: "Selects the filter or filter-value variant.", + }, + value: { + type: "string", + enum: [ + "verified", + "expired", + "none", + ], + description: "Literal or relative value used by the filter.", + }, + }, + required: [ + "type", + "value", + ], + additionalProperties: false, + }, + }, + ], + description: "Literal or relative value used by the filter.", + }, + }, + required: [ + "type", + "property", + "propertyType", + "operator", + "value", + ], + additionalProperties: false, + description: "Property filter for page verification state.", + }, + ], + description: "Filter on the formula's result. The propertyType in the resultFilter should be the resultType of the formula.", + }, + }, + required: [ + "type", + "property", + "propertyType", + "resultFilter", + ], + additionalProperties: false, + description: "Filter applied to a formula property.", + }, + ], + description: "Filter applied to a single property.", + }, + { + type: "object", + properties: { + type: { + type: "string", + enum: [ + "group", + ], + description: "Selects the filter or filter-value variant.", + }, + operator: { + type: "string", + enum: [ + "and", + "or", + ], + description: "Comparison or Boolean operation applied by this filter.", + }, + filters: { + maxItems: 100, + type: "array", + items: { + anyOf: [ + { + type: "object", + properties: { + type: { + type: "string", + enum: [ + "property", + ], + description: "Selects the filter or filter-value variant.", + }, + property: { + type: "string", + description: "Exact data source property name to filter.", + }, + propertyType: { + type: "string", + description: "Notion property type used to select valid operators and value shapes.", + }, + operator: { + type: "string", + enum: [ + "is_empty", + "is_not_empty", + ], + description: "Comparison or Boolean operation applied by this filter.", + }, + }, + required: [ + "type", + "property", + "propertyType", + "operator", + ], + additionalProperties: false, + description: "Checks whether a property has any value.", + }, + { + type: "object", + properties: { + type: { + type: "string", + enum: [ + "property", + ], + description: "Selects the filter or filter-value variant.", + }, + property: { + type: "string", + description: "Exact data source property name to filter.", + }, + propertyType: { + type: "string", + enum: [ + "title", + "text", + "url", + "email", + "phone_number", + ], + description: "Notion property type used to select valid operators and value shapes.", + }, + operator: { + type: "string", + enum: [ + "string_is", + "string_is_not", + "string_contains", + "string_does_not_contain", + "string_starts_with", + "string_ends_with", + ], + description: "Comparison or Boolean operation applied by this filter.", + }, + value: { + type: "object", + properties: { + type: { + type: "string", + enum: [ + "exact", + ], + description: "Selects the filter or filter-value variant.", + }, + value: { + type: "string", + description: "Literal or relative value used by the filter.", + }, + }, + required: [ + "type", + "value", + ], + additionalProperties: false, + description: "Literal or relative value used by the filter.", + }, + }, + required: [ + "type", + "property", + "propertyType", + "operator", + "value", + ], + additionalProperties: false, + description: "Property filter for text-like properties.", + }, + { + type: "object", + properties: { + type: { + type: "string", + enum: [ + "property", + ], + description: "Selects the filter or filter-value variant.", + }, + property: { + type: "string", + description: "Exact data source property name to filter.", + }, + propertyType: { + type: "string", + enum: [ + "number", + "auto_increment_id", + ], + description: "Notion property type used to select valid operators and value shapes.", + }, + operator: { + type: "string", + enum: [ + "number_equals", + "number_does_not_equal", + "number_greater_than", + "number_less_than", + "number_greater_than_or_equal_to", + "number_less_than_or_equal_to", + ], + description: "Comparison or Boolean operation applied by this filter.", + }, + value: { + type: "object", + properties: { + type: { + type: "string", + enum: [ + "exact", + ], + description: "Selects the filter or filter-value variant.", + }, + value: { + type: "number", + description: "Literal or relative value used by the filter.", + }, + }, + required: [ + "type", + "value", + ], + additionalProperties: false, + description: "Literal or relative value used by the filter.", + }, + }, + required: [ + "type", + "property", + "propertyType", + "operator", + "value", + ], + additionalProperties: false, + description: "Property filter for number properties.", + }, + { + anyOf: [ + { + type: "object", + properties: { + type: { + type: "string", + enum: [ + "property", + ], + description: "Selects the filter or filter-value variant.", + }, + property: { + type: "string", + description: "Exact data source property name to filter.", + }, + propertyType: { + type: "string", + enum: [ + "date", + "created_time", + "last_edited_time", + "last_visited_time", + ], + description: "Notion property type used to select valid operators and value shapes.", + }, + operator: { + type: "string", + enum: [ + "date_is", + "date_is_before", + "date_is_after", + "date_is_on_or_before", + "date_is_on_or_after", + ], + description: "Comparison or Boolean operation applied by this filter.", + }, + value: { + anyOf: [ + { + type: "object", + properties: { + type: { + type: "string", + enum: [ + "exact", + ], + description: "Selects the filter or filter-value variant.", + }, + value: { + type: "string", + description: "Literal or relative value used by the filter.", + }, + }, + required: [ + "type", + "value", + ], + additionalProperties: false, + }, + { + type: "object", + properties: { + type: { + type: "string", + enum: [ + "relative", + ], + description: "Selects the filter or filter-value variant.", + }, + value: { + type: "string", + enum: [ + "today", + "tomorrow", + "yesterday", + "one_week_ago", + "one_week_from_now", + "one_month_ago", + "one_month_from_now", + ], + description: "Literal or relative value used by the filter.", + }, + }, + required: [ + "type", + "value", + ], + additionalProperties: false, + }, + ], + description: "Literal or relative value used by the filter.", + }, + use_end: { + description: "For a date property, compare its end date instead of its start date.", + type: "boolean", + }, + }, + required: [ + "type", + "property", + "propertyType", + "operator", + "value", + ], + additionalProperties: false, + }, + { + type: "object", + properties: { + type: { + type: "string", + enum: [ + "property", + ], + description: "Selects the filter or filter-value variant.", + }, + property: { + type: "string", + description: "Exact data source property name to filter.", + }, + propertyType: { + type: "string", + enum: [ + "date", + "created_time", + "last_edited_time", + "last_visited_time", + ], + description: "Notion property type used to select valid operators and value shapes.", + }, + operator: { + type: "string", + enum: [ + "date_is_within", + "date_is_relative_to", + ], + description: "Comparison or Boolean operation applied by this filter.", + }, + value: { + anyOf: [ + { + type: "object", + properties: { + type: { + type: "string", + enum: [ + "exact", + ], + description: "Selects the filter or filter-value variant.", + }, + value: { + type: "object", + properties: { + type: { + type: "string", + enum: [ + "daterange", + ], + description: "Selects the filter or filter-value variant.", + }, + start_date: { + description: "ISO 8601 date or date-time at the start of the range.", + type: "string", + }, + end_date: { + description: "ISO 8601 date or date-time at the end of the range.", + type: "string", + }, + }, + required: [ + "type", + ], + additionalProperties: false, + description: "Literal or relative value used by the filter.", + }, + }, + required: [ + "type", + "value", + ], + additionalProperties: false, + }, + { + type: "object", + properties: { + type: { + type: "string", + enum: [ + "relative", + ], + description: "Selects the filter or filter-value variant.", + }, + value: { + type: "string", + enum: [ + "custom", + ], + description: "Literal or relative value used by the filter.", + }, + direction: { + type: "string", + enum: [ + "past", + "future", + ], + description: "Whether the custom range extends into the past or future.", + }, + unit: { + type: "string", + enum: [ + "year", + "month", + "week", + "day", + ], + description: "Time unit used to measure a relative date range.", + }, + count: { + type: "number", + description: "Number of units in the custom relative range.", + }, + }, + required: [ + "type", + "value", + "direction", + "unit", + "count", + ], + additionalProperties: false, + }, + { + type: "object", + properties: { + type: { + type: "string", + enum: [ + "relative", + ], + description: "Selects the filter or filter-value variant.", + }, + value: { + type: "string", + enum: [ + "surrounding", + ], + description: "Literal or relative value used by the filter.", + }, + unit: { + type: "string", + enum: [ + "year", + "month", + "week", + "day", + ], + description: "Time unit used to measure a relative date range.", + }, + }, + required: [ + "type", + "value", + "unit", + ], + additionalProperties: false, + }, + { + type: "object", + properties: { + type: { + type: "string", + enum: [ + "relative", + ], + description: "Selects the filter or filter-value variant.", + }, + value: { + type: "string", + enum: [ + "this_week", + "the_past_week", + "the_past_month", + "the_past_year", + "the_next_week", + "the_next_month", + "the_next_year", + ], + description: "Literal or relative value used by the filter.", + }, + }, + required: [ + "type", + "value", + ], + additionalProperties: false, + }, + ], + description: "Literal or relative value used by the filter.", + }, + use_end: { + description: "For a date property, compare its end date instead of its start date.", + type: "boolean", + }, + }, + required: [ + "type", + "property", + "propertyType", + "operator", + "value", + ], + additionalProperties: false, + }, + ], + description: "Property filter for date properties.", + }, + { + type: "object", + properties: { + type: { + type: "string", + enum: [ + "property", + ], + description: "Selects the filter or filter-value variant.", + }, + property: { + type: "string", + description: "Exact data source property name to filter.", + }, + propertyType: { + type: "string", + enum: [ + "select", + ], + description: "Notion property type used to select valid operators and value shapes.", + }, + operator: { + type: "string", + enum: [ + "enum_is", + "enum_is_not", + ], + description: "Comparison or Boolean operation applied by this filter.", + }, + value: { + anyOf: [ + { + type: "object", + properties: { + type: { + type: "string", + enum: [ + "exact", + ], + description: "Selects the filter or filter-value variant.", + }, + value: { + type: "string", + description: "Literal or relative value used by the filter.", + }, + }, + required: [ + "type", + "value", + ], + additionalProperties: false, + }, + { + type: "array", + items: { + type: "object", + properties: { + type: { + type: "string", + enum: [ + "exact", + ], + description: "Selects the filter or filter-value variant.", + }, + value: { + type: "string", + description: "Literal or relative value used by the filter.", + }, + }, + required: [ + "type", + "value", + ], + additionalProperties: false, + }, + }, + ], + description: "Literal or relative value used by the filter.", + }, + }, + required: [ + "type", + "property", + "propertyType", + "operator", + "value", + ], + additionalProperties: false, + description: "Property filter for select properties by option name.", + }, + { + type: "object", + properties: { + type: { + type: "string", + enum: [ + "property", + ], + description: "Selects the filter or filter-value variant.", + }, + property: { + type: "string", + description: "Exact data source property name to filter.", + }, + propertyType: { + type: "string", + enum: [ + "multi_select", + ], + description: "Notion property type used to select valid operators and value shapes.", + }, + operator: { + type: "string", + enum: [ + "enum_contains", + "enum_does_not_contain", + ], + description: "Comparison or Boolean operation applied by this filter.", + }, + value: { + anyOf: [ + { + type: "object", + properties: { + type: { + type: "string", + enum: [ + "exact", + ], + description: "Selects the filter or filter-value variant.", + }, + value: { + type: "string", + description: "Literal or relative value used by the filter.", + }, + }, + required: [ + "type", + "value", + ], + additionalProperties: false, + }, + { + type: "array", + items: { + type: "object", + properties: { + type: { + type: "string", + enum: [ + "exact", + ], + description: "Selects the filter or filter-value variant.", + }, + value: { + type: "string", + description: "Literal or relative value used by the filter.", + }, + }, + required: [ + "type", + "value", + ], + additionalProperties: false, + }, + }, + ], + description: "Literal or relative value used by the filter.", + }, + }, + required: [ + "type", + "property", + "propertyType", + "operator", + "value", + ], + additionalProperties: false, + description: "Property filter for multi-select properties.", + }, + { + type: "object", + properties: { + type: { + type: "string", + enum: [ + "property", + ], + description: "Selects the filter or filter-value variant.", + }, + property: { + type: "string", + description: "Exact data source property name to filter.", + }, + propertyType: { + type: "string", + enum: [ + "checkbox", + ], + description: "Notion property type used to select valid operators and value shapes.", + }, + operator: { + type: "string", + enum: [ + "checkbox_is", + "checkbox_is_not", + ], + description: "Comparison or Boolean operation applied by this filter.", + }, + value: { + type: "object", + properties: { + type: { + type: "string", + enum: [ + "exact", + ], + description: "Selects the filter or filter-value variant.", + }, + value: { + type: "boolean", + description: "Literal or relative value used by the filter.", + }, + }, + required: [ + "type", + "value", + ], + additionalProperties: false, + description: "Literal or relative value used by the filter.", + }, + }, + required: [ + "type", + "property", + "propertyType", + "operator", + "value", + ], + additionalProperties: false, + description: "Property filter for checkbox properties.", + }, + { + type: "object", + properties: { + type: { + type: "string", + enum: [ + "property", + ], + description: "Selects the filter or filter-value variant.", + }, + property: { + type: "string", + description: "Exact data source property name to filter.", + }, + propertyType: { + type: "string", + enum: [ + "relation", + ], + description: "Notion property type used to select valid operators and value shapes.", + }, + operator: { + type: "string", + enum: [ + "relation_contains", + "relation_does_not_contain", + ], + description: "Comparison or Boolean operation applied by this filter.", + }, + value: { + anyOf: [ + { + type: "object", + properties: { + type: { + type: "string", + enum: [ + "exact", + ], + description: "Selects the filter or filter-value variant.", + }, + value: { + type: "string", + description: "Literal or relative value used by the filter.", + }, + }, + required: [ + "type", + "value", + ], + additionalProperties: false, + }, + { + type: "array", + items: { + type: "object", + properties: { + type: { + type: "string", + enum: [ + "exact", + ], + description: "Selects the filter or filter-value variant.", + }, + value: { + type: "string", + description: "Literal or relative value used by the filter.", + }, + }, + required: [ + "type", + "value", + ], + additionalProperties: false, + }, + }, + ], + description: "Literal or relative value used by the filter.", + }, + }, + required: [ + "type", + "property", + "propertyType", + "operator", + "value", + ], + additionalProperties: false, + description: "Property filter for relation properties.", + }, + { + type: "object", + properties: { + type: { + type: "string", + enum: [ + "property", + ], + description: "Selects the filter or filter-value variant.", + }, + property: { + type: "string", + description: "Exact data source property name to filter.", + }, + propertyType: { + type: "string", + enum: [ + "status", + ], + description: "Notion property type used to select valid operators and value shapes.", + }, + operator: { + type: "string", + enum: [ + "status_is", + "status_is_not", + ], + description: "Comparison or Boolean operation applied by this filter.", + }, + value: { + anyOf: [ + { + type: "object", + properties: { + type: { + type: "string", + enum: [ + "is_group", + "is_option", + ], + description: "Selects the filter or filter-value variant.", + }, + value: { + type: "string", + description: "Literal or relative value used by the filter.", + }, + }, + required: [ + "type", + "value", + ], + additionalProperties: false, + }, + { + type: "array", + items: { + type: "object", + properties: { + type: { + type: "string", + enum: [ + "is_group", + "is_option", + ], + description: "Selects the filter or filter-value variant.", + }, + value: { + type: "string", + description: "Literal or relative value used by the filter.", + }, + }, + required: [ + "type", + "value", + ], + additionalProperties: false, + }, + }, + ], + description: "Literal or relative value used by the filter.", + }, + }, + required: [ + "type", + "property", + "propertyType", + "operator", + "value", + ], + additionalProperties: false, + description: "Property filter for status properties by option name.", + }, + { + type: "object", + properties: { + type: { + type: "string", + enum: [ + "property", + ], + description: "Selects the filter or filter-value variant.", + }, + property: { + type: "string", + description: "Exact data source property name to filter.", + }, + propertyType: { + type: "string", + enum: [ + "person", + "created_by", + "last_edited_by", + ], + description: "Notion property type used to select valid operators and value shapes.", + }, + operator: { + type: "string", + enum: [ + "person_contains", + "person_does_not_contain", + ], + description: "Comparison or Boolean operation applied by this filter.", + }, + value: { + anyOf: [ + { + anyOf: [ + { + type: "object", + properties: { + type: { + type: "string", + enum: [ + "exact", + ], + description: "Selects the filter or filter-value variant.", + }, + value: { + type: "string", + description: "Literal or relative value used by the filter.", + }, + }, + required: [ + "type", + "value", + ], + additionalProperties: false, + }, + { + type: "object", + properties: { + type: { + type: "string", + enum: [ + "relative", + ], + description: "Selects the filter or filter-value variant.", + }, + value: { + type: "string", + enum: [ + "me", + ], + description: "Literal or relative value used by the filter.", + }, + }, + required: [ + "type", + "value", + ], + additionalProperties: false, + }, + ], + }, + { + type: "array", + items: { + anyOf: [ + { + type: "object", + properties: { + type: { + type: "string", + enum: [ + "exact", + ], + description: "Selects the filter or filter-value variant.", + }, + value: { + type: "string", + description: "Literal or relative value used by the filter.", + }, + }, + required: [ + "type", + "value", + ], + additionalProperties: false, + }, + { + type: "object", + properties: { + type: { + type: "string", + enum: [ + "relative", + ], + description: "Selects the filter or filter-value variant.", + }, + value: { + type: "string", + enum: [ + "me", + ], + description: "Literal or relative value used by the filter.", + }, + }, + required: [ + "type", + "value", + ], + additionalProperties: false, + }, + ], + }, + }, + ], + description: "Literal or relative value used by the filter.", + }, + }, + required: [ + "type", + "property", + "propertyType", + "operator", + "value", + ], + additionalProperties: false, + description: "Property filter for person-like properties. Exact values use user://, bot://, organization_bot://, or space_permission_group:// URIs; relative values use me.", + }, + { + type: "object", + properties: { + type: { + type: "string", + enum: [ + "property", + ], + description: "Selects the filter or filter-value variant.", + }, + property: { + type: "string", + description: "Exact data source property name to filter.", + }, + propertyType: { + type: "string", + enum: [ + "verification", + ], + description: "Notion property type used to select valid operators and value shapes.", + }, + operator: { + type: "string", + enum: [ + "verification_is", + "verification_is_not", + ], + description: "Comparison or Boolean operation applied by this filter.", + }, + value: { + anyOf: [ + { + type: "object", + properties: { + type: { + type: "string", + enum: [ + "exact", + ], + description: "Selects the filter or filter-value variant.", + }, + value: { + type: "string", + enum: [ + "verified", + "expired", + "none", + ], + description: "Literal or relative value used by the filter.", + }, + }, + required: [ + "type", + "value", + ], + additionalProperties: false, + }, + { + type: "array", + items: { + type: "object", + properties: { + type: { + type: "string", + enum: [ + "exact", + ], + description: "Selects the filter or filter-value variant.", + }, + value: { + type: "string", + enum: [ + "verified", + "expired", + "none", + ], + description: "Literal or relative value used by the filter.", + }, + }, + required: [ + "type", + "value", + ], + additionalProperties: false, + }, + }, + ], + description: "Literal or relative value used by the filter.", + }, + }, + required: [ + "type", + "property", + "propertyType", + "operator", + "value", + ], + additionalProperties: false, + description: "Property filter for page verification state.", + }, + { + type: "object", + properties: { + type: { + type: "string", + enum: [ + "property", + ], + description: "Selects the filter or filter-value variant.", + }, + property: { + type: "string", + description: "Exact data source property name to filter.", + }, + propertyType: { + type: "string", + enum: [ + "formula", + ], + description: "Notion property type used to select valid operators and value shapes.", + }, + operator: { + description: "Comparison or Boolean operation applied by this filter.", + type: "string", + enum: [ + "any", + "none", + "every", + ], + }, + resultFilter: { + anyOf: [ + { + type: "object", + properties: { + type: { + type: "string", + enum: [ + "property", + ], + description: "Selects the filter or filter-value variant.", + }, + property: { + type: "string", + description: "Exact data source property name to filter.", + }, + propertyType: { + type: "string", + description: "Notion property type used to select valid operators and value shapes.", + }, + operator: { + type: "string", + enum: [ + "is_empty", + "is_not_empty", + ], + description: "Comparison or Boolean operation applied by this filter.", + }, + }, + required: [ + "type", + "property", + "propertyType", + "operator", + ], + additionalProperties: false, + description: "Checks whether a property has any value.", + }, + { + type: "object", + properties: { + type: { + type: "string", + enum: [ + "property", + ], + description: "Selects the filter or filter-value variant.", + }, + property: { + type: "string", + description: "Exact data source property name to filter.", + }, + propertyType: { + type: "string", + enum: [ + "title", + "text", + "url", + "email", + "phone_number", + ], + description: "Notion property type used to select valid operators and value shapes.", + }, + operator: { + type: "string", + enum: [ + "string_is", + "string_is_not", + "string_contains", + "string_does_not_contain", + "string_starts_with", + "string_ends_with", + ], + description: "Comparison or Boolean operation applied by this filter.", + }, + value: { + type: "object", + properties: { + type: { + type: "string", + enum: [ + "exact", + ], + description: "Selects the filter or filter-value variant.", + }, + value: { + type: "string", + description: "Literal or relative value used by the filter.", + }, + }, + required: [ + "type", + "value", + ], + additionalProperties: false, + description: "Literal or relative value used by the filter.", + }, + }, + required: [ + "type", + "property", + "propertyType", + "operator", + "value", + ], + additionalProperties: false, + description: "Property filter for text-like properties.", + }, + { + type: "object", + properties: { + type: { + type: "string", + enum: [ + "property", + ], + description: "Selects the filter or filter-value variant.", + }, + property: { + type: "string", + description: "Exact data source property name to filter.", + }, + propertyType: { + type: "string", + enum: [ + "number", + "auto_increment_id", + ], + description: "Notion property type used to select valid operators and value shapes.", + }, + operator: { + type: "string", + enum: [ + "number_equals", + "number_does_not_equal", + "number_greater_than", + "number_less_than", + "number_greater_than_or_equal_to", + "number_less_than_or_equal_to", + ], + description: "Comparison or Boolean operation applied by this filter.", + }, + value: { + type: "object", + properties: { + type: { + type: "string", + enum: [ + "exact", + ], + description: "Selects the filter or filter-value variant.", + }, + value: { + type: "number", + description: "Literal or relative value used by the filter.", + }, + }, + required: [ + "type", + "value", + ], + additionalProperties: false, + description: "Literal or relative value used by the filter.", + }, + }, + required: [ + "type", + "property", + "propertyType", + "operator", + "value", + ], + additionalProperties: false, + description: "Property filter for number properties.", + }, + { + anyOf: [ + { + type: "object", + properties: { + type: { + type: "string", + enum: [ + "property", + ], + description: "Selects the filter or filter-value variant.", + }, + property: { + type: "string", + description: "Exact data source property name to filter.", + }, + propertyType: { + type: "string", + enum: [ + "date", + "created_time", + "last_edited_time", + "last_visited_time", + ], + description: "Notion property type used to select valid operators and value shapes.", + }, + operator: { + type: "string", + enum: [ + "date_is", + "date_is_before", + "date_is_after", + "date_is_on_or_before", + "date_is_on_or_after", + ], + description: "Comparison or Boolean operation applied by this filter.", + }, + value: { + anyOf: [ + { + type: "object", + properties: { + type: { + type: "string", + enum: [ + "exact", + ], + description: "Selects the filter or filter-value variant.", + }, + value: { + type: "string", + description: "Literal or relative value used by the filter.", + }, + }, + required: [ + "type", + "value", + ], + additionalProperties: false, + }, + { + type: "object", + properties: { + type: { + type: "string", + enum: [ + "relative", + ], + description: "Selects the filter or filter-value variant.", + }, + value: { + type: "string", + enum: [ + "today", + "tomorrow", + "yesterday", + "one_week_ago", + "one_week_from_now", + "one_month_ago", + "one_month_from_now", + ], + description: "Literal or relative value used by the filter.", + }, + }, + required: [ + "type", + "value", + ], + additionalProperties: false, + }, + ], + description: "Literal or relative value used by the filter.", + }, + use_end: { + description: "For a date property, compare its end date instead of its start date.", + type: "boolean", + }, + }, + required: [ + "type", + "property", + "propertyType", + "operator", + "value", + ], + additionalProperties: false, + }, + { + type: "object", + properties: { + type: { + type: "string", + enum: [ + "property", + ], + description: "Selects the filter or filter-value variant.", + }, + property: { + type: "string", + description: "Exact data source property name to filter.", + }, + propertyType: { + type: "string", + enum: [ + "date", + "created_time", + "last_edited_time", + "last_visited_time", + ], + description: "Notion property type used to select valid operators and value shapes.", + }, + operator: { + type: "string", + enum: [ + "date_is_within", + "date_is_relative_to", + ], + description: "Comparison or Boolean operation applied by this filter.", + }, + value: { + anyOf: [ + { + type: "object", + properties: { + type: { + type: "string", + enum: [ + "exact", + ], + description: "Selects the filter or filter-value variant.", + }, + value: { + type: "object", + properties: { + type: { + type: "string", + enum: [ + "daterange", + ], + description: "Selects the filter or filter-value variant.", + }, + start_date: { + description: "ISO 8601 date or date-time at the start of the range.", + type: "string", + }, + end_date: { + description: "ISO 8601 date or date-time at the end of the range.", + type: "string", + }, + }, + required: [ + "type", + ], + additionalProperties: false, + description: "Literal or relative value used by the filter.", + }, + }, + required: [ + "type", + "value", + ], + additionalProperties: false, + }, + { + type: "object", + properties: { + type: { + type: "string", + enum: [ + "relative", + ], + description: "Selects the filter or filter-value variant.", + }, + value: { + type: "string", + enum: [ + "custom", + ], + description: "Literal or relative value used by the filter.", + }, + direction: { + type: "string", + enum: [ + "past", + "future", + ], + description: "Whether the custom range extends into the past or future.", + }, + unit: { + type: "string", + enum: [ + "year", + "month", + "week", + "day", + ], + description: "Time unit used to measure a relative date range.", + }, + count: { + type: "number", + description: "Number of units in the custom relative range.", + }, + }, + required: [ + "type", + "value", + "direction", + "unit", + "count", + ], + additionalProperties: false, + }, + { + type: "object", + properties: { + type: { + type: "string", + enum: [ + "relative", + ], + description: "Selects the filter or filter-value variant.", + }, + value: { + type: "string", + enum: [ + "surrounding", + ], + description: "Literal or relative value used by the filter.", + }, + unit: { + type: "string", + enum: [ + "year", + "month", + "week", + "day", + ], + description: "Time unit used to measure a relative date range.", + }, + }, + required: [ + "type", + "value", + "unit", + ], + additionalProperties: false, + }, + { + type: "object", + properties: { + type: { + type: "string", + enum: [ + "relative", + ], + description: "Selects the filter or filter-value variant.", + }, + value: { + type: "string", + enum: [ + "this_week", + "the_past_week", + "the_past_month", + "the_past_year", + "the_next_week", + "the_next_month", + "the_next_year", + ], + description: "Literal or relative value used by the filter.", + }, + }, + required: [ + "type", + "value", + ], + additionalProperties: false, + }, + ], + description: "Literal or relative value used by the filter.", + }, + use_end: { + description: "For a date property, compare its end date instead of its start date.", + type: "boolean", + }, + }, + required: [ + "type", + "property", + "propertyType", + "operator", + "value", + ], + additionalProperties: false, + }, + ], + description: "Property filter for date properties.", + }, + { + type: "object", + properties: { + type: { + type: "string", + enum: [ + "property", + ], + description: "Selects the filter or filter-value variant.", + }, + property: { + type: "string", + description: "Exact data source property name to filter.", + }, + propertyType: { + type: "string", + enum: [ + "select", + ], + description: "Notion property type used to select valid operators and value shapes.", + }, + operator: { + type: "string", + enum: [ + "enum_is", + "enum_is_not", + ], + description: "Comparison or Boolean operation applied by this filter.", + }, + value: { + anyOf: [ + { + type: "object", + properties: { + type: { + type: "string", + enum: [ + "exact", + ], + description: "Selects the filter or filter-value variant.", + }, + value: { + type: "string", + description: "Literal or relative value used by the filter.", + }, + }, + required: [ + "type", + "value", + ], + additionalProperties: false, + }, + { + type: "array", + items: { + type: "object", + properties: { + type: { + type: "string", + enum: [ + "exact", + ], + description: "Selects the filter or filter-value variant.", + }, + value: { + type: "string", + description: "Literal or relative value used by the filter.", + }, + }, + required: [ + "type", + "value", + ], + additionalProperties: false, + }, + }, + ], + description: "Literal or relative value used by the filter.", + }, + }, + required: [ + "type", + "property", + "propertyType", + "operator", + "value", + ], + additionalProperties: false, + description: "Property filter for select properties by option name.", + }, + { + type: "object", + properties: { + type: { + type: "string", + enum: [ + "property", + ], + description: "Selects the filter or filter-value variant.", + }, + property: { + type: "string", + description: "Exact data source property name to filter.", + }, + propertyType: { + type: "string", + enum: [ + "multi_select", + ], + description: "Notion property type used to select valid operators and value shapes.", + }, + operator: { + type: "string", + enum: [ + "enum_contains", + "enum_does_not_contain", + ], + description: "Comparison or Boolean operation applied by this filter.", + }, + value: { + anyOf: [ + { + type: "object", + properties: { + type: { + type: "string", + enum: [ + "exact", + ], + description: "Selects the filter or filter-value variant.", + }, + value: { + type: "string", + description: "Literal or relative value used by the filter.", + }, + }, + required: [ + "type", + "value", + ], + additionalProperties: false, + }, + { + type: "array", + items: { + type: "object", + properties: { + type: { + type: "string", + enum: [ + "exact", + ], + description: "Selects the filter or filter-value variant.", + }, + value: { + type: "string", + description: "Literal or relative value used by the filter.", + }, + }, + required: [ + "type", + "value", + ], + additionalProperties: false, + }, + }, + ], + description: "Literal or relative value used by the filter.", + }, + }, + required: [ + "type", + "property", + "propertyType", + "operator", + "value", + ], + additionalProperties: false, + description: "Property filter for multi-select properties.", + }, + { + type: "object", + properties: { + type: { + type: "string", + enum: [ + "property", + ], + description: "Selects the filter or filter-value variant.", + }, + property: { + type: "string", + description: "Exact data source property name to filter.", + }, + propertyType: { + type: "string", + enum: [ + "checkbox", + ], + description: "Notion property type used to select valid operators and value shapes.", + }, + operator: { + type: "string", + enum: [ + "checkbox_is", + "checkbox_is_not", + ], + description: "Comparison or Boolean operation applied by this filter.", + }, + value: { + type: "object", + properties: { + type: { + type: "string", + enum: [ + "exact", + ], + description: "Selects the filter or filter-value variant.", + }, + value: { + type: "boolean", + description: "Literal or relative value used by the filter.", + }, + }, + required: [ + "type", + "value", + ], + additionalProperties: false, + description: "Literal or relative value used by the filter.", + }, + }, + required: [ + "type", + "property", + "propertyType", + "operator", + "value", + ], + additionalProperties: false, + description: "Property filter for checkbox properties.", + }, + { + type: "object", + properties: { + type: { + type: "string", + enum: [ + "property", + ], + description: "Selects the filter or filter-value variant.", + }, + property: { + type: "string", + description: "Exact data source property name to filter.", + }, + propertyType: { + type: "string", + enum: [ + "relation", + ], + description: "Notion property type used to select valid operators and value shapes.", + }, + operator: { + type: "string", + enum: [ + "relation_contains", + "relation_does_not_contain", + ], + description: "Comparison or Boolean operation applied by this filter.", + }, + value: { + anyOf: [ + { + type: "object", + properties: { + type: { + type: "string", + enum: [ + "exact", + ], + description: "Selects the filter or filter-value variant.", + }, + value: { + type: "string", + description: "Literal or relative value used by the filter.", + }, + }, + required: [ + "type", + "value", + ], + additionalProperties: false, + }, + { + type: "array", + items: { + type: "object", + properties: { + type: { + type: "string", + enum: [ + "exact", + ], + description: "Selects the filter or filter-value variant.", + }, + value: { + type: "string", + description: "Literal or relative value used by the filter.", + }, + }, + required: [ + "type", + "value", + ], + additionalProperties: false, + }, + }, + ], + description: "Literal or relative value used by the filter.", + }, + }, + required: [ + "type", + "property", + "propertyType", + "operator", + "value", + ], + additionalProperties: false, + description: "Property filter for relation properties.", + }, + { + type: "object", + properties: { + type: { + type: "string", + enum: [ + "property", + ], + description: "Selects the filter or filter-value variant.", + }, + property: { + type: "string", + description: "Exact data source property name to filter.", + }, + propertyType: { + type: "string", + enum: [ + "status", + ], + description: "Notion property type used to select valid operators and value shapes.", + }, + operator: { + type: "string", + enum: [ + "status_is", + "status_is_not", + ], + description: "Comparison or Boolean operation applied by this filter.", + }, + value: { + anyOf: [ + { + type: "object", + properties: { + type: { + type: "string", + enum: [ + "is_group", + "is_option", + ], + description: "Selects the filter or filter-value variant.", + }, + value: { + type: "string", + description: "Literal or relative value used by the filter.", + }, + }, + required: [ + "type", + "value", + ], + additionalProperties: false, + }, + { + type: "array", + items: { + type: "object", + properties: { + type: { + type: "string", + enum: [ + "is_group", + "is_option", + ], + description: "Selects the filter or filter-value variant.", + }, + value: { + type: "string", + description: "Literal or relative value used by the filter.", + }, + }, + required: [ + "type", + "value", + ], + additionalProperties: false, + }, + }, + ], + description: "Literal or relative value used by the filter.", + }, + }, + required: [ + "type", + "property", + "propertyType", + "operator", + "value", + ], + additionalProperties: false, + description: "Property filter for status properties by option name.", + }, + { + type: "object", + properties: { + type: { + type: "string", + enum: [ + "property", + ], + description: "Selects the filter or filter-value variant.", + }, + property: { + type: "string", + description: "Exact data source property name to filter.", + }, + propertyType: { + type: "string", + enum: [ + "person", + "created_by", + "last_edited_by", + ], + description: "Notion property type used to select valid operators and value shapes.", + }, + operator: { + type: "string", + enum: [ + "person_contains", + "person_does_not_contain", + ], + description: "Comparison or Boolean operation applied by this filter.", + }, + value: { + anyOf: [ + { + anyOf: [ + { + type: "object", + properties: { + type: { + type: "string", + enum: [ + "exact", + ], + description: "Selects the filter or filter-value variant.", + }, + value: { + type: "string", + description: "Literal or relative value used by the filter.", + }, + }, + required: [ + "type", + "value", + ], + additionalProperties: false, + }, + { + type: "object", + properties: { + type: { + type: "string", + enum: [ + "relative", + ], + description: "Selects the filter or filter-value variant.", + }, + value: { + type: "string", + enum: [ + "me", + ], + description: "Literal or relative value used by the filter.", + }, + }, + required: [ + "type", + "value", + ], + additionalProperties: false, + }, + ], + }, + { + type: "array", + items: { + anyOf: [ + { + type: "object", + properties: { + type: { + type: "string", + enum: [ + "exact", + ], + description: "Selects the filter or filter-value variant.", + }, + value: { + type: "string", + description: "Literal or relative value used by the filter.", + }, + }, + required: [ + "type", + "value", + ], + additionalProperties: false, + }, + { + type: "object", + properties: { + type: { + type: "string", + enum: [ + "relative", + ], + description: "Selects the filter or filter-value variant.", + }, + value: { + type: "string", + enum: [ + "me", + ], + description: "Literal or relative value used by the filter.", + }, + }, + required: [ + "type", + "value", + ], + additionalProperties: false, + }, + ], + }, + }, + ], + description: "Literal or relative value used by the filter.", + }, + }, + required: [ + "type", + "property", + "propertyType", + "operator", + "value", + ], + additionalProperties: false, + description: "Property filter for person-like properties. Exact values use user://, bot://, organization_bot://, or space_permission_group:// URIs; relative values use me.", + }, + { + type: "object", + properties: { + type: { + type: "string", + enum: [ + "property", + ], + description: "Selects the filter or filter-value variant.", + }, + property: { + type: "string", + description: "Exact data source property name to filter.", + }, + propertyType: { + type: "string", + enum: [ + "verification", + ], + description: "Notion property type used to select valid operators and value shapes.", + }, + operator: { + type: "string", + enum: [ + "verification_is", + "verification_is_not", + ], + description: "Comparison or Boolean operation applied by this filter.", + }, + value: { + anyOf: [ + { + type: "object", + properties: { + type: { + type: "string", + enum: [ + "exact", + ], + description: "Selects the filter or filter-value variant.", + }, + value: { + type: "string", + enum: [ + "verified", + "expired", + "none", + ], + description: "Literal or relative value used by the filter.", + }, + }, + required: [ + "type", + "value", + ], + additionalProperties: false, + }, + { + type: "array", + items: { + type: "object", + properties: { + type: { + type: "string", + enum: [ + "exact", + ], + description: "Selects the filter or filter-value variant.", + }, + value: { + type: "string", + enum: [ + "verified", + "expired", + "none", + ], + description: "Literal or relative value used by the filter.", + }, + }, + required: [ + "type", + "value", + ], + additionalProperties: false, + }, + }, + ], + description: "Literal or relative value used by the filter.", + }, + }, + required: [ + "type", + "property", + "propertyType", + "operator", + "value", + ], + additionalProperties: false, + description: "Property filter for page verification state.", + }, + ], + description: "Filter on the formula's result. The propertyType in the resultFilter should be the resultType of the formula.", + }, + }, + required: [ + "type", + "property", + "propertyType", + "resultFilter", + ], + additionalProperties: false, + description: "Filter applied to a formula property.", + }, + ], + description: "Filter applied to a single property.", + }, + description: "Child filters combined by the Boolean group operator.", + }, + }, + required: [ + "type", + "operator", + "filters", + ], + additionalProperties: false, + }, + ], + }, + description: "Child filters combined by the Boolean group operator.", + }, + }, + required: [ + "type", + "operator", + "filters", + ], + additionalProperties: false, + }, + sort: { + description: "Structured property sorts applied in order.", + maxItems: 100, + type: "array", + items: { + type: "object", + properties: { + property: { + type: "string", + description: "Exact data source property name to sort.", + }, + direction: { + type: "string", + enum: [ + "ascending", + "descending", + ], + description: "One of: `ascending`, `descending`", + }, + }, + required: [ + "property", + "direction", + ], + additionalProperties: false, + }, + }, + limit: { + description: "Number of rows to return (default: 50, max: 100).", + type: "integer", + minimum: 1, + maximum: 100, + }, + }, + required: [ + "mode", + "data_source_url", + ], + additionalProperties: false, + }, + ], + }, + }, + required: [ + "data", + ], + $schema: "https://json-schema.org/draft/2020-12/schema", + additionalProperties: {}, + }, + { readOnlyHint: true, destructiveHint: false }, + ), + pin( + "notion-query-multiple-data-sources", + "Query across Notion data sources.", + 'read', + { + type: "object", + properties: { + query: { + type: "string", + description: "Read-only SQLite query to execute against the data sources. Use a data source URL as the table name, e.g. SELECT * FROM \"collection://...\" WHERE .... Include every needed filter in WHERE (filters on views of the data source are not automatically applied). For time comparisons or ordering, normalize text timestamps with datetime(...) or date(...). SQL text values can omit rich-text mentions and formatting, and links can lose their destination. Use faithful rows mode or fetch the page before rewriting a rich-text property.", + }, + data_source_urls: { + description: "Notion data source URLs whose SQLite tables are available to the query; each data source is exposed as a table named by its URL. Obtain them from the fetch tool, in the format: collection://f336d0bc-b841-465b-8045-024475c079dd", + minItems: 2, + maxItems: 100, + type: "array", + items: { + type: "string", + }, + }, + params: { + description: "Positional parameters bound to `?` placeholders in the query. Prefer parameterized queries over string interpolation. Use \"__YES__\" for checked checkboxes and \"__NO__\" for unchecked checkboxes.", + maxItems: 100, + type: "array", + items: { + anyOf: [ + { + type: "string", + }, + { + type: "number", + }, + { + type: "boolean", + }, + { + type: "null", + }, + ], + }, + }, + mode: { + description: "Optional SQL mode marker. This tool only supports SQL queries.", + type: "string", + enum: [ + "sql", + ], + }, + }, + required: [ + "query", + "data_source_urls", + ], + $schema: "https://json-schema.org/draft/2020-12/schema", + additionalProperties: false, + }, + { readOnlyHint: true, destructiveHint: false }, + ), + pin( + "notion-query-meeting-notes", + "Query the connected user’s meeting notes.", + 'read', + { + type: "object", + properties: { + filter: { + description: "Meeting note filter reference.\n\nTitle keyword searching uses a filter on property \"title\" (for example, string_contains). Returns up to 50 rows of matching meeting notes.\n\nFilterable properties:\n- \"title\" (text) — meeting title\n- \"attendees\" (person) — meeting attendees\n- \"created_time\" (date) — when the meeting note was created\n- \"created_by\" (person) — who created the meeting note\n- \"last_edited_time\" (date) — when the meeting note was last edited\n- \"last_edited_by\" (person) — who last edited the meeting note\n\n\nCombinator filters use \"filters\" (not \"operands\"): { \"operator\": \"and\" | \"or\", \"filters\": [ ... ] }\n\nDate filtering (recommended default: date_is_within):\n- Prefer \"date_is_within\" for relative windows like \"past N days/weeks/months\".\n- Relative (common): { type: \"relative\", value: \"the_past_week\" | \"the_past_month\" | \"this_week\" }\n- Relative (custom): { type: \"relative\", value: \"custom\", direction: \"past\" | \"future\", unit: \"day\" | \"week\" | \"month\" | \"year\", count: }\n- Exact range: { type: \"exact\", value: { type: \"daterange\", start_date: \"YYYY-MM-DD\", end_date: \"YYYY-MM-DD\" } }\n- Single-date operators (\"date_is\", \"date_is_before\", \"date_is_after\", \"date_is_on_or_before\", \"date_is_on_or_after\"):\n- Exact: { type: \"exact\", value: { type: \"date\", start_date: \"YYYY-MM-DD\" } }\n- Relative shortcuts: today | tomorrow | yesterday | one_week_ago | one_week_from_now | one_month_ago | one_month_from_now\n\n\nTitle keyword filtering (OR vs AND):\n- Use OR (\"operator\": \"or\") when unsure or for broad discovery.\n- Use AND (\"operator\": \"and\") when the user is specific and you want to narrow results.\n- Break multi-word phrases into individual terms and filter on each term separately.\n\n\nExamples:\n- Past week: {\"operator\":\"and\",\"filters\":[{\"property\":\"created_time\",\"filter\":{\"operator\":\"date_is_within\",\"value\":{\"type\":\"relative\",\"value\":\"the_past_week\"}}}]}\n- Past 3 days: {\"operator\":\"and\",\"filters\":[{\"property\":\"created_time\",\"filter\":{\"operator\":\"date_is_within\",\"value\":{\"type\":\"relative\",\"value\":\"custom\",\"direction\":\"past\",\"unit\":\"day\",\"count\":3}}}]}\n- Exact date range: {\"operator\":\"and\",\"filters\":[{\"property\":\"created_time\",\"filter\":{\"operator\":\"date_is_within\",\"value\":{\"type\":\"exact\",\"value\":{\"type\":\"daterange\",\"start_date\":\"2025-01-01\",\"end_date\":\"2025-12-31\"}}}}]}\n- Created after a date: {\"operator\":\"and\",\"filters\":[{\"property\":\"created_time\",\"filter\":{\"operator\":\"date_is_after\",\"value\":{\"type\":\"exact\",\"value\":{\"type\":\"date\",\"start_date\":\"2025-06-01\"}}}}]}\n- Specific attendee: {\"operator\":\"and\",\"filters\":[{\"property\":\"attendees\",\"filter\":{\"operator\":\"person_contains\",\"value\":[{\"type\":\"exact\",\"value\":{\"table\":\"notion_user\",\"id\":\"\"}}]}}]}\n- Attendee since a date: {\"operator\":\"and\",\"filters\":[{\"property\":\"created_time\",\"filter\":{\"operator\":\"date_is_on_or_after\",\"value\":{\"type\":\"exact\",\"value\":{\"type\":\"date\",\"start_date\":\"2025-01-01\"}}}},{\"property\":\"attendees\",\"filter\":{\"operator\":\"person_contains\",\"value\":[{\"type\":\"exact\",\"value\":{\"table\":\"notion_user\",\"id\":\"\"}}]}}]}\n- Title contains both terms: {\"operator\":\"and\",\"filters\":[{\"property\":\"title\",\"filter\":{\"operator\":\"string_contains\",\"value\":{\"type\":\"exact\",\"value\":\"design\"}}},{\"property\":\"title\",\"filter\":{\"operator\":\"string_contains\",\"value\":{\"type\":\"exact\",\"value\":\"review\"}}}]}\n- Title contains either term: {\"operator\":\"or\",\"filters\":[{\"property\":\"title\",\"filter\":{\"operator\":\"string_contains\",\"value\":{\"type\":\"exact\",\"value\":\"standup\"}}},{\"property\":\"title\",\"filter\":{\"operator\":\"string_contains\",\"value\":{\"type\":\"exact\",\"value\":\"sync\"}}}]}", + type: "object", + properties: { + operator: { + type: "string", + enum: [ + "and", + "or", + ], + description: "Operator for combinator filters.", + }, + filters: { + description: "Nested filters; each may be a combinator (and/or) or property filter.", + maxItems: 100, + type: "array", + items: { + anyOf: [ + { + type: "object", + properties: { + property: { + type: "string", + enum: [ + "title", + "attendees", + "created_time", + "created_by", + "last_edited_time", + "last_edited_by", + "notion://meeting_notes/attendees", + ], + description: "Which meeting-note property to filter on. Prefer the short names; the schema URI form is accepted for compatibility.", + }, + filter: { + anyOf: [ + { + type: "object", + properties: { + operator: { + type: "string", + enum: [ + "string_is", + "string_is_not", + "string_contains", + "string_does_not_contain", + "string_starts_with", + "string_ends_with", + ], + description: "How to compare the text.", + }, + value: { + type: "object", + properties: { + type: { + type: "string", + enum: [ + "exact", + ], + description: "Always `exact`", + }, + value: { + type: "string", + description: "The literal text the operator compares against.", + }, + }, + required: [ + "type", + "value", + ], + additionalProperties: false, + description: "The text to compare against.", + }, + }, + required: [ + "operator", + "value", + ], + additionalProperties: false, + }, + { + type: "object", + properties: { + operator: { + type: "string", + enum: [ + "person_contains", + "person_does_not_contain", + ], + description: "Whether the property must contain the people listed.", + }, + value: { + maxItems: 100, + type: "array", + items: { + anyOf: [ + { + type: "object", + properties: { + type: { + type: "string", + enum: [ + "exact", + ], + description: "Always `exact`", + }, + value: { + type: "object", + properties: { + table: { + type: "string", + enum: [ + "notion_user", + ], + description: "Always `notion_user`", + }, + id: { + type: "string", + description: "The user's ID, as a UUID or the `user://` form returned by user search.", + }, + }, + required: [ + "table", + "id", + ], + additionalProperties: false, + description: "Pointer to the Notion user to match.", + }, + }, + required: [ + "type", + "value", + ], + additionalProperties: false, + }, + { + type: "object", + properties: { + type: { + type: "string", + enum: [ + "relative", + ], + description: "Always `relative`", + }, + value: { + type: "string", + enum: [ + "me", + ], + description: "Always `me`", + }, + }, + required: [ + "type", + "value", + ], + additionalProperties: false, + }, + ], + }, + description: "The people to compare against.", + }, + }, + required: [ + "operator", + "value", + ], + additionalProperties: false, + }, + { + type: "object", + properties: { + operator: { + type: "string", + enum: [ + "date_is", + "date_is_before", + "date_is_after", + "date_is_on_or_before", + "date_is_on_or_after", + ], + description: "How to compare the date.", + }, + value: { + anyOf: [ + { + type: "object", + properties: { + type: { + type: "string", + enum: [ + "relative", + ], + description: "Always `relative`", + }, + value: { + type: "string", + enum: [ + "today", + "tomorrow", + "yesterday", + "one_week_ago", + "one_week_from_now", + "one_month_ago", + "one_month_from_now", + ], + description: "One of: `today`, `tomorrow`, `yesterday`, `one_week_ago`, `one_week_from_now`, `one_month_ago`, `one_month_from_now`", + }, + }, + required: [ + "type", + "value", + ], + additionalProperties: false, + }, + { + type: "object", + properties: { + type: { + type: "string", + enum: [ + "exact", + ], + description: "Always `exact`", + }, + value: { + anyOf: [ + { + type: "object", + properties: { + type: { + type: "string", + enum: [ + "date", + ], + description: "Always `date`", + }, + start_date: { + type: "string", + format: "date", + pattern: "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$", + description: "The calendar date as an ISO 8601 date string.", + }, + }, + required: [ + "type", + "start_date", + ], + additionalProperties: false, + }, + { + type: "object", + properties: { + type: { + type: "string", + enum: [ + "datetime", + ], + description: "Always `datetime`", + }, + start_date: { + type: "string", + format: "date", + pattern: "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$", + description: "The calendar date as an ISO 8601 date string.", + }, + start_time: { + type: "string", + description: "The time of day in 24-hour HH:MM format.", + }, + time_zone: { + type: "string", + description: "The IANA time zone name the time is interpreted in.", + }, + }, + required: [ + "type", + "start_date", + "start_time", + "time_zone", + ], + additionalProperties: false, + }, + ], + description: "Use the is_empty operator to match an unset date.", + }, + }, + required: [ + "type", + "value", + ], + additionalProperties: false, + }, + ], + description: "The date to compare against.", + }, + use_end: { + description: "Compare against the end of a date range rather than its start.", + type: "boolean", + }, + }, + required: [ + "operator", + "value", + ], + additionalProperties: false, + }, + { + type: "object", + properties: { + operator: { + type: "string", + enum: [ + "date_is_within", + "date_is_relative_to", + ], + description: "How to compare the date against the range.", + }, + value: { + anyOf: [ + { + type: "object", + properties: { + type: { + type: "string", + enum: [ + "relative", + ], + description: "Always `relative`", + }, + value: { + type: "string", + enum: [ + "custom", + ], + description: "Always `custom`", + }, + direction: { + type: "string", + enum: [ + "past", + "future", + ], + description: "Whether the window runs backwards or forwards from now.", + }, + unit: { + type: "string", + enum: [ + "year", + "month", + "week", + "day", + ], + description: "One of: `year`, `month`, `week`, `day`", + }, + count: { + type: "integer", + minimum: 1, + maximum: 9007199254740991, + description: "How many units wide the window is.", + }, + }, + required: [ + "type", + "value", + "direction", + "unit", + "count", + ], + additionalProperties: false, + }, + { + type: "object", + properties: { + type: { + type: "string", + enum: [ + "relative", + ], + description: "Always `relative`", + }, + value: { + type: "string", + enum: [ + "surrounding", + ], + description: "Always `surrounding`", + }, + unit: { + type: "string", + enum: [ + "year", + "month", + "week", + "day", + ], + description: "One of: `year`, `month`, `week`, `day`", + }, + }, + required: [ + "type", + "value", + "unit", + ], + additionalProperties: false, + }, + { + type: "object", + properties: { + type: { + type: "string", + enum: [ + "relative", + ], + description: "Always `relative`", + }, + value: { + type: "string", + enum: [ + "this_week", + "the_past_week", + "the_past_month", + "the_past_year", + "the_next_week", + "the_next_month", + "the_next_year", + ], + description: "One of: `this_week`, `the_past_week`, `the_past_month`, `the_past_year`, `the_next_week`, `the_next_month`, `the_next_year`", + }, + }, + required: [ + "type", + "value", + ], + additionalProperties: false, + }, + { + type: "object", + properties: { + type: { + type: "string", + enum: [ + "exact", + ], + description: "Always `exact`", + }, + value: { + type: "object", + properties: { + type: { + type: "string", + enum: [ + "daterange", + ], + description: "Always `daterange`", + }, + start_date: { + description: "Inclusive start of the range as an ISO 8601 date string, if any.", + type: "string", + format: "date", + pattern: "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$", + }, + end_date: { + description: "Inclusive end of the range as an ISO 8601 date string, if any.", + type: "string", + format: "date", + pattern: "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$", + }, + }, + required: [ + "type", + ], + additionalProperties: false, + description: "Use the is_empty operator to match an unset date.", + }, + }, + required: [ + "type", + "value", + ], + additionalProperties: false, + }, + ], + description: "The range to compare against.", + }, + use_end: { + description: "Compare against the end of a date range rather than its start.", + type: "boolean", + }, + }, + required: [ + "operator", + "value", + ], + additionalProperties: false, + }, + { + type: "object", + properties: { + operator: { + type: "string", + enum: [ + "is_empty", + "is_not_empty", + ], + description: "Whether the property must be empty or set.", + }, + }, + required: [ + "operator", + ], + additionalProperties: false, + }, + ], + description: "The comparison to apply. Use the arm matching the property's type.", + }, + }, + required: [ + "property", + "filter", + ], + additionalProperties: false, + }, + { + type: "object", + properties: { + operator: { + type: "string", + enum: [ + "and", + "or", + ], + description: "Whether every child must match, or any of them.", + }, + filters: { + maxItems: 100, + type: "array", + items: { + type: "object", + properties: { + property: { + type: "string", + enum: [ + "title", + "attendees", + "created_time", + "created_by", + "last_edited_time", + "last_edited_by", + "notion://meeting_notes/attendees", + ], + description: "Which meeting-note property to filter on. Prefer the short names; the schema URI form is accepted for compatibility.", + }, + filter: { + anyOf: [ + { + type: "object", + properties: { + operator: { + type: "string", + enum: [ + "string_is", + "string_is_not", + "string_contains", + "string_does_not_contain", + "string_starts_with", + "string_ends_with", + ], + description: "How to compare the text.", + }, + value: { + type: "object", + properties: { + type: { + type: "string", + enum: [ + "exact", + ], + description: "Always `exact`", + }, + value: { + type: "string", + description: "The literal text the operator compares against.", + }, + }, + required: [ + "type", + "value", + ], + additionalProperties: false, + description: "The text to compare against.", + }, + }, + required: [ + "operator", + "value", + ], + additionalProperties: false, + }, + { + type: "object", + properties: { + operator: { + type: "string", + enum: [ + "person_contains", + "person_does_not_contain", + ], + description: "Whether the property must contain the people listed.", + }, + value: { + maxItems: 100, + type: "array", + items: { + anyOf: [ + { + type: "object", + properties: { + type: { + type: "string", + enum: [ + "exact", + ], + description: "Always `exact`", + }, + value: { + type: "object", + properties: { + table: { + type: "string", + enum: [ + "notion_user", + ], + description: "Always `notion_user`", + }, + id: { + type: "string", + description: "The user's ID, as a UUID or the `user://` form returned by user search.", + }, + }, + required: [ + "table", + "id", + ], + additionalProperties: false, + description: "Pointer to the Notion user to match.", + }, + }, + required: [ + "type", + "value", + ], + additionalProperties: false, + }, + { + type: "object", + properties: { + type: { + type: "string", + enum: [ + "relative", + ], + description: "Always `relative`", + }, + value: { + type: "string", + enum: [ + "me", + ], + description: "Always `me`", + }, + }, + required: [ + "type", + "value", + ], + additionalProperties: false, + }, + ], + }, + description: "The people to compare against.", + }, + }, + required: [ + "operator", + "value", + ], + additionalProperties: false, + }, + { + type: "object", + properties: { + operator: { + type: "string", + enum: [ + "date_is", + "date_is_before", + "date_is_after", + "date_is_on_or_before", + "date_is_on_or_after", + ], + description: "How to compare the date.", + }, + value: { + anyOf: [ + { + type: "object", + properties: { + type: { + type: "string", + enum: [ + "relative", + ], + description: "Always `relative`", + }, + value: { + type: "string", + enum: [ + "today", + "tomorrow", + "yesterday", + "one_week_ago", + "one_week_from_now", + "one_month_ago", + "one_month_from_now", + ], + description: "One of: `today`, `tomorrow`, `yesterday`, `one_week_ago`, `one_week_from_now`, `one_month_ago`, `one_month_from_now`", + }, + }, + required: [ + "type", + "value", + ], + additionalProperties: false, + }, + { + type: "object", + properties: { + type: { + type: "string", + enum: [ + "exact", + ], + description: "Always `exact`", + }, + value: { + anyOf: [ + { + type: "object", + properties: { + type: { + type: "string", + enum: [ + "date", + ], + description: "Always `date`", + }, + start_date: { + type: "string", + format: "date", + pattern: "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$", + description: "The calendar date as an ISO 8601 date string.", + }, + }, + required: [ + "type", + "start_date", + ], + additionalProperties: false, + }, + { + type: "object", + properties: { + type: { + type: "string", + enum: [ + "datetime", + ], + description: "Always `datetime`", + }, + start_date: { + type: "string", + format: "date", + pattern: "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$", + description: "The calendar date as an ISO 8601 date string.", + }, + start_time: { + type: "string", + description: "The time of day in 24-hour HH:MM format.", + }, + time_zone: { + type: "string", + description: "The IANA time zone name the time is interpreted in.", + }, + }, + required: [ + "type", + "start_date", + "start_time", + "time_zone", + ], + additionalProperties: false, + }, + ], + description: "Use the is_empty operator to match an unset date.", + }, + }, + required: [ + "type", + "value", + ], + additionalProperties: false, + }, + ], + description: "The date to compare against.", + }, + use_end: { + description: "Compare against the end of a date range rather than its start.", + type: "boolean", + }, + }, + required: [ + "operator", + "value", + ], + additionalProperties: false, + }, + { + type: "object", + properties: { + operator: { + type: "string", + enum: [ + "date_is_within", + "date_is_relative_to", + ], + description: "How to compare the date against the range.", + }, + value: { + anyOf: [ + { + type: "object", + properties: { + type: { + type: "string", + enum: [ + "relative", + ], + description: "Always `relative`", + }, + value: { + type: "string", + enum: [ + "custom", + ], + description: "Always `custom`", + }, + direction: { + type: "string", + enum: [ + "past", + "future", + ], + description: "Whether the window runs backwards or forwards from now.", + }, + unit: { + type: "string", + enum: [ + "year", + "month", + "week", + "day", + ], + description: "One of: `year`, `month`, `week`, `day`", + }, + count: { + type: "integer", + minimum: 1, + maximum: 9007199254740991, + description: "How many units wide the window is.", + }, + }, + required: [ + "type", + "value", + "direction", + "unit", + "count", + ], + additionalProperties: false, + }, + { + type: "object", + properties: { + type: { + type: "string", + enum: [ + "relative", + ], + description: "Always `relative`", + }, + value: { + type: "string", + enum: [ + "surrounding", + ], + description: "Always `surrounding`", + }, + unit: { + type: "string", + enum: [ + "year", + "month", + "week", + "day", + ], + description: "One of: `year`, `month`, `week`, `day`", + }, + }, + required: [ + "type", + "value", + "unit", + ], + additionalProperties: false, + }, + { + type: "object", + properties: { + type: { + type: "string", + enum: [ + "relative", + ], + description: "Always `relative`", + }, + value: { + type: "string", + enum: [ + "this_week", + "the_past_week", + "the_past_month", + "the_past_year", + "the_next_week", + "the_next_month", + "the_next_year", + ], + description: "One of: `this_week`, `the_past_week`, `the_past_month`, `the_past_year`, `the_next_week`, `the_next_month`, `the_next_year`", + }, + }, + required: [ + "type", + "value", + ], + additionalProperties: false, + }, + { + type: "object", + properties: { + type: { + type: "string", + enum: [ + "exact", + ], + description: "Always `exact`", + }, + value: { + type: "object", + properties: { + type: { + type: "string", + enum: [ + "daterange", + ], + description: "Always `daterange`", + }, + start_date: { + description: "Inclusive start of the range as an ISO 8601 date string, if any.", + type: "string", + format: "date", + pattern: "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$", + }, + end_date: { + description: "Inclusive end of the range as an ISO 8601 date string, if any.", + type: "string", + format: "date", + pattern: "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$", + }, + }, + required: [ + "type", + ], + additionalProperties: false, + description: "Use the is_empty operator to match an unset date.", + }, + }, + required: [ + "type", + "value", + ], + additionalProperties: false, + }, + ], + description: "The range to compare against.", + }, + use_end: { + description: "Compare against the end of a date range rather than its start.", + type: "boolean", + }, + }, + required: [ + "operator", + "value", + ], + additionalProperties: false, + }, + { + type: "object", + properties: { + operator: { + type: "string", + enum: [ + "is_empty", + "is_not_empty", + ], + description: "Whether the property must be empty or set.", + }, + }, + required: [ + "operator", + ], + additionalProperties: false, + }, + ], + description: "The comparison to apply. Use the arm matching the property's type.", + }, + }, + required: [ + "property", + "filter", + ], + additionalProperties: false, + }, + description: "The conditions in this group. A group with no conditions matches nothing, so send at least one.", + }, + }, + required: [ + "operator", + "filters", + ], + additionalProperties: false, + }, + ], + }, + }, + }, + required: [ + "operator", + ], + additionalProperties: {}, + }, + }, + $schema: "https://json-schema.org/draft/2020-12/schema", + additionalProperties: {}, + }, + { readOnlyHint: true, destructiveHint: false }, + ), + pin( + "notion-list-private-pages", + "List the connected user’s private pages.", + 'read', + { + type: "object", + properties: { + limit: { + description: "Maximum results to return (1-200).", + type: "number", + }, + cursor: { + description: "Opaque pagination cursor from the previous response.", + type: "string", + }, + }, + $schema: "https://json-schema.org/draft/2020-12/schema", + additionalProperties: false, + }, + { readOnlyHint: true, destructiveHint: false }, + ), + pin( + "notion-list-shared-pages", + "List pages shared with the connected user.", + 'read', + { + type: "object", + properties: { + limit: { + description: "Maximum results to return (1-200).", + type: "number", + }, + cursor: { + description: "Opaque pagination cursor from the previous response.", + type: "string", + }, + }, + $schema: "https://json-schema.org/draft/2020-12/schema", + additionalProperties: false, + }, + { readOnlyHint: true, destructiveHint: false }, + ), + pin( + "notion-list-favorite-pages", + "List the connected user’s favorite pages.", + 'read', + { + type: "object", + properties: { + limit: { + description: "Maximum results to return (1-200).", + type: "number", + }, + cursor: { + description: "Opaque pagination cursor from the previous response.", + type: "string", + }, + }, + $schema: "https://json-schema.org/draft/2020-12/schema", + additionalProperties: false, + }, + { readOnlyHint: true, destructiveHint: false }, + ), + pin( + "notion-list-recent-pages", + "List the connected user’s recent pages.", + 'read', + { + type: "object", + properties: { + limit: { + description: "Maximum results to return (1-200).", + type: "number", + }, + cursor: { + description: "Opaque pagination cursor from the previous response.", + type: "string", + }, + }, + $schema: "https://json-schema.org/draft/2020-12/schema", + additionalProperties: false, + }, + { readOnlyHint: true, destructiveHint: false }, + ), + pin( + "notion-create-view", + "Create a view on a Notion database.", + 'write', + { + type: "object", + properties: { + data_source_id: { + type: "string", + description: "The data source (collection) ID. Accepts a collection:// URI from tags or a bare UUID.", + }, + name: { + type: "string", + description: "The name of the view.", + }, + type: { + type: "string", + enum: [ + "table", + "board", + "list", + "calendar", + "timeline", + "gallery", + "form", + "chart", + "map", + "dashboard", + ], + description: "The type of view to create.", + }, + database_id: { + description: "The database to add a view tab to. Accepts a Notion URL or a bare UUID. Mutually exclusive with `parent_page_id`; exactly one must be provided.", + type: "string", + }, + parent_page_id: { + description: "A page to create an inline linked database view on, like the UI /linked command. Accepts a Notion URL or a bare UUID. The new linked view block is appended at the end of the page and references `data_source_id`. Mutually exclusive with `database_id`; exactly one must be provided.", + type: "string", + }, + configure: { + description: "View configuration DSL directives and examples:\n- FILTER \"Property\" = \"value\" — filter rows. Relation values must be a page URL or UUID; person values must be a user URI (user://), user UUID, or \"me\". Names are not supported for either.\n- QUICK FILTER \"Property\" — add a quick filter to the view's filter bar with no criteria; add a condition to preselect one (QUICK FILTER \"Status\" = \"Done\")\n- SORT BY \"Property\" ASC — sort rows\n- GROUP BY \"Property\" — group by property (required for board views)\n- CALENDAR BY \"Property\" — date property (required for calendar views)\n- TIMELINE BY \"Start\" TO \"End\" — date range (required for timeline views)\n- MAP BY \"Property\" — location property (required for map views)\n- CHART column|bar|line|donut|number — chart type with optional AGGREGATE, COLOR, HEIGHT, SORT, STACK BY, CAPTION\n- FORM CLOSE|OPEN — close/open form submissions\n- FORM ANONYMOUS true|false — toggle anonymous submissions\n- FORM PERMISSIONS none|reader|editor — set submission permissions\n- SHOW \"Prop1\", \"Prop2\" — set visible properties\n- COVER \"Property\" — cover image property\n\n\nSHOW \"Name\", \"Status\", \"Due Date\"\nGROUP BY \"Status\"\nFILTER \"Status\" = \"In Progress\"; SORT BY \"Due Date\" ASC\nCALENDAR BY \"Due Date\"\nTIMELINE BY \"Start\" TO \"End\"\nFILTER \"Company\" = \"Acme\"", + type: "string", + }, + }, + required: [ + "data_source_id", + "name", + "type", + ], + $schema: "https://json-schema.org/draft/2020-12/schema", + additionalProperties: {}, + }, + { readOnlyHint: false, destructiveHint: false }, + ), + pin( + "notion-update-view", + "Update a Notion database view.", + 'write', + { + type: "object", + properties: { + view_id: { + type: "string", + description: "The view to update. Accepts a view:// URI, a Notion URL with ?v= parameter, or a bare UUID.", + }, + name: { + description: "New name for the view.", + type: "string", + }, + configure: { + description: "View configuration DSL string. Supports FILTER, QUICK FILTER, SORT BY, GROUP BY, CALENDAR BY, TIMELINE BY, MAP BY, CHART, FORM, SHOW, HIDE, COVER, WRAP CELLS, FREEZE COLUMNS, and CLEAR directives.", + type: "string", + }, + }, + required: [ + "view_id", + ], + $schema: "https://json-schema.org/draft/2020-12/schema", + additionalProperties: {}, + }, + { readOnlyHint: false, destructiveHint: false }, + ), + ], +}; From 9f29e4e735aa18a7935c375d9ce07834d1ef225a Mon Sep 17 00:00:00 2001 From: Lily Shen <115414357+lilyshen0722@users.noreply.github.com> Date: Mon, 19 Oct 2026 00:25:14 -0700 Subject: [PATCH 2/4] feat(connectors): repin Notion tools from current capture Co-authored-by: forge Agent-Model: codex/gpt-6-sol/medium --- ...json => notion-tools-list-2026-10-19.json} | 2592 +++++++++++++---- .../unit/services/hostedMcpEntry.test.js | 8 +- backend/integrations/hostedMcp/notion.ts | 556 ++-- frontend/src/v2/icons/platforms/index.tsx | 9 + 4 files changed, 2411 insertions(+), 754 deletions(-) rename backend/__tests__/fixtures/hostedMcp/{notion-tools-list-2026-10-01.json => notion-tools-list-2026-10-19.json} (83%) diff --git a/backend/__tests__/fixtures/hostedMcp/notion-tools-list-2026-10-01.json b/backend/__tests__/fixtures/hostedMcp/notion-tools-list-2026-10-19.json similarity index 83% rename from backend/__tests__/fixtures/hostedMcp/notion-tools-list-2026-10-01.json rename to backend/__tests__/fixtures/hostedMcp/notion-tools-list-2026-10-19.json index 3a02b36fad..6df93dac39 100644 --- a/backend/__tests__/fixtures/hostedMcp/notion-tools-list-2026-10-01.json +++ b/backend/__tests__/fixtures/hostedMcp/notion-tools-list-2026-10-19.json @@ -1,44 +1,27 @@ { - "measuredAt": "2026-10-01T11:18:41.957Z", "server": "https://mcp.notion.com/mcp", - "serverVersion": { - "name": "Notion MCP", - "icons": [ - { - "src": "https://mcp.notion.com/notion-logo-block-sticker.svg", - "mimeType": "image/svg+xml" - } - ], - "version": "1.2.0", - "websiteUrl": "https://developers.notion.com/docs/mcp", - "description": "Notion's official MCP server lets you use your Notion workspace as a system of record for knowledge work and software development. Search questions about the codebase and business, fetch links to pages such as tech specs and PRDs, and track tasks with your team." - }, - "requestedScope": null, + "capturedAt": "2026-10-19T07:15:35.472Z", + "scopeRequested": null, "tokenShape": { - "token_type": "bearer", - "scope": "default", - "expires_in": 28800, - "has_refresh_token": true, - "has_id_token": false, "keys": [ "access_token", "expires_in", + "issuer", "refresh_token", "scope", "token_type" - ] + ], + "tokenType": "bearer", + "grantedScope": "default", + "expiresIn": 28800, + "hasRefreshToken": true }, - "count": 44, + "toolCount": 65, "tools": [ { "name": "notion-search", "title": "Search Notion", - "annotations": { - "readOnlyHint": true, - "destructiveHint": false, - "idempotentHint": true, - "openWorldHint": true - }, + "description": "Search Notion with short, specific keywords, or look up a user by name or email. Use this tool for every content search. This workspace uses keyword search, so prefer distinctive words from page titles or content over full questions. AI search, which answers natural-language questions and also searches connected sources, requires a Business or Enterprise plan with Notion AI.\n\nStart with a non-empty query and 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 teamspace across teamspace_id and filters.teamspace_ids, and sort other than relevance. On other plans, those options are dropped with a notice in the result, and results may be broader. Keep filters nested inside \"filters\". Use page_size, not limit.\n\nFor user lookup, set query_type=\"user\" and provide a name or email. A document about a person is a content search, not a user lookup.\n\n\n{\"query\":\"Q3 roadmap\"}\n\n\n{\"query\":\"alex@example.com\",\"query_type\":\"user\"}\n", "inputSchema": { "type": "object", "properties": { @@ -90,7 +73,7 @@ "additionalProperties": false }, "created_by_user_ids": { - "description": "Optional filter to only produce search results created by the Notion users that have the specified user IDs.", + "description": "Optional filter to only produce search results created by the Notion users that have the specified user IDs. Use \"me\" for the connected user.", "maxItems": 100, "type": "array", "items": { @@ -98,7 +81,7 @@ } }, "edited_by_user_ids": { - "description": "Optional filter to only produce search results edited by the Notion users that have the specified user IDs. Available on the Business plan.", + "description": "Optional filter to only produce search results edited by the Notion users that have the specified user IDs. Use \"me\" for the connected user. Available on the Business plan.", "maxItems": 100, "type": "array", "items": { @@ -177,148 +160,31 @@ "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": {} }, - "outputSchema": null, - "description": "Before the first content search for this connection, call get_tool_access with {} unless its current access result is already in context. Choose the content-search tool by current_tool_access.ai_search.status, not by query wording:\n- If the" - }, - { - "name": "notion-ai-search", - "title": "AI search", "annotations": { "readOnlyHint": true, "destructiveHint": false, "idempotentHint": true, "openWorldHint": true - }, + } + }, + { + "name": "notion-memory-search", + "title": "Search personal memories", + "description": "Search memories that the user's connected agents saved in earlier sessions: context, preferences, corrections, and decisions. Returns the best matches, not every memory. To list, count, or filter memories, fetch id \"memory\" and run query-data-sources on its data source. The first time you use memory in a conversation, whether searching or saving, read notion://docs/memory once.", "inputSchema": { "type": "object", "properties": { "query": { "type": "string", - "description": "Exact keywords, a page title, a project name, or a concise natural-language question. Keywords are valid; a question is not required. Preserve distinctive names and identifiers. Prefer one topic per call, ideally under 50 words. Provide a non-empty query unless intentionally browsing Notion with filters or a non-relevance sort." - }, - "query_type": { - "description": "Omit or use \"internal\" for content search. Use \"user\" to look up a workspace user by name or email.", - "type": "string", - "enum": [ - "internal", - "user" - ] - }, - "data_source_url": { - "description": "Optionally restrict search to a data source URL returned in a tag. Omit when searching the whole workspace.", - "type": "string" - }, - "page_url": { - "description": "Optionally restrict search to a page and its descendants. Accepts a Notion page URL or ID. Omit when searching the whole workspace.", - "type": "string" - }, - "teamspace_id": { - "description": "Optionally restrict search to a teamspace ID.", - "type": "string" - }, - "filters": { - "description": "Optional exact filters for Notion pages and databases. Supplying an effective filter selects Notion-only workspace search so the filter is enforced exactly. Omit for unified search across Notion and connected sources. Keep filter fields nested here. Some filters require Business access.", - "type": "object", - "properties": { - "created_date_range": { - "description": "Optional filter to only produce search results created within the specified date range.", - "type": "object", - "properties": { - "start_date": { - "description": "The start date of the date range as an ISO 8601 date string, if any.", - "type": "string", - "format": "date", - "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$" - }, - "end_date": { - "description": "The end date of the date range as an ISO 8601 date string, if any.", - "type": "string", - "format": "date", - "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$" - } - }, - "additionalProperties": false - }, - "created_by_user_ids": { - "description": "Optional filter to only produce search results created by the Notion users that have the specified user IDs.", - "maxItems": 100, - "type": "array", - "items": { - "type": "string" - } - }, - "edited_by_user_ids": { - "description": "Optional filter to only produce search results edited by the Notion users that have the specified user IDs. Available on the Business plan.", - "maxItems": 100, - "type": "array", - "items": { - "type": "string" - } - }, - "last_edited_date_range": { - "description": "Optional filter to only produce search results last edited within the specified date range. Available on the Business plan.", - "type": "object", - "properties": { - "start_date": { - "description": "The start date of the date range as an ISO 8601 date string, if any.", - "type": "string", - "format": "date", - "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$" - }, - "end_date": { - "description": "The end date of the date range as an ISO 8601 date string, if any.", - "type": "string", - "format": "date", - "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$" - } - }, - "additionalProperties": false - }, - "teamspace_ids": { - "description": "Optional filter to only produce search results inside one of the specified teamspaces. Selecting more than one teamspace is available on the Business plan; use teamspace_id for one teamspace on other plans.", - "maxItems": 100, - "type": "array", - "items": { - "type": "string" - } - }, - "title_only": { - "description": "When true, match the query only against page and database titles instead of page content. Available on the Business plan.", - "type": "boolean" - }, - "content_status": { - "description": "Which pages to include by status. Omit for the default live pages. Supplying this field, even with the default value, requires Business access.", - "type": "string", - "enum": [ - "all_with_archived", - "all_without_archived", - "verified_only", - "archived_only" - ] - } - }, - "additionalProperties": false - }, - "sort": { - "description": "Omit for the default \"relevance\" ordering. \"last_edited\" and \"created\" select Notion-only workspace search and require Business access.", - "type": "string", - "enum": [ - "relevance", - "last_edited", - "created" - ] + "minLength": 1, + "maxLength": 500, + "description": "Words or a short phrase to find in personal memories." }, - "page_size": { - "description": "Maximum number of results to return (default 10).", + "limit": { + "description": "Maximum number of memories to return. Defaults to 10 and cannot exceed 50.", "type": "integer", "minimum": 1, "maximum": 50 - }, - "max_highlight_length": { - "description": "Maximum result highlight length (default 200). Set to 0 to omit highlights.", - "type": "integer", - "minimum": 0, - "maximum": 500 } }, "required": [ @@ -327,18 +193,17 @@ "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false }, - "outputSchema": null, - "description": "Use this tool for every content search when access discovery reports current_tool_access.ai_search.status=\"available\". This includes exact keywords, page titles, project names, and natural-language questions. Choose by the connection's acce" - }, - { - "name": "notion-get-tool-access", - "title": "Get tool access", "annotations": { "readOnlyHint": true, "destructiveHint": false, "idempotentHint": true, "openWorldHint": false - }, + } + }, + { + "name": "notion-get-tool-access", + "title": "Get tool access", + "description": "Get current tool availability, parameter restrictions, and available upgrade links for this Notion connection. This lookup is optional: tools apply access limits themselves and report them in their results as notices or errors with upgrade links. Use it when the user asks which Notion tools or features are available, or after a result reports restricted access or an upgrade requirement. Call with {} for the full access map, or pass tool_names to narrow the result. Unknown names and tools not exposed to this connection are omitted. The map may report AI search access under ai_search; use search for every content search, which runs AI search when it is available. Tool availability and restricted_parameters are independent. This tool does not grant access or change the workspace.", "inputSchema": { "type": "object", "properties": { @@ -356,24 +221,23 @@ "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false }, - "outputSchema": null, - "description": "Get current tool availability, parameter restrictions, and available upgrade links for this Notion connection. Call with {} to get the full access map before using a conditionally available tool, unless current access is already in context." - }, - { - "name": "notion-fetch", - "title": "Fetch Notion entities", "annotations": { "readOnlyHint": true, "destructiveHint": false, "idempotentHint": true, "openWorldHint": false - }, + } + }, + { + "name": "notion-fetch", + "title": "Fetch Notion entities", + "description": "Retrieves details about a Notion entity (page, database, data source, or saved database view) by URL or ID.\n\nProvide a URL or ID in `id`. Make multiple calls for multiple entities.\n\nFor pages, use path, verification, edit time, and truncation metadata to assess the source. Treat recency as context, not proof. Report material uncertainty when sources conflict.\n\nPages use enhanced Markdown format. For the complete specification, read the MCP resource `notion://docs/enhanced-markdown-spec` through your MCP client's resource-reading interface, or call the Notion \"fetch\" tool with this URI if your client does not support reading MCP resources. Do NOT pass this URI to any other URL-fetching tool.\n\nPass a `notion://docs/*` URI as `id` to read that MCP documentation resource.\n\nDatabases return data sources in `` tags. Fetch the collection:// URL for its schema and use it with update_data_source or query_data_sources. Multi-source databases return more than one data source.\n\nSaved views return filters, sorts, and display settings. To query their rows, use query_data_sources with `mode: \"view\"`.\n\nA null cover or icon means none; an omitted one means unavailable, not absent. Keep a page's Markdown icon attribute for edit round trips. File URLs expire; re-fetch to refresh them. Uploaded media blocks use stable `notion-file-block://` sources; keep them when editing or copying Markdown. Get download URLs with get_file_download_urls, or set `include_file_urls` to true for a `references` map. Before relying on page content, check `truncated`, `unknown_block_count`, and `unknown_block_ids` for omitted subtrees.\n\nSet `include_discussions` to true for discussion counts, markers, previews, and `discussion://` URLs that correlate with get_comments.\n\nUse get_tool_access to check tool availability, parameter restrictions, and upgrade links for this connection.", "inputSchema": { "type": "object", "properties": { "id": { "type": "string", - "description": "The ID or URL of the Notion page, database, or data source to fetch. Supports notion.so URLs, Notion Sites URLs (*.notion.site), raw UUIDs, and data source URLs (collection://...). Pass a notion://docs/* URI to read that documentation resource. Also accepts an explicit saved view URL (view://...) from a database response. If a database block ID returns a validation error, use the collection:// URL from that error. Example: notion://docs/enhanced-markdown-spec." + "description": "The ID or URL of the Notion page, database, or data source to fetch. Supports notion.so URLs, Notion Sites URLs (*.notion.site), raw UUIDs, and data source URLs (collection://...). Pass \"memory\" to fetch the connected user's About page and memory database in this workspace without creating them. Pass a notion://docs/* URI to read that documentation resource. Also accepts an explicit saved view URL (view://...) from a database response. If a database block ID returns a validation error, use the collection:// URL from that error. Example: notion://docs/enhanced-markdown-spec." }, "include_transcript": { "description": "Whether to include meeting note transcripts. Defaults to false. When true, full transcripts are included; when false, a placeholder with the meeting note URL is shown instead.", @@ -382,6 +246,10 @@ "include_discussions": { "description": "Whether to include discussion/comment indicators in the page output. When true, adds a summary with discussion count, preview snippets, and discussion:// URLs. Use with the get_comments tool to retrieve full discussion content. Defaults to false.", "type": "boolean" + }, + "include_file_urls": { + "description": "Whether to return signed download URLs for uploaded files. Defaults to false. When false, page Markdown cites uploaded files by stable notion-file-block:// references and the response has no references map; call get_file_download_urls with the references when you need those files' contents. When true, the response's references map gives the signed URL for each reference.", + "type": "boolean" } }, "required": [ @@ -390,18 +258,17 @@ "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": {} }, - "outputSchema": null, - "description": "Retrieves details about a Notion entity (page, database, data source, or saved database view) by URL or ID.\n\nProvide a URL or ID in `id`. Make multiple calls for multiple entities.\n\nFor pages, use path, verification, edit time, and truncati" + "annotations": { + "readOnlyHint": true, + "destructiveHint": false, + "idempotentHint": true, + "openWorldHint": false + } }, { "name": "notion-create-attachment", "title": "Create a Notion attachment", - "annotations": { - "readOnlyHint": false, - "destructiveHint": false, - "idempotentHint": false, - "openWorldHint": true - }, + "description": "Create an attachment and upload it to Notion.\n\nProvide exactly one source:\n- content for small UTF-8 text artifacts such as HTML, Markdown, plain text, CSV, JSON, XML, CSS, YAML, TSV, calendar, GPX, or SVG files.\n- source_url for a direct, publicly reachable HTTPS file URL.\n- source_file_id for a file this exact integration already uploaded. When create_file_upload is available, use it for local files so the upload has the same owner.\n\n\nFor content and source_url, filename must use a supported extension and content_type must agree with it. Omit content_type to infer it. source_file_id takes neither because the stored upload carries both. For larger files, redirects, or authenticated downloads, upload through the Notion File Upload API with this integration's token and pass source_file_id.\n\nThe response includes a markdown_source value. To place the uploaded file on a page, pass that source to create-pages or update-page. To attach it to a comment, include suggested_markdown on a separate line in create-comment markdown. Unattached uploads remain temporary and are deleted once they expire: content and source_url open a fresh one-hour window, while source_file_id keeps the window that opened when the file was first uploaded, so place that source promptly and upload the file again if it has already expired. \"HTML\", \"HTML block\", \"HTML artifact\", and \"HTML embed\" all mean an HTML file placed with so Notion renders the sandboxed preview. Never place HTML in a code block or file block. Use for other files.", "inputSchema": { "type": "object", "properties": { @@ -437,18 +304,17 @@ "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": {} }, - "outputSchema": null, - "description": "Create an attachment and upload it to Notion.\n\nProvide exactly one source:\n- content for small UTF-8 text artifacts such as HTML, Markdown, plain text, CSV, JSON, XML, CSS, YAML, TSV, calendar, GPX, or SVG files.\n- source_url for a direct, " - }, - { - "name": "notion-create-file-upload", - "title": "Create a file upload URL", "annotations": { "readOnlyHint": false, "destructiveHint": false, "idempotentHint": false, "openWorldHint": true - }, + } + }, + { + "name": "notion-create-file-upload", + "title": "Create a file upload URL", + "description": "Create a short-lived URL for uploading one local file directly to Notion.\n\nAfter calling this tool, send exactly one multipart/form-data POST request to `upload_url`. Put the file in the `file` form field and include every header returned in `upload_headers`. Files are limited to 20 MiB for this single-part upload flow, and workspace file-size limits still apply.\n\nThe upload response includes `markdown_source` and `suggested_markdown`, which can be passed directly to create-pages or update-page, or included on a separate line in create-comment markdown to attach the file. The URL is short-lived, can upload only the FileUpload created by this call, and runs as this same integration.\n\n\n1. Prepare an image upload: {\"filename\":\"diagram.png\"}\n2. Prepare a PDF upload with an explicit MIME type: {\"filename\":\"report.pdf\",\"content_type\":\"application/pdf\"}\n", "inputSchema": { "type": "object", "properties": { @@ -470,18 +336,17 @@ "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false }, - "outputSchema": null, - "description": "Create a short-lived URL for uploading one local file directly to Notion.\n\nAfter calling this tool, send exactly one multipart/form-data POST request to `upload_url`. Put the file in the `file` form field and include every header returned i" + "annotations": { + "readOnlyHint": false, + "destructiveHint": false, + "idempotentHint": false, + "openWorldHint": true + } }, { "name": "notion-download-attachment", "title": "Download a Notion text attachment", - "annotations": { - "readOnlyHint": true, - "destructiveHint": false, - "idempotentHint": true, - "openWorldHint": false - }, + "description": "Download the contents of a small UTF-8 text attachment created by the Notion MCP `create-attachment` tool.\n\nPass the `file_upload_id` returned by `create-attachment`. The attachment must belong to the requesting integration, have completed uploading, and use a supported text format such as HTML, Markdown, plain text, CSV, JSON, XML, CSS, YAML, TSV, calendar, GPX, or SVG.\n\nThe response contains the complete text in `content` so you can save it locally, edit it, and call `create-attachment` again to upload a new version. Downloads are limited to 200 KiB. This tool does not fetch arbitrary URLs or return binary files. For larger or binary attachments, use the signed file URL returned when reading the containing Notion page.\n\n\n1. Download a text attachment: {\"file_upload_id\":\"12345678-90ab-cdef-1234-567890abcdef\"}\n", "inputSchema": { "type": "object", "properties": { @@ -496,18 +361,47 @@ "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": {} }, - "outputSchema": null, - "description": "Download the contents of a small UTF-8 text attachment created by the Notion MCP `create-attachment` tool.\n\nPass the `file_upload_id` returned by `create-attachment`. The attachment must belong to the requesting integration, have completed " + "annotations": { + "readOnlyHint": true, + "destructiveHint": false, + "idempotentHint": true, + "openWorldHint": false + } }, { - "name": "notion-create-pages", - "title": "Create pages in Markdown", + "name": "notion-get-file-download-urls", + "title": "Get Notion file download URLs", + "description": "Get signed download URLs for files that fetch output cites by stable `notion-file-block://` references.\n\nPass up to 25 references exactly as they appear in the page Markdown. Each reference resolves independently: `files` lists the ones that resolved and `unresolved` lists the rest with a reason. The URLs expire after a few minutes; call this tool again for fresh ones. Keep the stable references, not the URLs, when editing or copying page Markdown.\n\n\n1. Get download URLs: {\"references\":[\"notion-file-block://12345678-90ab-4def-8234-567890abcdef/abcdef12-3456-4890-abcd-ef1234567890?space_id=fedcba98-7654-4321-8fed-cba987654321&name=diagram.png\"]}\n", + "inputSchema": { + "type": "object", + "properties": { + "references": { + "description": "Stable notion-file-block:// file references, copied exactly from the Markdown returned by fetch. Up to 25 per call.", + "minItems": 1, + "maxItems": 25, + "type": "array", + "items": { + "type": "string" + } + } + }, + "required": [ + "references" + ], + "$schema": "https://json-schema.org/draft/2020-12/schema", + "additionalProperties": false + }, "annotations": { - "readOnlyHint": false, + "readOnlyHint": true, "destructiveHint": false, - "idempotentHint": false, + "idempotentHint": true, "openWorldHint": false - }, + } + }, + { + "name": "notion-create-pages", + "title": "Create pages in Markdown", + "description": "Creates one or more Notion pages with the specified properties and content.\n\n## Core rules\n\n**IMPORTANT**: Before writing page content, read the MCP resource `notion://docs/enhanced-markdown-spec` through your MCP client's resource-reading interface, or call the Notion \"fetch\" tool with this URI if your client does not support reading MCP resources. Do NOT pass this URI to any other URL-fetching tool. Do NOT guess or hallucinate Markdown syntax. Do not put the page title at the top of content; set it in properties. By default, use native Notion mentions for references you add to existing Notion pages, databases, data sources, people, and dates. Use Markdown links only for external URLs or when the user requests a plain link. For a person, use a user mention with their user URL, found with search using query_type \"user\"; do not write \"@Name\" as plain text. For a specific date or time, such as a due date or meeting time, use a date mention. The Markdown specification gives the mention syntax.\n\nUse a named destination as parent. Otherwise use \"creation_mode\": \"draft\" for a durable private page. Do not combine draft mode with parent, or move or share it without direction.\n\nFor a database destination, ALWAYS fetch first. Use its collection:// URL as data_source_id, exact property names, and title property. Never put a database ID in page_id. Outside a database, the only allowed property is the required \"title\".\n\nFor reusable instructions, set \"is_skill\": true. Before creating a skill, read the MCP resource `notion://docs/skills` through your MCP client's resource-reading interface. If your client does not support reading MCP resources, call the Notion \"fetch\" tool with this URI instead. Do NOT pass this URI to any other URL-fetching tool. Do not mark ordinary pages or drafts as skills.", "inputSchema": { "type": "object", "properties": { @@ -554,7 +448,7 @@ "type": "string" }, "icon": { - "description": "An emoji character (e.g. \"\ud83d\ude80\"), a custom emoji by name (e.g. \":rocket_ship:\"), a Notion icon identifier as returned by fetch (e.g. \"icons/pizza_blue\"), or an external image URL. Use \"none\" to explicitly set no icon. Omit to leave unchanged. Keep the title free of a duplicate leading emoji because the icon renders separately.", + "description": "An emoji character (e.g. \"🚀\"), a custom emoji by name (e.g. \":rocket_ship:\"), a Notion icon identifier as returned by fetch (e.g. \"icons/pizza_blue\"), or an external image URL. Use \"none\" to explicitly set no icon. Omit to leave unchanged. Keep the title free of a duplicate leading emoji because the icon renders separately.", "type": "string" }, "cover": { @@ -581,8 +475,15 @@ ] }, "parent": { - "description": "All pages in one call share this parent. Otherwise use a page (page_id), database page (database_id), or data source (data_source_id). A database_id cannot be used when the database has more than one data source; fetch it and use the right collection:// URL as data_source_id. If omitted, pages are private at the workspace level. When no destination is named, prefer explicit \"creation_mode\": \"draft\" over omitting the parent.", + "description": "All pages in one call share this parent. Pass \"memory\" to save a personal memory; see notion://docs/memory. Otherwise use a page (page_id), database page (database_id), data source (data_source_id), or teamspace root (teamspace_id, from get_teams). Teamspace roots require a user-backed connection and permission to add top-level pages. A database_id cannot be used when the database has more than one data source; fetch it and use the right collection:// URL as data_source_id. If omitted, pages are private at the workspace level. When no destination is named, prefer explicit \"creation_mode\": \"draft\" over omitting the parent.", "anyOf": [ + { + "type": "string", + "enum": [ + "memory" + ], + "description": "Always `memory`" + }, { "type": "object", "properties": { @@ -642,6 +543,19 @@ "data_source_id" ], "additionalProperties": {} + }, + { + "type": "object", + "properties": { + "teamspace_id": { + "type": "string", + "description": "The ID of the teamspace in which to create top-level pages (with or without dashes)." + } + }, + "required": [ + "teamspace_id" + ], + "additionalProperties": false } ] }, @@ -656,18 +570,17 @@ "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": {} }, - "outputSchema": null, - "description": "Creates one or more Notion pages with the specified properties and content.\n\n## Core rules\n\n**IMPORTANT**: Before writing page content, read the MCP resource `notion://docs/enhanced-markdown-spec` through your MCP client's resource-reading " - }, - { - "name": "notion-update-page", - "title": "Update Notion page", "annotations": { "readOnlyHint": false, - "destructiveHint": true, + "destructiveHint": false, "idempotentHint": false, "openWorldHint": false - }, + } + }, + { + "name": "notion-update-page", + "title": "Update Notion page", + "description": "Update a Notion page's properties or content.\n\n## Core rules\n\n**IMPORTANT**: Before writing page content, read the MCP resource `notion://docs/enhanced-markdown-spec` through your MCP client's resource-reading interface, or call the Notion \"fetch\" tool with this URI if your client does not support reading MCP resources. Do NOT pass this URI to any other URL-fetching tool. Do NOT guess or hallucinate Markdown syntax. By default, use native Notion mentions for references you add to existing Notion pages, databases, data sources, people, and dates. Use Markdown links only for external URLs or when the user requests a plain link. For a person, use a user mention with their user URL, found with search using query_type \"user\"; do not write \"@Name\" as plain text. For a specific date or time, such as a due date or meeting time, use a date mention. The Markdown specification gives the mention syntax.\n\nBefore changing content, fetch unless already loaded. Match nearby headings, block types, nesting, list or table patterns, and prose style.\n\nMake the smallest edit. Use \"update_content\" for targeted search-and-replace and \"insert_content\" only to prepend or append. Avoid full-page \"replace_content\" when a targeted command is sufficient. Preserve unrelated wording, structure, order, and native references. Do not broadly rewrite unless asked.\n\nFor \"update_content\", use the smallest exact old_str that uniquely identifies the target. If the edit would remove material content the user did not identify, ask for confirmation first. After a multi-part or structural edit, fetch the page again and verify the requested content and nesting. Skip this extra read for a simple exact edit.\n\nFor \"replace_content\", preserve child pages and databases with their exact fetched tags. If validation reports that child content would be deleted, show the list and ask for confirmation. Never retry with \"allow_deleting_content\": true without confirmation. Report any \"warnings\" in the result.", "inputSchema": { "type": "object", "properties": { @@ -758,7 +671,7 @@ "type": "string" }, "content_updates": { - "description": "Required for \"update_content\" command. An array of search-and-replace operations, each with old_str (content to find) and new_str (replacement content).", + "description": "Required for \"update_content\" command. An array of search-and-replace operations, each with old_str (content to find) and new_str (replacement content). Operations that match are applied, and each one that matches nothing is reported in \"warnings\". The call fails only when no operation that changes content matches.", "maxItems": 100, "type": "array", "items": { @@ -845,7 +758,7 @@ "maximum": 9007199254740991 }, "icon": { - "description": "An emoji character (e.g. \"\ud83d\ude80\"), a custom emoji by name (e.g. \":rocket_ship:\"), a Notion icon identifier as returned by fetch (e.g. \"icons/pizza_blue\"), or an external image URL. Use \"none\" to remove the icon. Omit to leave unchanged. Can be set alongside any command. Keep the title free of a duplicate leading emoji because the icon renders separately.", + "description": "An emoji character (e.g. \"🚀\"), a custom emoji by name (e.g. \":rocket_ship:\"), a Notion icon identifier as returned by fetch (e.g. \"icons/pizza_blue\"), or an external image URL. Use \"none\" to remove the icon. Omit to leave unchanged. Can be set alongside any command. Keep the title free of a duplicate leading emoji because the icon renders separately.", "type": "string" }, "cover": { @@ -868,18 +781,115 @@ "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": {} }, - "outputSchema": null, - "description": "Update a Notion page's properties or content.\n\n## Core rules\n\n**IMPORTANT**: Before writing page content, read the MCP resource `notion://docs/enhanced-markdown-spec` through your MCP client's resource-reading interface, or call the Notion " - }, - { - "name": "notion-convert-page-to-skill", - "title": "Convert Notion page to skill", "annotations": { "readOnlyHint": false, - "destructiveHint": false, - "idempotentHint": true, + "destructiveHint": true, + "idempotentHint": false, "openWorldHint": false - }, + } + }, + { + "name": "notion-delete-pages", + "title": "Delete pages", + "description": "Move Notion pages to Trash. They can be restored with the restore_pages tool or from Trash in Notion. Database rows are pages. To move a database to Trash, use delete_databases. To remove content inside a page, use update_page instead. Use this tool only when the user explicitly asks to delete specific pages. Never use it on your own initiative to clean up, deduplicate, or reorganize content. Without user_confirmed: true, nothing is trashed and the error lists what would be moved to Trash; show that list to the user and retry only after they confirm.", + "inputSchema": { + "type": "object", + "properties": { + "page_ids": { + "description": "IDs of the pages to move to Trash, 1 to 20. Database rows are pages. Duplicate IDs are processed once.", + "minItems": 1, + "maxItems": 20, + "type": "array", + "items": { + "type": "string" + } + }, + "user_confirmed": { + "description": "Set to true only after the user explicitly asked to delete these exact pages, or confirmed after you showed them the list. If omitted or false, nothing is trashed and the error lists what would be moved to Trash so you can confirm with the user.", + "type": "boolean" + } + }, + "required": [ + "page_ids" + ], + "$schema": "https://json-schema.org/draft/2020-12/schema", + "additionalProperties": false + }, + "annotations": { + "readOnlyHint": false, + "destructiveHint": true, + "idempotentHint": false, + "openWorldHint": false + } + }, + { + "name": "notion-delete-databases", + "title": "Delete databases", + "description": "Move Notion databases to Trash. They can be restored with the restore_pages tool or from Trash in Notion. Each database goes to Trash with all of its rows. Pass a full-page or inline database that owns its data, not a linked view. To move a page or database row to Trash, use delete_pages. Use this tool only when the user explicitly asks to delete specific databases. Never use it on your own initiative to clean up, deduplicate, or reorganize content. Without user_confirmed: true, nothing is trashed and the error lists what would be moved to Trash; show that list to the user and retry only after they confirm.", + "inputSchema": { + "type": "object", + "properties": { + "database_ids": { + "description": "IDs of the databases to move to Trash, 1 to 20. Each must be a full-page or inline database that owns its data, not a linked view. Duplicate IDs are processed once.", + "minItems": 1, + "maxItems": 20, + "type": "array", + "items": { + "type": "string" + } + }, + "user_confirmed": { + "description": "Set to true only after the user explicitly asked to delete these exact databases, or confirmed after you showed them the list. If omitted or false, nothing is trashed and the error lists what would be moved to Trash so you can confirm with the user.", + "type": "boolean" + } + }, + "required": [ + "database_ids" + ], + "$schema": "https://json-schema.org/draft/2020-12/schema", + "additionalProperties": false + }, + "annotations": { + "readOnlyHint": false, + "destructiveHint": true, + "idempotentHint": false, + "openWorldHint": false + } + }, + { + "name": "notion-restore-pages", + "title": "Restore Notion pages from Trash", + "description": "Restore Notion pages or databases from Trash to where they were before they were deleted. Use this when the user asks to undo a deletion or to restore something from Trash. Database rows are pages. Restoring something that is already out of Trash succeeds and changes nothing. To restore a page whose parent is in Trash, restore the parent.", + "inputSchema": { + "type": "object", + "properties": { + "page_ids": { + "description": "IDs of 1 to 20 pages or databases in Trash. Database rows are pages. Duplicate IDs are restored once.", + "minItems": 1, + "maxItems": 20, + "type": "array", + "items": { + "type": "string" + } + } + }, + "required": [ + "page_ids" + ], + "$schema": "https://json-schema.org/draft/2020-12/schema", + "additionalProperties": false + }, + "annotations": { + "readOnlyHint": false, + "destructiveHint": false, + "idempotentHint": true, + "openWorldHint": false + } + }, + { + "name": "notion-convert-page-to-skill", + "title": "Convert Notion page to skill", + "description": "Mark an existing Notion page as a skill without changing its content. The page must be in the current workspace, and the authenticated user must have permission to edit it. Use this tool only when the user wants the page's current contents designated as a skill.", "inputSchema": { "type": "object", "properties": { @@ -896,18 +906,17 @@ "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": {} }, - "outputSchema": null, - "description": "Mark an existing Notion page as a skill without changing its content. The page must be in the current workspace, and the authenticated user must have permission to edit it. Use this tool only when the user wants the page's current contents " + "annotations": { + "readOnlyHint": false, + "destructiveHint": false, + "idempotentHint": true, + "openWorldHint": false + } }, { "name": "notion-upload-skill", "title": "Upload a Notion Skill", - "annotations": { - "readOnlyHint": false, - "destructiveHint": true, - "idempotentHint": false, - "openWorldHint": false - }, + "description": "Import a spec-compliant Agent Skills directory into a page in a Skills database. First call action=prepare with page_id and the exact tar.gz content_length and checksum_crc32. PUT the raw archive bytes to upload_url with all upload_headers, then call action=complete with the same page_id and upload_token. The archive must contain SKILL.md with name/description YAML frontmatter, either at the root or in a single matching skill-name directory. Completion replaces the page title, Description, body, and Files; it preserves the page and uses the page-update diff engine rather than recreating all content blocks. SKILL.md becomes page content. Its sibling folders and files are added directly to Files, preserving nested directories without a skill-name wrapper. Previous folders are not deleted. For a new skill, create a page in a Skills database first. Maximum 20 MiB compressed, 25 MiB expanded, 1000 entries, 20 path levels, and 200 UTF-8 bytes per filename. Paths must be unique ignoring case. Only name and description are imported from frontmatter; optional fields are ignored. Links and special files are rejected. Upload URLs and tokens expire after ten minutes. Uploading never executes skill instructions or scripts.", "inputSchema": { "type": "object", "properties": { @@ -949,18 +958,17 @@ "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false }, - "outputSchema": null, - "description": "Import a spec-compliant Agent Skills directory into a page in a Skills database. First call action=prepare with page_id and the exact tar.gz content_length and checksum_crc32. PUT the raw archive bytes to upload_url with all upload_headers," + "annotations": { + "readOnlyHint": false, + "destructiveHint": true, + "idempotentHint": false, + "openWorldHint": false + } }, { "name": "notion-download-skill", "title": "Download a Notion Skill", - "annotations": { - "readOnlyHint": true, - "destructiveHint": false, - "idempotentHint": true, - "openWorldHint": false - }, + "description": "Download a spec-compliant Notion Skill as a complete tar.gz archive containing SKILL.md and its supporting files and nested folders. Pass the skill page ID. Returns a temporary signed url. Download and extract the archive to read or use the skill.", "inputSchema": { "type": "object", "properties": { @@ -975,18 +983,82 @@ "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false }, - "outputSchema": null, - "description": "Download a spec-compliant Notion Skill as a complete tar.gz archive containing SKILL.md and its supporting files and nested folders. Pass the skill page ID. Returns a temporary signed url. Download and extract the archive to read or use the" + "annotations": { + "readOnlyHint": true, + "destructiveHint": false, + "idempotentHint": true, + "openWorldHint": false + } }, { - "name": "notion-move-pages", - "title": "Move Notion pages", + "name": "notion-get-enabled-skills", + "title": "Get enabled Notion Skills", + "description": "Use this tool to view the Notion skills the user has enabled for you and other external MCP clients, each with a name and a description of when it should be used. If you choose to use one of these skills, mention to the user that you are loading the skill from Notion first, then download them.", + "inputSchema": { + "type": "object", + "properties": {}, + "$schema": "https://json-schema.org/draft/2020-12/schema", + "additionalProperties": false + }, "annotations": { - "readOnlyHint": false, + "readOnlyHint": true, "destructiveHint": false, "idempotentHint": true, "openWorldHint": false + } + }, + { + "name": "notion-update-enabled-skills", + "title": "Update enabled Notion Skills", + "description": "Enable or disable Notion Skills for external MCP clients, Notion AI, or both by adding or removing their page URLs. The surfaces option defaults to both and changes only the current user's Skill settings.", + "inputSchema": { + "type": "object", + "properties": { + "add_skill_urls": { + "description": "Notion Skill page URLs to enable on the requested surfaces.", + "maxItems": 50, + "type": "array", + "items": { + "type": "string", + "description": "A Notion Skill page URL." + } + }, + "remove_skill_urls": { + "description": "Notion Skill page URLs to disable on the requested surfaces.", + "maxItems": 50, + "type": "array", + "items": { + "type": "string", + "description": "A Notion Skill page URL." + } + }, + "surfaces": { + "description": "Skill settings to update. Defaults to both external MCP and Notion AI.", + "maxItems": 2, + "type": "array", + "items": { + "type": "string", + "enum": [ + "mcp", + "notion_ai" + ] + } + } + }, + "$schema": "https://json-schema.org/draft/2020-12/schema", + "additionalProperties": false }, + "annotations": { + "readOnlyHint": false, + "destructiveHint": false, + "idempotentHint": true, + "openWorldHint": false + } + }, + { + "name": "notion-move-pages", + "title": "Move Notion pages", + "description": "Move one or more Notion pages or databases to a new parent.", "inputSchema": { "type": "object", "properties": { @@ -1088,18 +1160,17 @@ "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": {} }, - "outputSchema": null, - "description": "Move one or more Notion pages or databases to a new parent." - }, - { - "name": "notion-duplicate-page", - "title": "Duplicate Notion page", "annotations": { "readOnlyHint": false, "destructiveHint": false, - "idempotentHint": false, + "idempotentHint": true, "openWorldHint": false - }, + } + }, + { + "name": "notion-duplicate-page", + "title": "Duplicate Notion page", + "description": "Duplicate a Notion page. The page must be within the current workspace, and you must have permission to access it. The duplication completes asynchronously, so do not rely on the new page identified by the returned ID or URL to be populated immediately. Let the user know that the duplication is in progress and that they can check back later using the 'fetch' tool or by clicking the returned URL and viewing it in the Notion app.", "inputSchema": { "type": "object", "properties": { @@ -1114,18 +1185,17 @@ "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": {} }, - "outputSchema": null, - "description": "Duplicate a Notion page. The page must be within the current workspace, and you must have permission to access it. The duplication completes asynchronously, so do not rely on the new page identified by the returned ID or URL to be populated" - }, - { - "name": "notion-create-database", - "title": "Create Notion database", "annotations": { "readOnlyHint": false, "destructiveHint": false, "idempotentHint": false, "openWorldHint": false - }, + } + }, + { + "name": "notion-create-database", + "title": "Create Notion database", + "description": "Creates a new Notion database using SQL DDL syntax, or a canonical typed database for tasks, projects, or skills.\n\nProvide exactly one of:\n- schema: a CREATE TABLE statement. If no title property is provided, \"Name\" is auto-added.\n- database_type: one of tasks, projects, or skills. The database is created with the canonical required properties and typed metadata used by Notion.\n\n\nFor schema, use CREATE TABLE with double-quoted column names and single-quoted type options. If no title property is provided, \"Name\" is auto-added.\n\nProperty type syntax:\n- Simple: TITLE, RICH_TEXT, DATE, PEOPLE, CHECKBOX, URL, EMAIL, PHONE_NUMBER, FILES\n- SELECT('opt':color, ...) / MULTI_SELECT('opt':color, ...)\n- STATUS('Backlog':gray:to_do, 'Building':blue:in_progress, 'Shipped':green:complete); groups are to_do, in_progress, complete\n- NUMBER [FORMAT 'dollar'] / FORMULA('expression')\n- RELATION('ds') for a one-way relation\n- RELATION('ds', DUAL) for a two-way relation\n- RELATION('ds', DUAL 'Children') with a synced property name\n- RELATION('ds', DUAL 'Children' 'children') with a synced name and synced_id (for self-relations)\n- ROLLUP('rel_prop', 'target_prop', 'function')\n- UNIQUE_ID [PREFIX 'X'] / CREATED_TIME / LAST_EDITED_TIME\n- Any column: COMMENT 'description text' Colors: default, gray, brown, orange, yellow, green, blue, purple, pink, red.\n\n\nReturns Markdown with schema, SQLite definition, and data source ID in tag for use with update_data_source and query_data_sources tools.", "inputSchema": { "type": "object", "properties": { @@ -1159,7 +1229,7 @@ "type": "string" }, "schema": { - "description": "SQL DDL CREATE TABLE statement defining the database schema. Cannot be combined with database_type. Column names must be double-quoted and type options use single quotes.\n\nProperty type syntax:\n- Simple: TITLE, RICH_TEXT, DATE, PEOPLE, CHECKBOX, URL, EMAIL, PHONE_NUMBER, STATUS, FILES\n- SELECT('opt':color, ...) / MULTI_SELECT('opt':color, ...)\n- NUMBER [FORMAT 'dollar'] / FORMULA('expression')\n- RELATION('ds') for a one-way relation\n- RELATION('ds', DUAL) for a two-way relation\n- RELATION('ds', DUAL 'Children') with a synced property name\n- RELATION('ds', DUAL 'Children' 'children') with a synced name and synced_id (for self-relations)\n- ROLLUP('rel_prop', 'target_prop', 'function')\n- UNIQUE_ID [PREFIX 'X'] / CREATED_TIME / LAST_EDITED_TIME\n- Any column: COMMENT 'description text' Colors: default, gray, brown, orange, yellow, green, blue, purple, pink, red.\n\n\nExamples:\n- Minimal: CREATE TABLE (\"Name\" TITLE)\n- With options: CREATE TABLE (\"Name\" TITLE, \"Budget\" NUMBER FORMAT 'dollar', \"Tags\" MULTI_SELECT('eng':blue, 'design':pink), \"Task ID\" UNIQUE_ID PREFIX 'PRJ')\n- Self-relations are a two-step flow: create the database, then use its data source ID with update_data_source to add paired properties such as RELATION('ds', DUAL 'Children' 'children').", + "description": "SQL DDL CREATE TABLE statement defining the database schema. Cannot be combined with database_type. Column names must be double-quoted and type options use single quotes.\n\nProperty type syntax:\n- Simple: TITLE, RICH_TEXT, DATE, PEOPLE, CHECKBOX, URL, EMAIL, PHONE_NUMBER, FILES\n- SELECT('opt':color, ...) / MULTI_SELECT('opt':color, ...)\n- STATUS('Backlog':gray:to_do, 'Building':blue:in_progress, 'Shipped':green:complete); groups are to_do, in_progress, complete\n- NUMBER [FORMAT 'dollar'] / FORMULA('expression')\n- RELATION('ds') for a one-way relation\n- RELATION('ds', DUAL) for a two-way relation\n- RELATION('ds', DUAL 'Children') with a synced property name\n- RELATION('ds', DUAL 'Children' 'children') with a synced name and synced_id (for self-relations)\n- ROLLUP('rel_prop', 'target_prop', 'function')\n- UNIQUE_ID [PREFIX 'X'] / CREATED_TIME / LAST_EDITED_TIME\n- Any column: COMMENT 'description text' Colors: default, gray, brown, orange, yellow, green, blue, purple, pink, red.\n\n\nExamples:\n- Minimal: CREATE TABLE (\"Name\" TITLE)\n- With options: CREATE TABLE (\"Name\" TITLE, \"Budget\" NUMBER FORMAT 'dollar', \"Tags\" MULTI_SELECT('eng':blue, 'design':pink), \"Task ID\" UNIQUE_ID PREFIX 'PRJ')\n- Self-relations are a two-step flow: create the database, then use its data source ID with update_data_source to add paired properties such as RELATION('ds', DUAL 'Children' 'children').", "type": "string" }, "database_type": { @@ -1175,18 +1245,17 @@ "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": {} }, - "outputSchema": null, - "description": "Creates a new Notion database using SQL DDL syntax, or a canonical typed database for tasks, projects, or skills.\n\nProvide exactly one of:\n- schema: a CREATE TABLE statement. If no title property is provided, \"Name\" is auto-added.\n- databas" - }, - { - "name": "notion-create-folder", - "title": "Create Notion folder", "annotations": { "readOnlyHint": false, "destructiveHint": false, "idempotentHint": false, "openWorldHint": false - }, + } + }, + { + "name": "notion-create-folder", + "title": "Create Notion folder", + "description": "Creates an empty Notion Folder. Set parent.page_id for a top-level Folder owned by a page, or parent.folder_id to create a nested Folder inside another Folder. A page-owned Folder is not inserted into the page's content. A nested Folder is appended to its parent Folder's content. The Folder inherits access from its parent.\n\nThis tool creates only the empty Folder. It is non-idempotent and creates a new Folder on every successful call.", "inputSchema": { "type": "object", "properties": { @@ -1233,18 +1302,17 @@ "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": {} }, - "outputSchema": null, - "description": "Creates an empty Notion Folder. Set parent.page_id for a top-level Folder owned by a page, or parent.folder_id to create a nested Folder inside another Folder. A page-owned Folder is not inserted into the page's content. A nested Folder is " - }, - { - "name": "notion-update-folder", - "title": "Update Notion folder", "annotations": { "readOnlyHint": false, - "destructiveHint": true, + "destructiveHint": false, "idempotentHint": false, "openWorldHint": false - }, + } + }, + { + "name": "notion-update-folder", + "title": "Update Notion folder", + "description": "Update an existing Notion Folder with an explicit Folder operation.\n\n- Use add_files with file upload IDs returned by the upload tools.\n- Fetch the Folder first, then use remove_files with the exact file URLs from that fetch result.\n- Use add_subfolder to create and insert a new nested Folder.\n\n\nUse exactly one command shape; do not mix their arguments:\n- {\"command\":\"add_files\",\"file_upload_ids\":[\"...\"]}\n- {\"command\":\"remove_files\",\"file_urls\":[\"...\"]}\n- {\"command\":\"add_subfolder\",\"title\":\"...\"}\n\n\nThe Folder ID may be provided with or without dashes.", "inputSchema": { "type": "object", "properties": { @@ -1291,18 +1359,17 @@ "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false }, - "outputSchema": null, - "description": "Update an existing Notion Folder with an explicit Folder operation.\n\n- Use add_files with file upload IDs returned by the upload tools.\n- Fetch the Folder first, then use remove_files with the exact file URLs from that fetch result.\n- Use a" - }, - { - "name": "notion-update-data-source", - "title": "Update Notion data source", "annotations": { "readOnlyHint": false, "destructiveHint": true, "idempotentHint": false, "openWorldHint": false - }, + } + }, + { + "name": "notion-update-data-source", + "title": "Update Notion data source", + "description": "Update a Notion data source's schema, title, attributes, or page layout. Schema changes use SQL DDL statements. Returns Markdown showing updated structure and schema.\n\nAccepts a data source ID (collection ID from fetch response's tag) or a single-source database ID. Multi-source databases require the specific data source ID.\n\nThe statements param accepts semicolon-separated DDL statements:\n- ADD COLUMN \"Name\" - add a new property\n- DROP COLUMN \"Name\" - remove a property\n- RENAME COLUMN \"Old\" TO \"New\" - rename a property\n- ALTER COLUMN \"Name\" SET - change type/options. For SELECT, MULTI_SELECT, and STATUS, list every option to keep; omitted options are removed. Existing options keep their id and can be recolored. STATUS options keep their group when the group is omitted.\n\n\nThe page_layout param replaces the layout every page in the data source uses (pinned properties, sidebar, property sections, and a content tab next to views). Fetch the data source first to get the current layout, then edit it. See notion://docs/database-page-layouts for the format.\n\nNotes: Cannot delete/create title properties. Max one unique_id property. Cannot update synced databases. Use \"fetch\" first to see current schema and get the data source ID from tags.", "inputSchema": { "type": "object", "properties": { @@ -1311,7 +1378,7 @@ "description": "The data source to update. Accepts a collection:// URI from tags, a bare UUID, or a database ID (only if the database has a single data source)." }, "statements": { - "description": "Semicolon-separated SQL DDL statements to update the schema. Supports ADD COLUMN, DROP COLUMN, RENAME COLUMN, and ALTER COLUMN SET.\n\nProperty type syntax:\n- Simple: TITLE, RICH_TEXT, DATE, PEOPLE, CHECKBOX, URL, EMAIL, PHONE_NUMBER, STATUS, FILES\n- SELECT('opt':color, ...) / MULTI_SELECT('opt':color, ...)\n- NUMBER [FORMAT 'dollar'] / FORMULA('expression')\n- RELATION('ds') for a one-way relation\n- RELATION('ds', DUAL) for a two-way relation\n- RELATION('ds', DUAL 'Children') with a synced property name\n- RELATION('ds', DUAL 'Children' 'children') with a synced name and synced_id (for self-relations)\n- ROLLUP('rel_prop', 'target_prop', 'function')\n- UNIQUE_ID [PREFIX 'X'] / CREATED_TIME / LAST_EDITED_TIME\n- Any column: COMMENT 'description text' Colors: default, gray, brown, orange, yellow, green, blue, purple, pink, red.\n\n\nExamples:\n- ADD COLUMN \"Priority\" SELECT('High':red, 'Medium':yellow, 'Low':green); ADD COLUMN \"Due Date\" DATE\n- RENAME COLUMN \"Status\" TO \"Project Status\"\n- DROP COLUMN \"Old Property\"\n- For a self-relation, add both relation properties in one call with matching DUAL names and IDs, such as ADD COLUMN \"Parent\" RELATION('ds', DUAL 'Children' 'children').", + "description": "Semicolon-separated SQL DDL statements to update the schema. Supports ADD COLUMN, DROP COLUMN, RENAME COLUMN, and ALTER COLUMN SET.\n\nProperty type syntax:\n- Simple: TITLE, RICH_TEXT, DATE, PEOPLE, CHECKBOX, URL, EMAIL, PHONE_NUMBER, FILES\n- SELECT('opt':color, ...) / MULTI_SELECT('opt':color, ...)\n- STATUS('Backlog':gray:to_do, 'Building':blue:in_progress, 'Shipped':green:complete); groups are to_do, in_progress, complete\n- NUMBER [FORMAT 'dollar'] / FORMULA('expression')\n- RELATION('ds') for a one-way relation\n- RELATION('ds', DUAL) for a two-way relation\n- RELATION('ds', DUAL 'Children') with a synced property name\n- RELATION('ds', DUAL 'Children' 'children') with a synced name and synced_id (for self-relations)\n- ROLLUP('rel_prop', 'target_prop', 'function')\n- UNIQUE_ID [PREFIX 'X'] / CREATED_TIME / LAST_EDITED_TIME\n- Any column: COMMENT 'description text' Colors: default, gray, brown, orange, yellow, green, blue, purple, pink, red.\n\n\nExamples:\n- ADD COLUMN \"Priority\" SELECT('High':red, 'Medium':yellow, 'Low':green); ADD COLUMN \"Due Date\" DATE\n- RENAME COLUMN \"Status\" TO \"Project Status\"\n- DROP COLUMN \"Old Property\"\n- For a self-relation, add both relation properties in one call with matching DUAL names and IDs, such as ADD COLUMN \"Parent\" RELATION('ds', DUAL 'Children' 'children').", "type": "string" }, "title": { @@ -1345,7 +1412,6 @@ "type": "string", "enum": [ "cover", - "properties", "editor", "discussions", "relations", @@ -1367,24 +1433,35 @@ "type": { "type": "string", "enum": [ - "title" + "properties" ], "description": "The module type." }, - "pinnedProperties": { - "description": "Property names to show under the title.", + "properties": { + "description": "Properties in order. Unlisted properties follow in their current order and show. Don't list the title or properties placed elsewhere in the layout.", "type": "array", "items": { - "type": "string" + "type": "object", + "properties": { + "property": { + "type": "string", + "description": "The property name." + }, + "visibility": { + "description": "Defaults to show. Changes how pages look, not who can see the value.", + "type": "string", + "enum": [ + "show", + "hide_if_empty", + "hide" + ] + } + }, + "required": [ + "property" + ], + "additionalProperties": false } - }, - "propertyLabels": { - "description": "Whether pinned properties show their names.", - "type": "string", - "enum": [ - "show", - "hide" - ] } }, "required": [ @@ -1398,32 +1475,126 @@ "type": { "type": "string", "enum": [ - "property" + "properties" ], "description": "The module type." }, - "property": { - "type": "string", - "description": "The name of the property to show." - }, - "config": { - "description": "How the property looks.", - "type": "object", - "properties": { - "style": { - "type": "string", - "enum": [ - "compact", - "large", - "small", - "landscape", - "portrait", - "square", - "map", - "text" - ], - "description": "Display style. Which styles apply depends on the property type." - } + "sections": { + "minItems": 1, + "type": "array", + "items": { + "type": "object", + "properties": { + "name": { + "type": "string", + "minLength": 1, + "description": "The section name." + }, + "properties": { + "type": "array", + "items": { + "type": "object", + "properties": { + "property": { + "type": "string", + "description": "The property name." + }, + "visibility": { + "description": "Defaults to show. Changes how pages look, not who can see the value.", + "type": "string", + "enum": [ + "show", + "hide_if_empty", + "hide" + ] + } + }, + "required": [ + "property" + ], + "additionalProperties": false + }, + "description": "Properties in this section, in order. Don't list the title or properties placed elsewhere in the layout." + } + }, + "required": [ + "name", + "properties" + ], + "additionalProperties": false + }, + "description": "Named sections in order. Unlisted properties go in the last section and show." + } + }, + "required": [ + "type", + "sections" + ], + "additionalProperties": false + }, + { + "type": "object", + "properties": { + "type": { + "type": "string", + "enum": [ + "title" + ], + "description": "The module type." + }, + "pinnedProperties": { + "description": "Property names to show under the title.", + "type": "array", + "items": { + "type": "string" + } + }, + "propertyLabels": { + "description": "Whether pinned properties show their names.", + "type": "string", + "enum": [ + "show", + "hide" + ] + } + }, + "required": [ + "type" + ], + "additionalProperties": false + }, + { + "type": "object", + "properties": { + "type": { + "type": "string", + "enum": [ + "property" + ], + "description": "The module type." + }, + "property": { + "type": "string", + "description": "The name of the property to show." + }, + "config": { + "description": "How the property looks.", + "type": "object", + "properties": { + "style": { + "type": "string", + "enum": [ + "compact", + "large", + "small", + "landscape", + "portrait", + "square", + "map", + "text" + ], + "description": "Display style. Which styles apply depends on the property type." + } }, "required": [ "style" @@ -1476,6 +1647,32 @@ "properties" ], "description": "The module type." + }, + "properties": { + "description": "Properties in order. Unlisted properties follow in their current order and show. Don't list the title or properties placed elsewhere in the layout.", + "type": "array", + "items": { + "type": "object", + "properties": { + "property": { + "type": "string", + "description": "The property name." + }, + "visibility": { + "description": "Defaults to show. Changes how pages look, not who can see the value.", + "type": "string", + "enum": [ + "show", + "hide_if_empty", + "hide" + ] + } + }, + "required": [ + "property" + ], + "additionalProperties": false + } } }, "required": [ @@ -1483,6 +1680,69 @@ ], "additionalProperties": false }, + { + "type": "object", + "properties": { + "type": { + "type": "string", + "enum": [ + "properties" + ], + "description": "The module type." + }, + "sections": { + "minItems": 1, + "type": "array", + "items": { + "type": "object", + "properties": { + "name": { + "type": "string", + "minLength": 1, + "description": "The section name." + }, + "properties": { + "type": "array", + "items": { + "type": "object", + "properties": { + "property": { + "type": "string", + "description": "The property name." + }, + "visibility": { + "description": "Defaults to show. Changes how pages look, not who can see the value.", + "type": "string", + "enum": [ + "show", + "hide_if_empty", + "hide" + ] + } + }, + "required": [ + "property" + ], + "additionalProperties": false + }, + "description": "Properties in this section, in order. Don't list the title or properties placed elsewhere in the layout." + } + }, + "required": [ + "name", + "properties" + ], + "additionalProperties": false + }, + "description": "Named sections in order. Unlisted properties go in the last section and show." + } + }, + "required": [ + "type", + "sections" + ], + "additionalProperties": false + }, { "type": "object", "properties": { @@ -1549,7 +1809,6 @@ "type": { "type": "string", "enum": [ - "properties", "editor", "discussions", "relations" @@ -1562,6 +1821,111 @@ ], "additionalProperties": false }, + { + "type": "object", + "properties": { + "type": { + "type": "string", + "enum": [ + "properties" + ], + "description": "The module type." + }, + "properties": { + "description": "Properties in order. Unlisted properties follow in their current order and show. Don't list the title or properties placed elsewhere in the layout.", + "type": "array", + "items": { + "type": "object", + "properties": { + "property": { + "type": "string", + "description": "The property name." + }, + "visibility": { + "description": "Defaults to show. Changes how pages look, not who can see the value.", + "type": "string", + "enum": [ + "show", + "hide_if_empty", + "hide" + ] + } + }, + "required": [ + "property" + ], + "additionalProperties": false + } + } + }, + "required": [ + "type" + ], + "additionalProperties": false + }, + { + "type": "object", + "properties": { + "type": { + "type": "string", + "enum": [ + "properties" + ], + "description": "The module type." + }, + "sections": { + "minItems": 1, + "type": "array", + "items": { + "type": "object", + "properties": { + "name": { + "type": "string", + "minLength": 1, + "description": "The section name." + }, + "properties": { + "type": "array", + "items": { + "type": "object", + "properties": { + "property": { + "type": "string", + "description": "The property name." + }, + "visibility": { + "description": "Defaults to show. Changes how pages look, not who can see the value.", + "type": "string", + "enum": [ + "show", + "hide_if_empty", + "hide" + ] + } + }, + "required": [ + "property" + ], + "additionalProperties": false + }, + "description": "Properties in this section, in order. Don't list the title or properties placed elsewhere in the layout." + } + }, + "required": [ + "name", + "properties" + ], + "additionalProperties": false + }, + "description": "Named sections in order. Unlisted properties go in the last section and show." + } + }, + "required": [ + "type", + "sections" + ], + "additionalProperties": false + }, { "type": "object", "properties": { @@ -1649,18 +2013,17 @@ "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": {} }, - "outputSchema": null, - "description": "Update a Notion data source's schema, title, attributes, or page layout. Schema changes use SQL DDL statements. Returns Markdown showing updated structure and schema.\n\nAccepts a data source ID (collection ID from fetch response's `. To attach a file created by `create-file-upload` or `create-attachment`, include its returned `suggested_markdown` on a separate line; up to three file attachments are supported. Do not use UI shortcuts like `@today`, `@name`, `[[page]]`, or autocomplete-style emoji syntax; those are editor affordances, not markdown syntax. Mention tags must include a real `url` where required by the spec. Other block-level Markdown such as headings, lists, tables, blockquotes, and fenced code blocks is stored as plain comment text rather than rendered as blocks.\n- `rich_text`: Array of rich text objects.", "inputSchema": { "type": "object", "properties": { @@ -1668,12 +2031,16 @@ "type": "string", "description": "The ID of the page to comment on (with or without dashes)." }, + "reply_to_comment_id": { + "description": "The ID of the comment to reply to.", + "type": "string" + }, "discussion_id": { "description": "The ID or URL of an existing discussion to reply to (e.g., discussion://pageId/blockId/discussionId).", "type": "string" }, "selection_with_ellipsis": { - "description": "Unique start and end snippet of the content to comment on. DO NOT provide the entire string. Instead, provide up to the first ~10 characters, an ellipsis, and then up to the last ~10 characters. Make sure you provide enough of the start and end snippet to uniquely identify the content. For example: \"# Section heading...last paragraph.\"", + "description": "Unique content snippet: ~10 characters from each end, joined by \"...\". A match within one block's text gets an inline comment on that text; otherwise, comment on the block where the match starts. No match returns an error.", "type": "string" }, "rich_text": { @@ -2099,18 +2466,17 @@ "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": {} }, - "outputSchema": null, - "description": "Add a comment to a page or specific content.\n\nProvide `page_id` to identify the page, then choose ONE targeting mode:\n- `page_id` alone: Add a top-level comment to the page\n- `page_id` + `selection_with_ellipsis`: Start a new discussion on " + "annotations": { + "readOnlyHint": false, + "destructiveHint": false, + "idempotentHint": false, + "openWorldHint": false + } }, { "name": "notion-get-comments", "title": "Get page comments", - "annotations": { - "readOnlyHint": true, - "destructiveHint": false, - "idempotentHint": true, - "openWorldHint": false - }, + "description": "Get comments and discussions from a Notion page.\n\nReturns discussions with full comment content in XML format. By default, returns page-level discussions only. On supported Business connections, pending suggested edits use `kind=\"suggested_edit\"` and their `discussion://` URL can be passed to `get_suggested_edit`. Resolved suggestions stay retired. Check `suggested_edits_status` to distinguish an empty result from unavailable suggestion discovery. Comments you wrote have `by-you=\"true\"`.\n\nTip: Use the `fetch` tool with `include_discussions: true` first to see where discussions are anchored in the page content, then use this tool to retrieve full discussion threads. The `discussion://` URLs in the fetch output match the discussion IDs returned here.\n\nParameters:\n- `include_all_blocks`: Include discussions on child blocks (default: false)\n- `include_resolved`: Include resolved discussions (default: false)\n- `discussion_id`: Fetch a specific discussion by ID or URL\n\n\n{\"page_id\": \"page-uuid\"}\n{\"page_id\": \"page-uuid\", \"include_all_blocks\": true}\n{\"page_id\": \"page-uuid\", \"discussion_id\": \"discussion://pageId/blockId/discussionId\"}", "inputSchema": { "type": "object", "properties": { @@ -2137,18 +2503,137 @@ "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": {} }, - "outputSchema": null, - "description": "Get comments and discussions from a Notion page.\n\nReturns discussions with full comment content in XML format. By default, returns page-level discussions only. On supported Business connections, pending suggested edits use `kind=\"suggested_" - }, - { - "name": "notion-get-async-task", - "title": "Get async task status", "annotations": { "readOnlyHint": true, "destructiveHint": false, "idempotentHint": true, "openWorldHint": false - }, + } + }, + { + "name": "notion-update-comment", + "title": "Update comment", + "description": "Replace the text of a comment you wrote. Get the comment ID from get_comments or create_comment. The new text replaces the whole comment, so send the full corrected text. To fix a comment, update it instead of deleting it and posting a new one. You can only edit your own comments.\n\nRequires a Business or Enterprise plan.", + "inputSchema": { + "type": "object", + "properties": { + "comment_id": { + "type": "string", + "description": "The comment ID, with or without dashes. Use the id of a from get_comments, or the id returned by create_comment." + }, + "markdown": { + "type": "string", + "description": "The full replacement text for the comment, as inline Markdown. It replaces the whole comment, so include any text you want to keep. Use the same inline syntax as create_comment. Lists, headings, and other block-level Markdown are not supported in comments." + } + }, + "required": [ + "comment_id", + "markdown" + ], + "$schema": "https://json-schema.org/draft/2020-12/schema", + "additionalProperties": false + }, + "annotations": { + "readOnlyHint": false, + "destructiveHint": false, + "idempotentHint": false, + "openWorldHint": false + } + }, + { + "name": "notion-delete-comment", + "title": "Delete comment", + "description": "Delete a comment you wrote. Get the comment ID from get_comments or create_comment. If it is the last comment in its discussion, the discussion is removed too. Use this only when the user asks to delete a comment; to fix a comment, use update_comment instead. You can only delete your own comments.\n\nRequires a Business or Enterprise plan.", + "inputSchema": { + "type": "object", + "properties": { + "comment_id": { + "type": "string", + "description": "The comment ID, with or without dashes. Use the id of a from get_comments, or the id returned by create_comment." + } + }, + "required": [ + "comment_id" + ], + "$schema": "https://json-schema.org/draft/2020-12/schema", + "additionalProperties": false + }, + "annotations": { + "readOnlyHint": false, + "destructiveHint": true, + "idempotentHint": false, + "openWorldHint": false + } + }, + { + "name": "notion-set-discussion-resolved", + "title": "Set discussion resolved", + "description": "Resolve or reopen a comment discussion. Get the discussion ID from get_comments or create_comment. Use this tool only when a human explicitly asks to resolve that discussion. Do not infer resolution from addressing feedback, replying, completing related work, passing checks, or changing task status.\n\nRequires a Business or Enterprise plan.", + "inputSchema": { + "type": "object", + "properties": { + "discussion_id": { + "type": "string", + "description": "The discussion ID or URL, such as the id of a from get_comments (discussion://pageId/blockId/discussionId) or the discussion_id returned by create_comment." + }, + "resolved": { + "type": "boolean", + "description": "True to resolve the discussion, false to reopen it." + } + }, + "required": [ + "discussion_id", + "resolved" + ], + "$schema": "https://json-schema.org/draft/2020-12/schema", + "additionalProperties": false + }, + "annotations": { + "readOnlyHint": false, + "destructiveHint": false, + "idempotentHint": true, + "openWorldHint": false + } + }, + { + "name": "notion-set-comment-reaction", + "title": "Set comment reaction", + "description": "Add or remove your emoji reaction on a comment. Get the comment ID from get_comments or create_comment. Safe to repeat: setting the same state twice changes nothing.\n\nRequires a Business or Enterprise plan.", + "inputSchema": { + "type": "object", + "properties": { + "comment_id": { + "type": "string", + "description": "The comment ID, with or without dashes. Use the id of a from get_comments, or the id returned by create_comment." + }, + "emoji": { + "type": "string", + "description": "One standard Unicode emoji." + }, + "reacted": { + "type": "boolean", + "description": "True to add the reaction, false to remove it." + } + }, + "required": [ + "comment_id", + "emoji", + "reacted" + ], + "$schema": "https://json-schema.org/draft/2020-12/schema", + "additionalProperties": false + }, + "annotations": { + "readOnlyHint": false, + "destructiveHint": false, + "idempotentHint": true, + "openWorldHint": false + } + }, + { + "name": "notion-get-async-task", + "title": "Get async task status", + "description": "Retrieves the current status of an async task that was started by another tool (for example, \"create_pages\" called with \"allow_async\": true).\n\nThe status is one of \"queued\", \"running\", \"retrying\", \"succeeded\", or \"failed\". When the task has succeeded, the operation's result is included; when it has failed, an error is included instead.\n\nPoll this tool with the \"task_id\" from the original tool's \"async_task\" response. Wait briefly between polls — the original response includes a suggested backoff.\n\n\n1. Check a task's status: {\"task_id\": \"task_abc123\"}\n", "inputSchema": { "type": "object", "properties": { @@ -2164,18 +2649,17 @@ "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": {} }, - "outputSchema": null, - "description": "Retrieves the current status of an async task that was started by another tool (for example, \"create_pages\" called with \"allow_async\": true).\n\nThe status is one of \"queued\", \"running\", \"retrying\", \"succeeded\", or \"failed\". When the task has" - }, - { - "name": "notion-get-teams", - "title": "Get workspace teams", "annotations": { "readOnlyHint": true, "destructiveHint": false, "idempotentHint": true, "openWorldHint": false - }, + } + }, + { + "name": "notion-get-teams", + "title": "Get workspace teams", + "description": "Retrieves a list of teams (teamspaces) in the current workspace. Shows which teams exist, user membership status, IDs, names, and roles.\n\nTeams are returned split by membership status and limited to a maximum of 10 results.\n\n\n1. List all teams (up to the limit of each type): {}\n\n2. Search for teams by name: {\"query\": \"engineering\"}\n\n3. Find a specific team: {\"query\": \"Product Design\"}\n", "inputSchema": { "type": "object", "properties": { @@ -2189,18 +2673,41 @@ "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": {} }, - "outputSchema": null, - "description": "Retrieves a list of teams (teamspaces) in the current workspace. Shows which teams exist, user membership status, IDs, names, and roles.\n\nTeams are returned split by membership status and limited to a maximum of 10 results.\n\n\n1. L" + "annotations": { + "readOnlyHint": true, + "destructiveHint": false, + "idempotentHint": true, + "openWorldHint": false + } }, { - "name": "notion-get-users", - "title": "Get users and bots in workspace", + "name": "notion-get-groups", + "title": "Get workspace groups", + "description": "Retrieves permission groups in the current workspace that you can see, with their IDs and names.\n\nPeople properties reference a group as `space_permission_group-`. Use this tool to find the name of a group in a People property value, or to find a group by name before setting it in a People property.\n\nListings are sorted by name and searches return the closest matches first. Results are limited to a maximum of 25 groups.\n\n\n1. List groups (up to the limit): {}\n\n2. Search for groups by name: {\"query\": \"engineering\"}\n\n3. Look up a group from a People property value: {\"query\": \"space_permission_group-141083e9-5e66-4c8f-8a38-bce5762903c2\"}\n", + "inputSchema": { + "type": "object", + "properties": { + "query": { + "description": "Optional group name to search for (case-insensitive), or a group ID from a People property value (`space_permission_group-` or the bare ID) to look up that group.", + "type": "string", + "minLength": 1, + "maxLength": 100 + } + }, + "$schema": "https://json-schema.org/draft/2020-12/schema", + "additionalProperties": false + }, "annotations": { "readOnlyHint": true, "destructiveHint": false, "idempotentHint": true, "openWorldHint": false - }, + } + }, + { + "name": "notion-get-users", + "title": "Get users and bots in workspace", + "description": "Retrieves a list of users in the current workspace. Shows workspace members and guests with their IDs, names, emails (if available), and types (person or bot).\n\nSupports cursor-based pagination to iterate through all users in the workspace.\n\n\n1. List all users (first page): {}\n\n2. Search for users by name or email: {\"query\": \"john\"}\n\n3. Get next page of results: {\"start_cursor\": \"abc123\"}\n\n4. Set custom page size: {\"page_size\": 20}\n\n5. Fetch a specific user by ID: {\"user_id\": \"00000000-0000-4000-8000-000000000000\"}\n\n6. Fetch the current user: {\"user_id\": \"self\"}\n", "inputSchema": { "type": "object", "properties": { @@ -2216,7 +2723,7 @@ "minLength": 1 }, "page_size": { - "description": "Number of users to return per page (1\u2013100; default 100).", + "description": "Number of users to return per page (1–100; default 100).", "type": "integer", "minimum": 1, "maximum": 100 @@ -2231,23 +2738,22 @@ "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": {} }, - "outputSchema": null, - "description": "Retrieves a list of users in the current workspace. Shows workspace members and guests with their IDs, names, emails (if available), and types (person or bot).\n\nSupports cursor-based pagination to iterate through all users in the workspace." - }, - { - "name": "notion-query-data-sources", - "title": "Query Notion data sources", "annotations": { "readOnlyHint": true, "destructiveHint": false, "idempotentHint": true, "openWorldHint": false - }, + } + }, + { + "name": "notion-query-data-sources", + "title": "Query Notion data sources", + "description": "Query Notion data sources using faithful structured rows, SQL, or a saved view.\n\nUse fetch first to read the schema and collection:// URL for every data source you query.\n\nChoose the mode by the data needed; omitting mode uses sql:\n- rows preserves rich-text mentions, links, formatting, dates, and equations. Use it before repairing or rewriting rich-text properties.\n- sql runs read-only SQLite. Use only table and column names shown in each fetched `` definition. The system columns include `url` and `createdTime`; use other metadata names only when the table lists them. Do not assume generic names such as `Name` or `Title`, or names such as `page_id`, `rowid`, or `lastEditedTime`. Date properties expand to `date::start`, `:end`, `:is_datetime`; `created_time` keeps its base name. Try a column the error suggests, or fetch the data source again for its current `` names. Bind untrusted values with `?` placeholders and `params`, and include every needed filter. View filters are not applied automatically. SQL text is lossy: mentions and formatting may be omitted, and links may lose their destination. Never treat that output as proof that a property is corrupt.\n- view runs one saved view's filters and sorts. Omit is_archived or set it false for active rows; true selects archived rows. When has_more is true, pass next_cursor as start_cursor with the same is_archived value.\n\n\nView mode has no tool-specific plan quota. SQL is unlimited on Business and Enterprise with Notion AI. Other plans have a shared workspace limit for single-data-source SQL and cannot query multiple data sources at once.", "inputSchema": { "type": "object", "properties": { "data": { - "description": "Mode parameter reference and examples.\n\nSQL mode:\n- Checkbox values: use \"__YES__\" for checked, \"__NO__\" for unchecked\n\n\nRows mode: Return up to 100 rows with faithful rich-text property values and optional structured filters and sorts.\n\nExample:\n{\"mode\":\"rows\",\"data_source_url\":\"collection://f336d0bc-b841-465b-8045-024475c079dd\",\"filter\":{\"type\":\"group\",\"operator\":\"and\",\"filters\":[{\"type\":\"property\",\"property\":\"Status\",\"propertyType\":\"select\",\"operator\":\"enum_is\",\"value\":{\"type\":\"exact\",\"value\":\"In Progress\"}}]},\"limit\":20}\n\nExamples:\n- Simple SQL: {\"data_source_urls\":[\"collection://f336d0bc-b841-465b-8045-024475c079dd\"],\"query\":\"SELECT * FROM [collection://f336d0bc-b841-465b-8045-024475c079dd] LIMIT 10\"}\n- SQL parameters: {\"mode\":\"sql\",\"data_source_urls\":[\"collection://abc123\"],\"query\":\"SELECT * FROM [collection://abc123] WHERE Status = ? AND Priority = ?\",\"params\":[\"In Progress\",\"High\"]}\n- Checkbox query: {\"data_source_urls\":[\"collection://def456\"],\"query\":\"SELECT * FROM [collection://def456] WHERE Completed = ?\",\"params\":[\"__YES__\"]}\n\nView mode: Execute a specific database view's query with its filters and sorts. Omit \"is_archived\" or set it to false for non-archived rows. Set \"is_archived\": true to apply the view inside the archived partition. When the response has \"has_more\": true, pass its \"next_cursor\" as \"start_cursor\" in a follow-up view-mode request with the same \"is_archived\" value.\n\nExample:\n{\"mode\":\"view\",\"view_url\":\"https://www.notion.so/workspace/Tasks-DB-abc123?v=def456\",\"is_archived\":false}", + "description": "Mode parameter reference and examples.\n\nSQL mode:\n- Use single quotes for SQL string values, such as `\"Status\" = 'Done'`. Use double quotes for table and column names. In SQL, `''` is an empty string.\n- Prefer `?` placeholders for values. For text values, the `params` array uses JSON strings, so `[\"\"]` passes an empty string and `[\"__YES__\"]` passes a checked checkbox value. Do not add SQL quote marks around a bound value.\n- Checkbox SQL values: `'__YES__'` means checked; `'__NO__'` means unchecked.\n\n\nRows mode: Return up to 100 rows with faithful rich-text property values and optional structured filters and sorts.\n\nExample:\n{\"mode\":\"rows\",\"data_source_url\":\"collection://f336d0bc-b841-465b-8045-024475c079dd\",\"filter\":{\"type\":\"group\",\"operator\":\"and\",\"filters\":[{\"type\":\"property\",\"property\":\"Status\",\"propertyType\":\"select\",\"operator\":\"enum_is\",\"value\":{\"type\":\"exact\",\"value\":\"In Progress\"}}]},\"limit\":20}\n\nExamples:\n- Simple SQL: {\"data_source_urls\":[\"collection://f336d0bc-b841-465b-8045-024475c079dd\"],\"query\":\"SELECT * FROM [collection://f336d0bc-b841-465b-8045-024475c079dd] LIMIT 10\"}\n- SQL parameters: {\"mode\":\"sql\",\"data_source_urls\":[\"collection://abc123\"],\"query\":\"SELECT * FROM [collection://abc123] WHERE Status = ? AND Priority = ?\",\"params\":[\"In Progress\",\"High\"]}\n- Checkbox query: {\"data_source_urls\":[\"collection://def456\"],\"query\":\"SELECT * FROM [collection://def456] WHERE Completed = ?\",\"params\":[\"__YES__\"]}\n\nView mode: Execute a specific database view's query with its filters and sorts. Omit \"is_archived\" or set it to false for non-archived rows. Set \"is_archived\": true to apply the view inside the archived partition. When the response has \"has_more\": true, pass its \"next_cursor\" as \"start_cursor\" in a follow-up view-mode request with the same \"is_archived\" value.\n\nExample:\n{\"mode\":\"view\",\"view_url\":\"https://www.notion.so/workspace/Tasks-DB-abc123?v=def456\",\"is_archived\":false}", "anyOf": [ { "type": "object", @@ -2262,7 +2768,7 @@ }, "query": { "type": "string", - "description": "Read-only SQLite query to execute against the data sources. Use a data source URL as the table name, e.g. SELECT * FROM \"collection://...\" WHERE .... Include every needed filter in WHERE (filters on views of the data source are not automatically applied). For time comparisons or ordering, normalize text timestamps with datetime(...) or date(...). SQL text values can omit rich-text mentions and formatting, and links can lose their destination. Use faithful rows mode or fetch the page before rewriting a rich-text property." + "description": "Read-only SQLite query to execute against the data sources. Use a data source URL as the table name, e.g. SELECT * FROM \"collection://...\" WHERE .... Use only table and column names shown in the fetched `` definition; date properties use the expanded column names listed there, not the base name. Include every needed filter in WHERE (filters on views of the data source are not automatically applied). For time comparisons or ordering, normalize text timestamps with datetime(...) or date(...). SQL text values can omit rich-text mentions and formatting, and links can lose their destination. Use faithful rows mode or fetch the page before rewriting a rich-text property." }, "mode": { "description": "Optional mode parameter. Defaults to 'sql' if not specified. SQL mode does not accept is_archived; that parameter belongs only to view mode.", @@ -7214,24 +7720,23 @@ "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": {} }, - "outputSchema": null, - "description": "Query Notion data sources using faithful structured rows, SQL, or a saved view.\n\nIf availability is not already known for this connection, call get_tool_access with {} before using this tool. Reuse the returned access map across tools; chec" - }, - { - "name": "notion-query-multiple-data-sources", - "title": "Query multiple Notion data sources", "annotations": { "readOnlyHint": true, "destructiveHint": false, "idempotentHint": true, "openWorldHint": false - }, + } + }, + { + "name": "notion-query-multiple-data-sources", + "title": "Query multiple Notion data sources", + "description": "Query data across multiple Notion data sources using read-only SQLite SQL.\n\nUse this tool for JOINs, UNIONs, comparisons, and aggregations that need two or more data sources. Queries across multiple data sources require a Business or Enterprise plan with Notion AI. Use query_data_sources instead when you need one data source or a saved database view.\n\nPrerequisites:\n1. Use the \"fetch\" tool first to get each data source's schema and collection:// URL.\n2. Data source URLs are found in tags in fetch results.\n\n\nSQL:\n- Use each collection:// URL as a quoted SQLite table name in the query.\n- Bind untrusted values with ? placeholders and params; do not interpolate them into SQL.\n- Include every needed filter in WHERE. Saved-view filters and sorts are not automatically applied.\n- Checkbox values: use \"__YES__\" for checked and \"__NO__\" for unchecked.\n- Date properties expand to `date::start`, `:end`, `:is_datetime`; `created_time` keeps its base name.\n\n\nReturns matching rows, the queried data source IDs, and whether results were truncated.", "inputSchema": { "type": "object", "properties": { "query": { "type": "string", - "description": "Read-only SQLite query to execute against the data sources. Use a data source URL as the table name, e.g. SELECT * FROM \"collection://...\" WHERE .... Include every needed filter in WHERE (filters on views of the data source are not automatically applied). For time comparisons or ordering, normalize text timestamps with datetime(...) or date(...). SQL text values can omit rich-text mentions and formatting, and links can lose their destination. Use faithful rows mode or fetch the page before rewriting a rich-text property." + "description": "Read-only SQLite query to execute against the data sources. Use a data source URL as the table name, e.g. SELECT * FROM \"collection://...\" WHERE .... Use only table and column names shown in the fetched `` definition; date properties use the expanded column names listed there, not the base name. Include every needed filter in WHERE (filters on views of the data source are not automatically applied). For time comparisons or ordering, normalize text timestamps with datetime(...) or date(...). SQL text values can omit rich-text mentions and formatting, and links can lose their destination. Use faithful rows mode or fetch the page before rewriting a rich-text property." }, "data_source_urls": { "description": "Notion data source URLs whose SQLite tables are available to the query; each data source is exposed as a table named by its URL. Obtain them from the fetch tool, in the format: collection://f336d0bc-b841-465b-8045-024475c079dd", @@ -7278,23 +7783,22 @@ "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false }, - "outputSchema": null, - "description": "Query data across multiple Notion data sources using read-only SQLite SQL.\n\nIf availability is not already known for this connection, call get_tool_access with {} before using this tool. Reuse the returned access map across tools; check the" - }, - { - "name": "notion-query-meeting-notes", - "title": "Query Notion meeting notes", "annotations": { "readOnlyHint": true, "destructiveHint": false, "idempotentHint": true, "openWorldHint": false - }, + } + }, + { + "name": "notion-query-meeting-notes", + "title": "Query Notion meeting notes", + "description": "Query the current user's meeting notes data source.\n\nUse search first to resolve people IDs for attendee filters. By default, results already include meetings where the current user is an attendee or creator; do not add a current-user filter.\n\nTreat words such as summaries, notes, todos, action items, and deliverables as requested meeting output, not title terms. Example: \"What are my meeting todos?\" needs no title filter for \"todos\". Add a title filter only when the user clearly names a meeting, such as \"standup\", \"sprint planning\", or \"1:1 with Alice\". Generic date phrases like \"recent meetings\", \"latest meetings\", \"meetings this week\", or \"yesterday's meetings\" should be interpreted as date range filters — never as title filters. Unless the user asks about a meeting whose title contains another person's name, treat that person as an attendee or creator. Use their name as a title fallback only after attendee filtering returns no results.\n\nTitle keyword matching is case-insensitive; capitalization does not matter. Matching is lexical, so simplify a filter to one term when it returns no results. The filter parameter contains the complete property, date, Boolean-combination, and example reference.\n\nRequires Notion AI. Admins can turn off AI Meeting Notes.", "inputSchema": { "type": "object", "properties": { "filter": { - "description": "Meeting note filter reference.\n\nTitle keyword searching uses a filter on property \"title\" (for example, string_contains). Returns up to 50 rows of matching meeting notes.\n\nFilterable properties:\n- \"title\" (text) \u2014 meeting title\n- \"attendees\" (person) \u2014 meeting attendees\n- \"created_time\" (date) \u2014 when the meeting note was created\n- \"created_by\" (person) \u2014 who created the meeting note\n- \"last_edited_time\" (date) \u2014 when the meeting note was last edited\n- \"last_edited_by\" (person) \u2014 who last edited the meeting note\n\n\nCombinator filters use \"filters\" (not \"operands\"): { \"operator\": \"and\" | \"or\", \"filters\": [ ... ] }\n\nDate filtering (recommended default: date_is_within):\n- Prefer \"date_is_within\" for relative windows like \"past N days/weeks/months\".\n- Relative (common): { type: \"relative\", value: \"the_past_week\" | \"the_past_month\" | \"this_week\" }\n- Relative (custom): { type: \"relative\", value: \"custom\", direction: \"past\" | \"future\", unit: \"day\" | \"week\" | \"month\" | \"year\", count: }\n- Exact range: { type: \"exact\", value: { type: \"daterange\", start_date: \"YYYY-MM-DD\", end_date: \"YYYY-MM-DD\" } }\n- Single-date operators (\"date_is\", \"date_is_before\", \"date_is_after\", \"date_is_on_or_before\", \"date_is_on_or_after\"):\n- Exact: { type: \"exact\", value: { type: \"date\", start_date: \"YYYY-MM-DD\" } }\n- Relative shortcuts: today | tomorrow | yesterday | one_week_ago | one_week_from_now | one_month_ago | one_month_from_now\n\n\nTitle keyword filtering (OR vs AND):\n- Use OR (\"operator\": \"or\") when unsure or for broad discovery.\n- Use AND (\"operator\": \"and\") when the user is specific and you want to narrow results.\n- Break multi-word phrases into individual terms and filter on each term separately.\n\n\nExamples:\n- Past week: {\"operator\":\"and\",\"filters\":[{\"property\":\"created_time\",\"filter\":{\"operator\":\"date_is_within\",\"value\":{\"type\":\"relative\",\"value\":\"the_past_week\"}}}]}\n- Past 3 days: {\"operator\":\"and\",\"filters\":[{\"property\":\"created_time\",\"filter\":{\"operator\":\"date_is_within\",\"value\":{\"type\":\"relative\",\"value\":\"custom\",\"direction\":\"past\",\"unit\":\"day\",\"count\":3}}}]}\n- Exact date range: {\"operator\":\"and\",\"filters\":[{\"property\":\"created_time\",\"filter\":{\"operator\":\"date_is_within\",\"value\":{\"type\":\"exact\",\"value\":{\"type\":\"daterange\",\"start_date\":\"2025-01-01\",\"end_date\":\"2025-12-31\"}}}}]}\n- Created after a date: {\"operator\":\"and\",\"filters\":[{\"property\":\"created_time\",\"filter\":{\"operator\":\"date_is_after\",\"value\":{\"type\":\"exact\",\"value\":{\"type\":\"date\",\"start_date\":\"2025-06-01\"}}}}]}\n- Specific attendee: {\"operator\":\"and\",\"filters\":[{\"property\":\"attendees\",\"filter\":{\"operator\":\"person_contains\",\"value\":[{\"type\":\"exact\",\"value\":{\"table\":\"notion_user\",\"id\":\"\"}}]}}]}\n- Attendee since a date: {\"operator\":\"and\",\"filters\":[{\"property\":\"created_time\",\"filter\":{\"operator\":\"date_is_on_or_after\",\"value\":{\"type\":\"exact\",\"value\":{\"type\":\"date\",\"start_date\":\"2025-01-01\"}}}},{\"property\":\"attendees\",\"filter\":{\"operator\":\"person_contains\",\"value\":[{\"type\":\"exact\",\"value\":{\"table\":\"notion_user\",\"id\":\"\"}}]}}]}\n- Title contains both terms: {\"operator\":\"and\",\"filters\":[{\"property\":\"title\",\"filter\":{\"operator\":\"string_contains\",\"value\":{\"type\":\"exact\",\"value\":\"design\"}}},{\"property\":\"title\",\"filter\":{\"operator\":\"string_contains\",\"value\":{\"type\":\"exact\",\"value\":\"review\"}}}]}\n- Title contains either term: {\"operator\":\"or\",\"filters\":[{\"property\":\"title\",\"filter\":{\"operator\":\"string_contains\",\"value\":{\"type\":\"exact\",\"value\":\"standup\"}}},{\"property\":\"title\",\"filter\":{\"operator\":\"string_contains\",\"value\":{\"type\":\"exact\",\"value\":\"sync\"}}}]}", + "description": "Meeting note filter reference.\n\nTitle keyword searching uses a filter on property \"title\" (for example, string_contains). Returns up to 50 rows of matching meeting notes.\n\nFilterable properties:\n- \"title\" (text) — meeting title\n- \"attendees\" (person) — meeting attendees\n- \"created_time\" (date) — when the meeting note was created\n- \"created_by\" (person) — who created the meeting note\n- \"last_edited_time\" (date) — when the meeting note was last edited\n- \"last_edited_by\" (person) — who last edited the meeting note\n\n\nCombinator filters use \"filters\" (not \"operands\"): { \"operator\": \"and\" | \"or\", \"filters\": [ ... ] }\n\nDate filtering (recommended default: date_is_within):\n- Prefer \"date_is_within\" for relative windows like \"past N days/weeks/months\".\n- Relative (common): { type: \"relative\", value: \"the_past_week\" | \"the_past_month\" | \"this_week\" }\n- Relative (custom): { type: \"relative\", value: \"custom\", direction: \"past\" | \"future\", unit: \"day\" | \"week\" | \"month\" | \"year\", count: }\n- Exact range: { type: \"exact\", value: { type: \"daterange\", start_date: \"YYYY-MM-DD\", end_date: \"YYYY-MM-DD\" } }\n- Single-date operators (\"date_is\", \"date_is_before\", \"date_is_after\", \"date_is_on_or_before\", \"date_is_on_or_after\"):\n- Exact: { type: \"exact\", value: { type: \"date\", start_date: \"YYYY-MM-DD\" } }\n- Relative shortcuts: today | tomorrow | yesterday | one_week_ago | one_week_from_now | one_month_ago | one_month_from_now\n\n\nTitle keyword filtering (OR vs AND):\n- Use OR (\"operator\": \"or\") when unsure or for broad discovery.\n- Use AND (\"operator\": \"and\") when the user is specific and you want to narrow results.\n- Break multi-word phrases into individual terms and filter on each term separately.\n\n\nExamples:\n- Past week: {\"operator\":\"and\",\"filters\":[{\"property\":\"created_time\",\"filter\":{\"operator\":\"date_is_within\",\"value\":{\"type\":\"relative\",\"value\":\"the_past_week\"}}}]}\n- Past 3 days: {\"operator\":\"and\",\"filters\":[{\"property\":\"created_time\",\"filter\":{\"operator\":\"date_is_within\",\"value\":{\"type\":\"relative\",\"value\":\"custom\",\"direction\":\"past\",\"unit\":\"day\",\"count\":3}}}]}\n- Exact date range: {\"operator\":\"and\",\"filters\":[{\"property\":\"created_time\",\"filter\":{\"operator\":\"date_is_within\",\"value\":{\"type\":\"exact\",\"value\":{\"type\":\"daterange\",\"start_date\":\"2025-01-01\",\"end_date\":\"2025-12-31\"}}}}]}\n- Created after a date: {\"operator\":\"and\",\"filters\":[{\"property\":\"created_time\",\"filter\":{\"operator\":\"date_is_after\",\"value\":{\"type\":\"exact\",\"value\":{\"type\":\"date\",\"start_date\":\"2025-06-01\"}}}}]}\n- Specific attendee: {\"operator\":\"and\",\"filters\":[{\"property\":\"attendees\",\"filter\":{\"operator\":\"person_contains\",\"value\":[{\"type\":\"exact\",\"value\":{\"table\":\"notion_user\",\"id\":\"\"}}]}}]}\n- Attendee since a date: {\"operator\":\"and\",\"filters\":[{\"property\":\"created_time\",\"filter\":{\"operator\":\"date_is_on_or_after\",\"value\":{\"type\":\"exact\",\"value\":{\"type\":\"date\",\"start_date\":\"2025-01-01\"}}}},{\"property\":\"attendees\",\"filter\":{\"operator\":\"person_contains\",\"value\":[{\"type\":\"exact\",\"value\":{\"table\":\"notion_user\",\"id\":\"\"}}]}}]}\n- Title contains both terms: {\"operator\":\"and\",\"filters\":[{\"property\":\"title\",\"filter\":{\"operator\":\"string_contains\",\"value\":{\"type\":\"exact\",\"value\":\"design\"}}},{\"property\":\"title\",\"filter\":{\"operator\":\"string_contains\",\"value\":{\"type\":\"exact\",\"value\":\"review\"}}}]}\n- Title contains either term: {\"operator\":\"or\",\"filters\":[{\"property\":\"title\",\"filter\":{\"operator\":\"string_contains\",\"value\":{\"type\":\"exact\",\"value\":\"standup\"}}},{\"property\":\"title\",\"filter\":{\"operator\":\"string_contains\",\"value\":{\"type\":\"exact\",\"value\":\"sync\"}}}]}", "type": "object", "properties": { "operator": { @@ -8359,18 +8863,17 @@ "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": {} }, - "outputSchema": null, - "description": "Query the current user's meeting notes data source.\n\nUse search first to resolve people IDs for attendee filters. By default, results already include meetings where the current user is an attendee or creator; do not add a current-user filte" - }, - { - "name": "notion-list-private-pages", - "title": "List private pages", "annotations": { "readOnlyHint": true, "destructiveHint": false, "idempotentHint": true, "openWorldHint": false - }, + } + }, + { + "name": "notion-list-private-pages", + "title": "List private pages", + "description": "List the current user's top-level pages and databases in their Private sidebar section. Use this to browse private workspace structure. For content searches, including keywords and titles, use search. Follow cursor pagination when the complete list is needed.", "inputSchema": { "type": "object", "properties": { @@ -8386,18 +8889,17 @@ "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false }, - "outputSchema": null, - "description": "List the current user's top-level pages and databases in their Private sidebar section. Use this to browse private workspace structure. For content searches, including keywords and titles, use ai_search when get_tool_access reports it is av" - }, - { - "name": "notion-list-shared-pages", - "title": "List shared pages", "annotations": { "readOnlyHint": true, "destructiveHint": false, "idempotentHint": true, "openWorldHint": false - }, + } + }, + { + "name": "notion-list-shared-pages", + "title": "List shared pages", + "description": "List pages and databases in the current user's Shared sidebar section. Use this to browse content shared directly with the user. For content searches, including keywords and titles, use search. Follow cursor pagination when the complete list is needed.", "inputSchema": { "type": "object", "properties": { @@ -8413,18 +8915,17 @@ "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false }, - "outputSchema": null, - "description": "List pages and databases in the current user's Shared sidebar section. Use this to browse content shared directly with the user. For content searches, including keywords and titles, use ai_search when get_tool_access reports it is available" - }, - { - "name": "notion-list-favorite-pages", - "title": "List favorite pages", "annotations": { "readOnlyHint": true, "destructiveHint": false, "idempotentHint": true, "openWorldHint": false - }, + } + }, + { + "name": "notion-list-favorite-pages", + "title": "List favorite pages", + "description": "List the current user's favorite pages and databases in sidebar order. Use this when the user refers to a favorite or pinned workspace item. Follow cursor pagination when the complete list is needed.", "inputSchema": { "type": "object", "properties": { @@ -8440,18 +8941,17 @@ "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false }, - "outputSchema": null, - "description": "List the current user's favorite pages and databases in sidebar order. Use this when the user refers to a favorite or pinned workspace item. Follow cursor pagination when the complete list is needed." - }, - { - "name": "notion-list-recent-pages", - "title": "List recent pages", "annotations": { "readOnlyHint": true, "destructiveHint": false, "idempotentHint": true, "openWorldHint": false - }, + } + }, + { + "name": "notion-list-recent-pages", + "title": "List recent pages", + "description": "List pages and databases the current user recently viewed, ranked by recency and visit frequency. Use this to recover likely navigation context when the user refers to something they were recently working on. This reflects views, not edits; to find pages the user edited, use search with filters.edited_by_user_ids: [\"me\"] and sort: \"last_edited\". Follow cursor pagination when the complete list is needed.", "inputSchema": { "type": "object", "properties": { @@ -8467,18 +8967,17 @@ "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false }, - "outputSchema": null, - "description": "List pages and databases the current user recently viewed, ranked by recency and visit frequency. Use this to recover likely navigation context when the user refers to something they were recently working on. Follow cursor pagination when t" - }, - { - "name": "notion-search-agents", - "title": "Search workspace agents", "annotations": { "readOnlyHint": true, "destructiveHint": false, "idempotentHint": true, "openWorldHint": false - }, + } + }, + { + "name": "notion-search-agents", + "title": "Search workspace agents", + "description": "Search agents by name or description, or browse the current user's favorite agents and the workspace's newest agents. Queries return one page. Without a query, follow nextCursor until it is omitted, even when a bounded workspace page is empty. Use this instead of list_agents when personal favorites or relevance-ranked search are needed.\n\nRequires Notion AI.", "inputSchema": { "type": "object", "properties": { @@ -8509,18 +9008,17 @@ "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false }, - "outputSchema": null, - "description": "Search agents by name or description, or browse the current user's favorite agents and the workspace's newest agents. Queries return one page. Without a query, follow nextCursor until it is omitted, even when a bounded workspace page is emp" - }, - { - "name": "notion-search-sessions", - "title": "Search accessible agent sessions", "annotations": { "readOnlyHint": true, "destructiveHint": false, "idempotentHint": true, "openWorldHint": false - }, + } + }, + { + "name": "notion-search-sessions", + "title": "Search accessible agent sessions", + "description": "Search past agent sessions by topic in a periodically refreshed index and return matching session URLs and excerpts. Recently created or updated sessions may not appear; use query_sessions for recent sessions.\n\nRequires Notion AI.", "inputSchema": { "type": "object", "properties": { @@ -8539,18 +9037,17 @@ "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": {} }, - "outputSchema": null, - "description": "Search past agent sessions by topic in a periodically refreshed index and return matching session URLs and excerpts. Recently created or updated sessions may not appear; use query_sessions for recent sessions.\n\nIf availability is not alread" - }, - { - "name": "notion-query-sessions", - "title": "Query accessible agent sessions", "annotations": { "readOnlyHint": true, "destructiveHint": false, "idempotentHint": true, "openWorldHint": false - }, + } + }, + { + "name": "notion-query-sessions", + "title": "Query accessible agent sessions", + "description": "List agent sessions available to the integration. Filter, sort, or search by title. A bounded page can be empty while has_more is true; follow next_cursor until has_more is false.\n\nRequires Notion AI.", "inputSchema": { "type": "object", "properties": { @@ -9817,18 +10314,17 @@ "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false }, - "outputSchema": null, - "description": "List agent sessions available to the integration. Filter, sort, or search by title. A bounded page can be empty while has_more is true; follow next_cursor until has_more is false.\n\nIf availability is not already known for this connection, c" + "annotations": { + "readOnlyHint": true, + "destructiveHint": false, + "idempotentHint": true, + "openWorldHint": false + } }, { "name": "notion-spawn-session", "title": "Start a Custom Agent session", - "annotations": { - "readOnlyHint": false, - "destructiveHint": true, - "idempotentHint": false, - "openWorldHint": false - }, + "description": "Start a session with a published Custom Agent. Use get_session_status or wait_session to check its progress.\n\nRequires Notion AI.", "inputSchema": { "type": "object", "properties": { @@ -9850,18 +10346,17 @@ "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": {} }, - "outputSchema": null, - "description": "Start a session with a published Custom Agent. Use get_session_status or wait_session to check its progress.\n\nIf availability is not already known for this connection, call get_tool_access with {} before using this tool. Reuse the returned " + "annotations": { + "readOnlyHint": false, + "destructiveHint": true, + "idempotentHint": false, + "openWorldHint": false + } }, { "name": "notion-get-session-status", "title": "Get Custom Agent session status", - "annotations": { - "readOnlyHint": true, - "destructiveHint": false, - "idempotentHint": false, - "openWorldHint": false - }, + "description": "Get the latest turn's status for a Custom Agent session without waiting.\n\nRequires Notion AI.", "inputSchema": { "type": "object", "properties": { @@ -9877,20 +10372,19 @@ "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": {} }, - "outputSchema": null, - "description": "Get the latest turn's status for a Custom Agent session without waiting.\n\nIf availability is not already known for this connection, call get_tool_access with {} before using this tool. Reuse the returned access map across tools; check the s" - }, - { - "name": "notion-wait-session", - "title": "Wait for a Custom Agent session", "annotations": { "readOnlyHint": true, "destructiveHint": false, "idempotentHint": false, "openWorldHint": false - }, - "inputSchema": { - "type": "object", + } + }, + { + "name": "notion-wait-session", + "title": "Wait for a Custom Agent session", + "description": "Wait for the latest turn in a Custom Agent session to stop running.\n\nRequires Notion AI.", + "inputSchema": { + "type": "object", "properties": { "session_url": { "type": "string", @@ -9911,18 +10405,17 @@ "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": {} }, - "outputSchema": null, - "description": "Wait for the latest turn in a Custom Agent session to stop running.\n\nIf availability is not already known for this connection, call get_tool_access with {} before using this tool. Reuse the returned access map across tools; check the status" + "annotations": { + "readOnlyHint": true, + "destructiveHint": false, + "idempotentHint": false, + "openWorldHint": false + } }, { "name": "notion-stop-session", "title": "Stop a Custom Agent session", - "annotations": { - "readOnlyHint": false, - "destructiveHint": true, - "idempotentHint": false, - "openWorldHint": false - }, + "description": "Stop a running Custom Agent session you can access.\n\nRequires Notion AI.", "inputSchema": { "type": "object", "properties": { @@ -9938,18 +10431,17 @@ "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": {} }, - "outputSchema": null, - "description": "Stop a running Custom Agent session you can access.\n\nIf availability is not already known for this connection, call get_tool_access with {} before using this tool. Reuse the returned access map across tools; check the status and restricted_" - }, - { - "name": "notion-send-message-to-session", - "title": "Send a message to a Custom Agent session", "annotations": { "readOnlyHint": false, "destructiveHint": true, "idempotentHint": false, "openWorldHint": false - }, + } + }, + { + "name": "notion-send-message-to-session", + "title": "Send a message to a Custom Agent session", + "description": "Send a follow-up message to a Custom Agent session you can access.\n\nRequires Notion AI.", "inputSchema": { "type": "object", "properties": { @@ -9971,18 +10463,17 @@ "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": {} }, - "outputSchema": null, - "description": "Send a follow-up message to a Custom Agent session you can access.\n\nIf availability is not already known for this connection, call get_tool_access with {} before using this tool. Reuse the returned access map across tools; check the status " + "annotations": { + "readOnlyHint": false, + "destructiveHint": true, + "idempotentHint": false, + "openWorldHint": false + } }, { "name": "notion-list-session-events", "title": "List Custom Agent session events", - "annotations": { - "readOnlyHint": true, - "destructiveHint": false, - "idempotentHint": false, - "openWorldHint": false - }, + "description": "List short summaries of saved events in a Custom Agent session.\n\nRequires Notion AI.", "inputSchema": { "type": "object", "properties": { @@ -10017,18 +10508,17 @@ "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": {} }, - "outputSchema": null, - "description": "List short summaries of saved events in a Custom Agent session.\n\nIf availability is not already known for this connection, call get_tool_access with {} before using this tool. Reuse the returned access map across tools; check the status and" - }, - { - "name": "notion-read-session-event", - "title": "Read a Custom Agent session event", "annotations": { "readOnlyHint": true, "destructiveHint": false, "idempotentHint": false, "openWorldHint": false - }, + } + }, + { + "name": "notion-read-session-event", + "title": "Read a Custom Agent session event", + "description": "Read the full visible content of one saved Custom Agent session event.\n\nRequires Notion AI.", "inputSchema": { "type": "object", "properties": { @@ -10051,18 +10541,17 @@ "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": {} }, - "outputSchema": null, - "description": "Read the full visible content of one saved Custom Agent session event.\n\nIf availability is not already known for this connection, call get_tool_access with {} before using this tool. Reuse the returned access map across tools; check the sta" - }, - { - "name": "notion-create-view", - "title": "Create a database view", "annotations": { - "readOnlyHint": false, + "readOnlyHint": true, "destructiveHint": false, "idempotentHint": false, "openWorldHint": false - }, + } + }, + { + "name": "notion-create-view", + "title": "Create a database view", + "description": "Create a new view on a Notion database.\n\nUse fetch first to get database_id, parent_page_id, and the collection:// data_source_id. The caller needs edit access to the database or parent page and access to the data source.\n\nProvide exactly one placement: database_id adds a view tab to that database; parent_page_id appends an inline linked database view to that page. Always provide data_source_id.\n\nSupported types: table, board, list, calendar, timeline, gallery, form, chart, map, and dashboard.\n\nThe optional configure field uses the view DSL for filters, sorts, grouping, and display. Read notion://docs/view-dsl-spec through the MCP resource interface, or pass that URI to the Notion fetch tool. Do not guess the syntax.", "inputSchema": { "type": "object", "properties": { @@ -10099,7 +10588,7 @@ "type": "string" }, "configure": { - "description": "View configuration DSL directives and examples:\n- FILTER \"Property\" = \"value\" \u2014 filter rows. Relation values must be a page URL or UUID; person values must be a user URI (user://), user UUID, or \"me\". Names are not supported for either.\n- QUICK FILTER \"Property\" \u2014 add a quick filter to the view's filter bar with no criteria; add a condition to preselect one (QUICK FILTER \"Status\" = \"Done\")\n- SORT BY \"Property\" ASC \u2014 sort rows\n- GROUP BY \"Property\" \u2014 group by property (required for board views)\n- CALENDAR BY \"Property\" \u2014 date property (required for calendar views)\n- TIMELINE BY \"Start\" TO \"End\" \u2014 date range (required for timeline views)\n- MAP BY \"Property\" \u2014 location property (required for map views)\n- CHART column|bar|line|donut|number \u2014 chart type with optional AGGREGATE, COLOR, HEIGHT, SORT, STACK BY, CAPTION\n- FORM CLOSE|OPEN \u2014 close/open form submissions\n- FORM ANONYMOUS true|false \u2014 toggle anonymous submissions\n- FORM PERMISSIONS none|reader|editor \u2014 set submission permissions\n- SHOW \"Prop1\", \"Prop2\" \u2014 set visible properties\n- COVER \"Property\" \u2014 cover image property\n\n\nSHOW \"Name\", \"Status\", \"Due Date\"\nGROUP BY \"Status\"\nFILTER \"Status\" = \"In Progress\"; SORT BY \"Due Date\" ASC\nCALENDAR BY \"Due Date\"\nTIMELINE BY \"Start\" TO \"End\"\nFILTER \"Company\" = \"Acme\"", + "description": "View configuration DSL directives and examples:\n- FILTER \"Property\" = \"value\" — filter rows. Relation values must be a page URL or UUID; person values must be a user URI (user://), user UUID, or \"me\". Names are not supported for either.\n- QUICK FILTER \"Property\" — add a quick filter to the view's filter bar with no criteria; add a condition to preselect one (QUICK FILTER \"Status\" = \"Done\")\n- SORT BY \"Property\" ASC — sort rows\n- GROUP BY \"Property\" [BY OPTION | BY GROUP] [SHOW EMPTY | HIDE EMPTY] — group by property (required for board views)\n- SUB GROUP BY \"Property\" [BY OPTION | BY GROUP] [SHOW EMPTY | HIDE EMPTY] — add board sub-grouping\n- CARD LAYOUT default | compact — set board or gallery card layout\n- CALENDAR BY \"Property\" — date property (required for calendar views)\n- TIMELINE BY \"Start\" TO \"End\" — date range (required for timeline views)\n- MAP BY \"Property\" — location property (required for map views)\n- CHART column|bar|line|donut|number — chart type with optional AGGREGATE, COLOR, HEIGHT, SORT, STACK BY, CAPTION\n- FORM CLOSE|OPEN — close/open form submissions\n- FORM ANONYMOUS true|false — toggle anonymous submissions\n- FORM PERMISSIONS none|reader|editor — set submission permissions\n- SHOW \"Prop1\", \"Prop2\" — set visible properties\n- COVER \"Property\" — cover image property\n\n\nSHOW \"Name\", \"Status\", \"Due Date\"\nGROUP BY \"Status\" BY GROUP SHOW EMPTY; SUB GROUP BY \"Priority\"; CARD LAYOUT compact\nFILTER \"Status\" = \"In Progress\"; SORT BY \"Due Date\" ASC\nCALENDAR BY \"Due Date\"\nTIMELINE BY \"Start\" TO \"End\"\nFILTER \"Company\" = \"Acme\"", "type": "string" } }, @@ -10111,18 +10600,17 @@ "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": {} }, - "outputSchema": null, - "description": "Create a new view on a Notion database.\n\nUse fetch first to get database_id, parent_page_id, and the collection:// data_source_id. The caller needs edit access to the database or parent page and access to the data source.\n\nProvide exactly o" - }, - { - "name": "notion-update-view", - "title": "Update a database view", "annotations": { "readOnlyHint": false, "destructiveHint": false, "idempotentHint": false, "openWorldHint": false - }, + } + }, + { + "name": "notion-update-view", + "title": "Update a database view", + "description": "Update a view's name, filters, sorts, or display configuration.\n\nUse \"fetch\" to get view IDs from database responses. Only include fields\nyou want to change. The \"configure\" param uses the same DSL as create_view.\nUse CLEAR to remove settings:\n- CLEAR FILTER — remove all filters\n- CLEAR QUICK FILTER — remove all quick filters, or name properties to remove only theirs (CLEAR QUICK FILTER \"Status\")\n- CLEAR SORT — remove all sorts\n- CLEAR GROUP BY — remove grouping. Boards reject it; use GROUP BY with another property instead (CLEAR SUB GROUP BY still works).\n- CLEAR SUB GROUP BY — remove board sub-grouping\n\n\nSet board or gallery card layout with CARD LAYOUT default or CARD LAYOUT compact. Status sub-groups accept BY OPTION or BY GROUP.\n\nSee notion://docs/view-dsl-spec resource for full syntax (readable via your MCP client's resource-reading interface, or by passing the URI to the Notion \"fetch\" tool).\n\n{\"view_id\": \"abc123\", \"name\": \"Sprint Board\"}\n{\"view_id\": \"abc123\", \"configure\": \"FILTER \"Status\" = \"Done\"\"}\n{\"view_id\": \"abc123\", \"configure\": \"QUICK FILTER \"Status\", \"Assignee\"\"}\n{\"view_id\": \"abc123\", \"configure\": \"CLEAR FILTER; SORT BY \"Created\" DESC\"}\n{\"view_id\": \"abc123\", \"configure\": \"GROUP BY \"Status\" BY GROUP SHOW EMPTY; SUB GROUP BY \"Priority\"; CARD LAYOUT compact\"}", "inputSchema": { "type": "object", "properties": { @@ -10135,7 +10623,7 @@ "type": "string" }, "configure": { - "description": "View configuration DSL string. Supports FILTER, QUICK FILTER, SORT BY, GROUP BY, CALENDAR BY, TIMELINE BY, MAP BY, CHART, FORM, SHOW, HIDE, COVER, WRAP CELLS, FREEZE COLUMNS, and CLEAR directives.", + "description": "View configuration DSL string. Supports FILTER, QUICK FILTER, SORT BY, GROUP BY, SUB GROUP BY, CARD LAYOUT, CALENDAR BY, TIMELINE BY, MAP BY, CHART, FORM, SHOW, HIDE, COVER, WRAP CELLS, FREEZE COLUMNS, and CLEAR directives.", "type": "string" } }, @@ -10145,112 +10633,1092 @@ "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": {} }, - "outputSchema": null, - "description": "Update a view's name, filters, sorts, or display configuration.\n\nUse \"fetch\" to get view IDs from database responses. Only include fields\nyou want to change. The \"configure\" param uses the same DSL as create_view.\nUse CLEAR to remove settin" + "annotations": { + "readOnlyHint": false, + "destructiveHint": false, + "idempotentHint": false, + "openWorldHint": false + } }, { - "name": "notion-show-advanced-analysis-next-steps", - "title": "Show the full version of Notion MCP", + "name": "notion-list-page-backlinks", + "title": "List page backlinks", + "description": "List the pages that link to or mention a Notion page (backlinks), in the same workspace. Returns IDs, titles and URLs only; fetch a result to read it. Only pages you can open are listed. Follow next_cursor for more.", + "inputSchema": { + "type": "object", + "properties": { + "page_id": { + "type": "string", + "description": "ID or URL of the page or database to find backlinks for." + }, + "types": { + "description": "Only return these kinds of backlinks. page_mention is an inline @-mention in text, a title, or a caption; link_to_page is a link-to-page block; property_mention is a mention in a database property; comment_mention is a mention in a comment. Omit for all kinds.", + "maxItems": 4, + "type": "array", + "items": { + "type": "string", + "enum": [ + "page_mention", + "link_to_page", + "property_mention", + "comment_mention" + ], + "description": "One of: `page_mention`, `link_to_page`, `property_mention`, `comment_mention`" + } + }, + "page_size": { + "description": "Maximum backlinks to return (1-100; default 25).", + "type": "integer", + "minimum": 1, + "maximum": 100 + }, + "cursor": { + "description": "next_cursor from the previous call.", + "type": "string" + } + }, + "required": [ + "page_id" + ], + "$schema": "https://json-schema.org/draft/2020-12/schema", + "additionalProperties": false + }, "annotations": { "readOnlyHint": true, "destructiveHint": false, - "idempotentHint": false, + "idempotentHint": true, "openWorldHint": false - }, + } + }, + { + "name": "notion-calendar-list-calendars", + "title": "Fetch list of calendars of the user.", + "description": "List calendars grouped by connected account. Use this to identify a target or conflict calendar before another Calendar operation.", "inputSchema": { "type": "object", - "properties": {}, + "properties": { + "onlyAccountEmails": { + "description": "Return only accounts linked to these email addresses. Useful to get calendars from a work account only for example. Do not specify if you are interested in getting the whole picture of someone's agenda across work and personal accounts.", + "type": "array", + "items": { + "type": "string" + } + } + }, "$schema": "https://json-schema.org/draft/2020-12/schema", - "default": {}, "additionalProperties": false }, - "outputSchema": { + "annotations": { + "readOnlyHint": true, + "destructiveHint": false, + "idempotentHint": false, + "openWorldHint": true + } + }, + { + "name": "notion-calendar-list-events", + "title": "List the user's events from different calendars.", + "description": "List the user's events across connected calendars within a time range. Use this to inspect the user's own schedule or identify events before changing them.", + "inputSchema": { "type": "object", "properties": { - "kind": { + "timeMin": { "type": "string", - "enum": [ - "query_multiple_data_sources_full_version", - "query_multiple_data_sources_full_version_not_displayed" - ] + "description": "Start of the time range, as an ISO 8601 date-time." }, - "action": { + "timeMax": { "type": "string", - "enum": [ - "start_trial", - "request_trial", - "learn_more" - ] + "description": "End of the time range, as an ISO 8601 date-time." }, - "client_name": { + "timeZone": { "type": "string", - "minLength": 1, - "maxLength": 64 + "description": "Date-times of returned events will be expressed in this time-zone" }, - "destination_url": { - "type": "string", - "format": "uri" + "includeDeclinedInvites": { + "description": "Whether to include event invites the user has declined", + "type": "boolean" } }, "required": [ - "kind" + "timeMin", + "timeMax", + "timeZone" ], "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false }, - "description": "Use this exactly once at the end of a turn when query_multiple_data_sources requires the full version of Notion MCP. Call with no arguments. Do not call this once per failed query, and do not call it again if it has already been called in t" - }, - { - "name": "notion-check-mcp-next-steps", - "title": "Check Notion MCP next steps", "annotations": { "readOnlyHint": true, "destructiveHint": false, "idempotentHint": false, - "openWorldHint": false - }, + "openWorldHint": true + } + }, + { + "name": "notion-calendar-list-coworkers-events", + "title": "View coworkers' scheduled events.", + "description": "List detailed events for coworkers in the same organization within a time range. Use this when event titles or context are needed, not only free/busy availability.", "inputSchema": { "type": "object", - "properties": {}, + "properties": { + "coworkerEmails": { + "description": "Emails of relevant coworkers", + "type": "array", + "items": { + "type": "string" + } + }, + "timeMin": { + "type": "string", + "description": "Start of the time range, as an ISO 8601 date-time." + }, + "timeMax": { + "type": "string", + "description": "End of the time range, as an ISO 8601 date-time." + }, + "timeZone": { + "type": "string", + "description": "Date-times of returned events will be expressed in this time-zone" + } + }, + "required": [ + "coworkerEmails", + "timeMin", + "timeMax", + "timeZone" + ], "$schema": "https://json-schema.org/draft/2020-12/schema", - "default": {}, "additionalProperties": false }, - "outputSchema": { + "annotations": { + "readOnlyHint": true, + "destructiveHint": false, + "idempotentHint": false, + "openWorldHint": true + } + }, + { + "name": "notion-calendar-list-calendar-resources", + "title": "List available calendar resources (such as conference rooms).", + "description": "List rooms or other calendar resources available for specific times. Resource discovery is scoped to the connected account of the target calendar and only works with Google Workspace accounts that have admin permissions to view Calendar resources.", + "inputSchema": { "type": "object", "properties": { - "kind": { - "type": "string", - "enum": [ - "mcp_business_education", - "mcp_business_education_not_displayed" - ] + "timeSlots": { + "description": "Specific time slots to check. Returns available resources for each time slot independently.", + "minItems": 1, + "type": "array", + "items": { + "type": "object", + "properties": { + "startAt": { + "type": "string", + "description": "Start of the time slot to check, as an ISO 8601 date-time." + }, + "endAt": { + "type": "string", + "description": "End of the time slot to check, as an ISO 8601 date-time." + } + }, + "required": [ + "startAt", + "endAt" + ], + "additionalProperties": false + } }, - "action": { - "type": "string", - "enum": [ - "start_trial", - "request_trial", - "learn_more" - ] + "minCapacity": { + "type": "integer", + "exclusiveMinimum": 0, + "maximum": 9007199254740991, + "description": "Minimum room capacity (number of people). MUST include the meeting organizer/user themselves in the count. For a 1-on-1, pass 2. For a meeting with N invitees besides the user, pass N+1." }, - "client_name": { - "type": "string", - "minLength": 1, - "maxLength": 64 + "maxCount": { + "description": "Maximum number of resources to return per time slot (default: 20, max: 40)", + "type": "integer", + "exclusiveMinimum": 0, + "maximum": 40 }, - "destination_url": { + "ignoreWorkingLocation": { + "description": "If true, do not narrow rooms to the user's working-location building for this day. Set this when the user is explicitly asking about rooms in a different office (e.g. for a visiting team).", + "type": "boolean" + }, + "timeZone": { "type": "string", - "format": "uri" + "description": "Date-times of returned events will be expressed in this time-zone" + }, + "calendar": { + "description": "Calendar of the event the rooms will be attached to. Rooms are scoped to a single account.", + "type": "object", + "properties": { + "accountId": { + "type": "string", + "description": "Account that owns the target calendar." + }, + "calendarId": { + "type": "string", + "description": "Target calendar identifier within the account." + } + }, + "required": [ + "accountId", + "calendarId" + ], + "additionalProperties": false } }, "required": [ - "kind" + "timeSlots", + "minCapacity", + "timeZone" ], "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false }, - "description": "When to call: Only when a Notion fetch result instructs you to. Finish all Notion tool calls needed for the current request, then call at most once with no arguments. Never call it per fetch or failure, without that instruction, or retry it" + "annotations": { + "readOnlyHint": true, + "destructiveHint": false, + "idempotentHint": false, + "openWorldHint": true + } + }, + { + "name": "notion-calendar-list-contacts", + "title": "List contacts", + "description": "Find contacts by name or email across the user's connected Calendar accounts. Use this to resolve attendee identities before another Calendar operation.", + "inputSchema": { + "type": "object", + "properties": { + "queries": { + "description": "Optional search queries to filter contacts by name or email. Results matching any query are included.", + "maxItems": 50, + "type": "array", + "items": { + "type": "string" + } + } + }, + "$schema": "https://json-schema.org/draft/2020-12/schema", + "additionalProperties": false + }, + "annotations": { + "readOnlyHint": true, + "destructiveHint": false, + "idempotentHint": false, + "openWorldHint": true + } + }, + { + "name": "notion-calendar-create-events", + "title": "Create calendar events.", + "description": "Create one or more events on writable calendars. Use this after the date, time, attendees, and target calendar are known. Creating events may notify attendees.", + "inputSchema": { + "type": "object", + "properties": { + "timeZone": { + "type": "string", + "description": "Date-times of returned events will be expressed in this time-zone" + }, + "events": { + "description": "Events to create.", + "maxItems": 50, + "type": "array", + "items": { + "type": "object", + "properties": { + "summary": { + "type": "string", + "minLength": 1, + "description": "Title of the event." + }, + "description": { + "description": "Description of the event.", + "type": "string" + }, + "location": { + "description": "Physical location where the event takes place, or remote conference link/info.", + "type": "string" + }, + "recurrenceRules": { + "description": "Recurrence rules in RRULE format (e.g., ['RRULE:FREQ=WEEKLY;COUNT=10']). Can also include EXDATE for exception dates (e.g., ['RRULE:FREQ=WEEKLY;COUNT=10', 'EXDATE:2026-03-24T13:00:00']).", + "type": "array", + "items": { + "type": "string" + } + }, + "period": { + "anyOf": [ + { + "type": "object", + "properties": { + "type": { + "type": "string", + "enum": [ + "DATE" + ], + "description": "Whether the event period uses all-day dates or date-times." + }, + "start": { + "type": "object", + "properties": { + "date": { + "type": "string", + "format": "date", + "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$", + "description": "Date in ISO 8601 format (no time)" + } + }, + "required": [ + "date" + ], + "additionalProperties": false, + "description": "Start of the event." + }, + "end": { + "type": "object", + "properties": { + "date": { + "type": "string", + "format": "date", + "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$", + "description": "Date in ISO 8601 format (no time)" + } + }, + "required": [ + "date" + ], + "additionalProperties": false, + "description": "End of the event." + } + }, + "required": [ + "type", + "start", + "end" + ], + "additionalProperties": false, + "description": "A date-only period, denoting an all-day event. Property `type` must be set to the exact string \"DATE\"" + }, + { + "type": "object", + "properties": { + "type": { + "type": "string", + "enum": [ + "DATE_TIME" + ], + "description": "Whether the event period uses all-day dates or date-times." + }, + "start": { + "type": "object", + "properties": { + "dateTime": { + "type": "string", + "description": "Date-time in ISO 8601 format, in UTC (ending with Z), or with TZ offset, or without TZ offset if `timeZone` is specified in which case will be interpreted as local time in that timeZone" + }, + "timeZone": { + "description": "IANA time zone for the event start date-time.", + "type": "string" + } + }, + "required": [ + "dateTime" + ], + "additionalProperties": false, + "description": "Start of the event." + }, + "end": { + "type": "object", + "properties": { + "dateTime": { + "type": "string", + "description": "Date-time in ISO 8601 format, in UTC (ending with Z), or with TZ offset, or without TZ offset if `timeZone` is specified in which case will be interpreted as local time in that timeZone" + }, + "timeZone": { + "description": "IANA time zone for the event end date-time.", + "type": "string" + } + }, + "required": [ + "dateTime" + ], + "additionalProperties": false, + "description": "End of the event." + } + }, + "required": [ + "type", + "start", + "end" + ], + "additionalProperties": false, + "description": "A date-time period, denoting an time-bound event (can span multiple days). Property `type` must be set to the exact string \"DATE_TIME\"" + } + ], + "description": "When the event is happening" + }, + "attendees": { + "description": "Attendees to invite to the event", + "type": "array", + "items": { + "type": "object", + "properties": { + "email": { + "type": "string", + "description": "Email address of the attendee." + }, + "displayName": { + "description": "Totally optional, provide only if you are sure of the attendee's name", + "type": "string" + }, + "isOptional": { + "description": "Set only if the user was explicit about an attendee not being required", + "type": "boolean" + } + }, + "required": [ + "email" + ], + "additionalProperties": false + } + }, + "resources": { + "description": "Resources (such as rooms) to invite to the event. Must be from the same account as `event.calendar`.", + "type": "array", + "items": { + "type": "object", + "properties": { + "email": { + "description": "Email address of the resource.", + "type": "string" + }, + "displayName": { + "description": "Display name of the resource.", + "type": "string" + }, + "isOptional": { + "type": "boolean", + "description": "Set only if the user was explicit about a resource not being required" + } + }, + "required": [ + "isOptional" + ], + "additionalProperties": false + } + }, + "calendar": { + "description": "Will create the event on the primary, default calendar if not specified.", + "type": "object", + "properties": { + "accountId": { + "type": "string", + "description": "Account that owns the target calendar." + }, + "calendarId": { + "type": "string", + "description": "Target calendar identifier within the account." + } + }, + "required": [ + "accountId", + "calendarId" + ], + "additionalProperties": false + }, + "disableConferencing": { + "description": "Whether to disable conferencing for this event.", + "type": "boolean" + } + }, + "required": [ + "summary", + "period" + ], + "additionalProperties": false + } + } + }, + "required": [ + "timeZone", + "events" + ], + "$schema": "https://json-schema.org/draft/2020-12/schema", + "additionalProperties": false + }, + "annotations": { + "readOnlyHint": false, + "destructiveHint": true, + "idempotentHint": false, + "openWorldHint": true + } + }, + { + "name": "notion-calendar-update-events", + "title": "Update calendar events.", + "description": "Update one or more identified events, including timing, attendees, recurrence, resources, or RSVP status. Updates require permission and may notify attendees.", + "inputSchema": { + "type": "object", + "properties": { + "timeZone": { + "type": "string", + "description": "Date-times of returned events will be expressed in this time-zone" + }, + "updates": { + "description": "Event updates to apply.", + "maxItems": 50, + "type": "array", + "items": { + "anyOf": [ + { + "type": "object", + "properties": { + "updateType": { + "type": "string", + "enum": [ + "RSVP" + ], + "description": "Must be set to the exact string \"RSVP\" in upper case." + }, + "event": { + "type": "object", + "properties": { + "calendar": { + "type": "object", + "properties": { + "accountId": { + "type": "string", + "description": "Account that owns the event calendar." + }, + "calendarId": { + "type": "string", + "description": "Event calendar identifier within the account." + } + }, + "required": [ + "accountId", + "calendarId" + ], + "additionalProperties": false, + "description": "Calendar containing the event." + }, + "eventId": { + "type": "string", + "description": "Identifier of the event to update." + }, + "eventSummary": { + "description": "Optional summary of the event, used by agent UI.", + "type": "string" + } + }, + "required": [ + "calendar", + "eventId" + ], + "additionalProperties": false, + "description": "Event to update." + }, + "rsvp": { + "type": "object", + "properties": { + "responseStatus": { + "type": "string", + "enum": [ + "needsAction", + "accepted", + "declined", + "tentative" + ], + "description": "The calendar user's RSVP status" + }, + "comment": { + "description": "Optional comment accompanying the RSVP.", + "type": "string" + } + }, + "required": [ + "responseStatus" + ], + "additionalProperties": false, + "description": "RSVP update to apply to the event." + } + }, + "required": [ + "updateType", + "event", + "rsvp" + ], + "additionalProperties": false + }, + { + "type": "object", + "properties": { + "updateType": { + "type": "string", + "enum": [ + "UPDATE" + ], + "description": "Must be set to the exact string \"UPDATE\" in upper case." + }, + "event": { + "type": "object", + "properties": { + "calendar": { + "type": "object", + "properties": { + "accountId": { + "type": "string", + "description": "Account that owns the event calendar." + }, + "calendarId": { + "type": "string", + "description": "Event calendar identifier within the account." + } + }, + "required": [ + "accountId", + "calendarId" + ], + "additionalProperties": false, + "description": "Calendar containing the event." + }, + "eventId": { + "type": "string", + "description": "Identifier of the event to update." + }, + "eventSummary": { + "description": "Optional summary of the event, used by agent UI.", + "type": "string" + } + }, + "required": [ + "calendar", + "eventId" + ], + "additionalProperties": false, + "description": "Event to update." + }, + "update": { + "type": "object", + "properties": { + "summary": { + "description": "Updated title of the event.", + "type": "string", + "minLength": 1 + }, + "description": { + "description": "Updated description of the event.", + "type": "string" + }, + "location": { + "description": "Physical location where the event takes place, or remote conference link/info.", + "type": "string" + }, + "recurrenceRules": { + "description": "Recurrence rules in RRULE format (e.g., ['RRULE:FREQ=WEEKLY;COUNT=10']). Can also include EXDATE for exception dates (e.g., ['RRULE:FREQ=WEEKLY;COUNT=10', 'EXDATE:2026-03-24T13:00:00']).", + "type": "array", + "items": { + "type": "string" + } + }, + "period": { + "description": "When the event is happening", + "anyOf": [ + { + "type": "object", + "properties": { + "type": { + "type": "string", + "enum": [ + "DATE" + ], + "description": "Whether the updated event period uses all-day dates or date-times." + }, + "start": { + "type": "object", + "properties": { + "date": { + "type": "string", + "format": "date", + "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$", + "description": "Date in ISO 8601 format (no time)" + } + }, + "required": [ + "date" + ], + "additionalProperties": false, + "description": "Updated start of the event." + }, + "end": { + "type": "object", + "properties": { + "date": { + "type": "string", + "format": "date", + "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$", + "description": "Date in ISO 8601 format (no time)" + } + }, + "required": [ + "date" + ], + "additionalProperties": false, + "description": "Updated end of the event." + } + }, + "required": [ + "type", + "start", + "end" + ], + "additionalProperties": false, + "description": "A date-only period, denoting an all-day event. Property `type` must be set to the exact string \"DATE\"" + }, + { + "type": "object", + "properties": { + "type": { + "type": "string", + "enum": [ + "DATE_TIME" + ], + "description": "Whether the updated event period uses all-day dates or date-times." + }, + "start": { + "type": "object", + "properties": { + "dateTime": { + "type": "string", + "description": "Date-time in ISO 8601 format, in UTC (ending with Z), or with TZ offset, or without TZ offset if `timeZone` is specified in which case will be interpreted as local time in that timeZone" + }, + "timeZone": { + "description": "IANA time zone for the updated event start date-time.", + "type": "string" + } + }, + "required": [ + "dateTime" + ], + "additionalProperties": false, + "description": "Updated start of the event." + }, + "end": { + "type": "object", + "properties": { + "dateTime": { + "type": "string", + "description": "Date-time in ISO 8601 format, in UTC (ending with Z), or with TZ offset, or without TZ offset if `timeZone` is specified in which case will be interpreted as local time in that timeZone" + }, + "timeZone": { + "description": "IANA time zone for the updated event end date-time.", + "type": "string" + } + }, + "required": [ + "dateTime" + ], + "additionalProperties": false, + "description": "Updated end of the event." + } + }, + "required": [ + "type", + "start", + "end" + ], + "additionalProperties": false, + "description": "A date-time period, denoting an time-bound event (can span multiple days). Property `type` must be set to the exact string \"DATE_TIME\"" + } + ] + }, + "attendees": { + "description": "Updated list of attendees for the event", + "type": "array", + "items": { + "type": "object", + "properties": { + "email": { + "type": "string", + "description": "Email address of the attendee." + }, + "displayName": { + "description": "Totally optional, provide only if you are sure of the attendee's name", + "type": "string" + }, + "isOptional": { + "description": "Set only if the user was explicit about an attendee not being required", + "type": "boolean" + } + }, + "required": [ + "email" + ], + "additionalProperties": false + } + }, + "resources": { + "description": "Updated list of resources (such as rooms) for the event. Must be from the same account as `event.calendar`.", + "type": "array", + "items": { + "type": "object", + "properties": { + "email": { + "description": "Email address of the resource.", + "type": "string" + }, + "displayName": { + "description": "Display name of the resource.", + "type": "string" + }, + "isOptional": { + "type": "boolean", + "description": "Set only if the user was explicit about a resource not being required" + } + }, + "required": [ + "isOptional" + ], + "additionalProperties": false + } + }, + "addConferencing": { + "description": "Whether to add conferencing to this event. Only adds conferencing if the event has attendees and doesn't already have conferencing.", + "type": "boolean" + } + }, + "additionalProperties": false, + "description": "Changes to apply to the event." + } + }, + "required": [ + "updateType", + "event", + "update" + ], + "additionalProperties": false + } + ] + } + } + }, + "required": [ + "timeZone", + "updates" + ], + "$schema": "https://json-schema.org/draft/2020-12/schema", + "additionalProperties": false + }, + "annotations": { + "readOnlyHint": false, + "destructiveHint": true, + "idempotentHint": false, + "openWorldHint": true + } + }, + { + "name": "notion-calendar-cancel-events", + "title": "Cancel calendar events.", + "description": "Cancel one or more identified events the user can manage. Cancellation may notify attendees. For an event the user does not organize, use calendar_update_events with updateType: \"RSVP\" instead.", + "inputSchema": { + "type": "object", + "properties": { + "events": { + "description": "Events to cancel.", + "maxItems": 50, + "type": "array", + "items": { + "type": "object", + "properties": { + "calendar": { + "type": "object", + "properties": { + "accountId": { + "type": "string", + "description": "Account that owns the event calendar." + }, + "calendarId": { + "type": "string", + "description": "Event calendar identifier within the account." + } + }, + "required": [ + "accountId", + "calendarId" + ], + "additionalProperties": false, + "description": "Calendar containing the event." + }, + "eventId": { + "type": "string", + "description": "Identifier of the event to cancel." + }, + "eventSummary": { + "description": "Optional summary of the event, used by agent UI.", + "type": "string" + } + }, + "required": [ + "calendar", + "eventId" + ], + "additionalProperties": false + } + } + }, + "required": [ + "events" + ], + "$schema": "https://json-schema.org/draft/2020-12/schema", + "additionalProperties": false + }, + "annotations": { + "readOnlyHint": false, + "destructiveHint": true, + "idempotentHint": false, + "openWorldHint": true + } + }, + { + "name": "notion-get-self", + "title": "Get current connection", + "description": "Get the current Notion connection's workspace and authenticated user. Call with {}. Returns the workspace ID and name, and the user's ID, name, type, and email when available. Use this tool to identify the connected account. To check tool availability, use get_tool_access.", + "inputSchema": { + "type": "object", + "properties": {}, + "$schema": "https://json-schema.org/draft/2020-12/schema", + "additionalProperties": false + }, + "annotations": { + "readOnlyHint": true, + "destructiveHint": false, + "idempotentHint": true, + "openWorldHint": false + } + }, + { + "name": "notion-show-advanced-analysis-next-steps", + "title": "Show the full version of Notion MCP", + "description": "Use this exactly once at the end of a turn when query_multiple_data_sources requires the full version of Notion MCP. Call with no arguments. Do not call this once per failed query, and do not call it again if it has already been called in this turn. Use the card data to give the user the relevant next-step message and destination link in the final response. Use a compact, labeled Markdown link rather than a bare URL, and do not request or create a separate link preview.", + "inputSchema": { + "type": "object", + "properties": {}, + "$schema": "https://json-schema.org/draft/2020-12/schema", + "default": {}, + "additionalProperties": false + }, + "outputSchema": { + "type": "object", + "properties": { + "kind": { + "type": "string", + "enum": [ + "query_multiple_data_sources_full_version", + "query_multiple_data_sources_full_version_not_displayed" + ] + }, + "action": { + "type": "string", + "enum": [ + "start_trial", + "request_trial", + "learn_more" + ] + }, + "client_name": { + "type": "string", + "minLength": 1, + "maxLength": 64 + }, + "destination_url": { + "type": "string", + "format": "uri" + } + }, + "required": [ + "kind" + ], + "$schema": "https://json-schema.org/draft/2020-12/schema", + "additionalProperties": false + }, + "annotations": { + "readOnlyHint": true, + "destructiveHint": false, + "idempotentHint": false, + "openWorldHint": false + }, + "_meta": { + "ui": { + "resourceUri": "ui://notion/query-multiple-data-sources-full-version-card.html", + "visibility": [ + "model" + ] + }, + "ui/resourceUri": "ui://notion/query-multiple-data-sources-full-version-card.html", + "openai/outputTemplate": "ui://notion/query-multiple-data-sources-full-version-card.html" + } + }, + { + "name": "notion-check-mcp-next-steps", + "title": "Check Notion MCP next steps", + "description": "When to call: Only when a Notion fetch result instructs you to. Finish all Notion tool calls needed for the current request, then call at most once with no arguments. Never call it per fetch or failure, without that instruction, or retry it.\n\nResult handling: If no next step is returned or rendering fails, do not retry or mention it. Otherwise, finish the user's task before the follow-up.\n\nFollow-up: Add one brief sentence grounded in the user's Notion work this session, followed by the returned destination as a compact, labeled Markdown link. You may present it as an optional Business next step for that type of work, but only claim a benefit when the tool result explicitly provides it. Do not introduce other capabilities or estimate performance or time savings. Give this follow-up once. Never mention limits, eligibility, or frequency logic. Do not give a sales pitch, tell the user to upgrade, criticize their workflow, use a bare URL, or create a link preview.", + "inputSchema": { + "type": "object", + "properties": {}, + "$schema": "https://json-schema.org/draft/2020-12/schema", + "default": {}, + "additionalProperties": false + }, + "outputSchema": { + "type": "object", + "properties": { + "kind": { + "type": "string", + "enum": [ + "mcp_business_education", + "mcp_business_education_not_displayed" + ] + }, + "action": { + "type": "string", + "enum": [ + "start_trial", + "request_trial", + "learn_more" + ] + }, + "client_name": { + "type": "string", + "minLength": 1, + "maxLength": 64 + }, + "destination_url": { + "type": "string", + "format": "uri" + } + }, + "required": [ + "kind" + ], + "$schema": "https://json-schema.org/draft/2020-12/schema", + "additionalProperties": false + }, + "annotations": { + "readOnlyHint": true, + "destructiveHint": false, + "idempotentHint": false, + "openWorldHint": false + }, + "_meta": { + "ui": { + "resourceUri": "ui://notion/mcp-business-education-card.html", + "visibility": [ + "model" + ] + }, + "ui/resourceUri": "ui://notion/mcp-business-education-card.html", + "openai/outputTemplate": "ui://notion/mcp-business-education-card.html" + } } ] -} \ No newline at end of file +} diff --git a/backend/__tests__/unit/services/hostedMcpEntry.test.js b/backend/__tests__/unit/services/hostedMcpEntry.test.js index 9a694a610c..4f7d67664c 100644 --- a/backend/__tests__/unit/services/hostedMcpEntry.test.js +++ b/backend/__tests__/unit/services/hostedMcpEntry.test.js @@ -22,7 +22,7 @@ const LINEAR_FIRST_CAPTURE = require('../../fixtures/hostedMcp/linear-tools-list const LINEAR_CAPTURE = require('../../fixtures/hostedMcp/linear-tools-list-2026-10-14.json'); const ATLASSIAN_CAPTURE = require('../../fixtures/hostedMcp/atlassian-tools-list-2026-10-09.json'); const AIRTABLE_CAPTURE = require('../../fixtures/hostedMcp/airtable-tools-list-2026-10-09.json'); -const NOTION_CAPTURE = require('../../fixtures/hostedMcp/notion-tools-list-2026-10-01.json'); +const NOTION_CAPTURE = require('../../fixtures/hostedMcp/notion-tools-list-2026-10-19.json'); const ENTRY_TEXT = 'ENTRY TEXT the pin agreed to.'; const VENDOR_TEXT = 'VENDOR TEXT nobody reviewed.'; @@ -743,8 +743,8 @@ describe('the shipped catalogue cannot land half-wired', () => { const capture = NOTION_CAPTURE; expect(entry.resource).toBe(capture.server); expect(entry.client).toBe('cimd'); - expect(entry.scopes).toEqual([capture.tokenShape.scope]); - expect(entry.tools).toHaveLength(26); + expect(entry.scopes).toEqual([capture.tokenShape.grantedScope]); + expect(entry.tools).toHaveLength(24); const measured = new Map(capture.tools.map((tool) => [tool.name, tool])); for (const tool of entry.tools) { const source = measured.get(tool.upstreamName); @@ -767,6 +767,8 @@ describe('the shipped catalogue cannot land half-wired', () => { expect(names).not.toContain('notion-send-message-to-session'); expect(names).not.toContain('notion-search-sessions'); expect(names).not.toContain('notion-upload-skill'); + expect(names).not.toContain('notion-ai-search'); + expect(names).not.toContain('notion-get-tool-access'); expect(entryToolProjections(entry).find((tool) => tool.name === 'notion.notion_move_pages')) .toMatchObject({ requiredWriteMode: 'write-with-confirm', irreversible: true }); }); diff --git a/backend/integrations/hostedMcp/notion.ts b/backend/integrations/hostedMcp/notion.ts index cc8518b5de..7984a53714 100644 --- a/backend/integrations/hostedMcp/notion.ts +++ b/backend/integrations/hostedMcp/notion.ts @@ -1,12 +1,12 @@ /** - * Notion hosted MCP entry (TASK-240). Schemas and annotations were transcribed - * from connector-ops's consenting tools/list capture at 2026-10-01T11:18:41Z. - * Re-pin against the 2026-10-19 capture before the review gate. + * Notion hosted MCP entry (TASK-240). Schemas and annotations are pinned from + * connector-ops's consenting 2026-10-19 tools/list capture. * - * Notion's agent-session and skill tools are excluded: a Commonly grant should - * act on pages and databases, not start or message a separate Notion agent. - * Destructive operations and moves keep the irreversible floor in addition to - * the hosted write-with-confirm mode. + * The 24-tool pin follows Wren's PR-thread ruling: Notion workspace tools only. + * Agent-session, skill-transfer, attachment, connected-source search, and + * tool-access catalogue calls are excluded. create-pages and update-page can + * still mark a page as a skill via is_skill, with member approval. + * Destructive writes and moves keep the irreversible floor. */ import type { HostedMcpEntry, HostedMcpPinnedTool } from '../../services/hostedMcpEntryService'; @@ -95,7 +95,7 @@ export const NOTION_ENTRY: HostedMcpEntry = { additionalProperties: false, }, created_by_user_ids: { - description: "Optional filter to only produce search results created by the Notion users that have the specified user IDs.", + description: "Optional filter to only produce search results created by the Notion users that have the specified user IDs. Use \"me\" for the connected user.", maxItems: 100, type: "array", items: { @@ -103,7 +103,7 @@ export const NOTION_ENTRY: HostedMcpEntry = { }, }, edited_by_user_ids: { - description: "Optional filter to only produce search results edited by the Notion users that have the specified user IDs. Available on the Business plan.", + description: "Optional filter to only produce search results edited by the Notion users that have the specified user IDs. Use \"me\" for the connected user. Available on the Business plan.", maxItems: 100, type: "array", items: { @@ -183,173 +183,7 @@ export const NOTION_ENTRY: HostedMcpEntry = { additionalProperties: {}, }, { readOnlyHint: true, destructiveHint: false }, - ), - pin( - "notion-ai-search", - "Search connected Notion content with Notion AI.", - 'read', - { - type: "object", - properties: { - query: { - type: "string", - description: "Exact keywords, a page title, a project name, or a concise natural-language question. Keywords are valid; a question is not required. Preserve distinctive names and identifiers. Prefer one topic per call, ideally under 50 words. Provide a non-empty query unless intentionally browsing Notion with filters or a non-relevance sort.", - }, - query_type: { - description: "Omit or use \"internal\" for content search. Use \"user\" to look up a workspace user by name or email.", - type: "string", - enum: [ - "internal", - "user", - ], - }, - data_source_url: { - description: "Optionally restrict search to a data source URL returned in a tag. Omit when searching the whole workspace.", - type: "string", - }, - page_url: { - description: "Optionally restrict search to a page and its descendants. Accepts a Notion page URL or ID. Omit when searching the whole workspace.", - type: "string", - }, - teamspace_id: { - description: "Optionally restrict search to a teamspace ID.", - type: "string", - }, - filters: { - description: "Optional exact filters for Notion pages and databases. Supplying an effective filter selects Notion-only workspace search so the filter is enforced exactly. Omit for unified search across Notion and connected sources. Keep filter fields nested here. Some filters require Business access.", - type: "object", - properties: { - created_date_range: { - description: "Optional filter to only produce search results created within the specified date range.", - type: "object", - properties: { - start_date: { - description: "The start date of the date range as an ISO 8601 date string, if any.", - type: "string", - format: "date", - pattern: "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$", - }, - end_date: { - description: "The end date of the date range as an ISO 8601 date string, if any.", - type: "string", - format: "date", - pattern: "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$", - }, - }, - additionalProperties: false, - }, - created_by_user_ids: { - description: "Optional filter to only produce search results created by the Notion users that have the specified user IDs.", - maxItems: 100, - type: "array", - items: { - type: "string", - }, - }, - edited_by_user_ids: { - description: "Optional filter to only produce search results edited by the Notion users that have the specified user IDs. Available on the Business plan.", - maxItems: 100, - type: "array", - items: { - type: "string", - }, - }, - last_edited_date_range: { - description: "Optional filter to only produce search results last edited within the specified date range. Available on the Business plan.", - type: "object", - properties: { - start_date: { - description: "The start date of the date range as an ISO 8601 date string, if any.", - type: "string", - format: "date", - pattern: "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$", - }, - end_date: { - description: "The end date of the date range as an ISO 8601 date string, if any.", - type: "string", - format: "date", - pattern: "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$", - }, - }, - additionalProperties: false, - }, - teamspace_ids: { - description: "Optional filter to only produce search results inside one of the specified teamspaces. Selecting more than one teamspace is available on the Business plan; use teamspace_id for one teamspace on other plans.", - maxItems: 100, - type: "array", - items: { - type: "string", - }, - }, - title_only: { - description: "When true, match the query only against page and database titles instead of page content. Available on the Business plan.", - type: "boolean", - }, - content_status: { - description: "Which pages to include by status. Omit for the default live pages. Supplying this field, even with the default value, requires Business access.", - type: "string", - enum: [ - "all_with_archived", - "all_without_archived", - "verified_only", - "archived_only", - ], - }, - }, - additionalProperties: false, - }, - sort: { - description: "Omit for the default \"relevance\" ordering. \"last_edited\" and \"created\" select Notion-only workspace search and require Business access.", - type: "string", - enum: [ - "relevance", - "last_edited", - "created", - ], - }, - page_size: { - description: "Maximum number of results to return (default 10).", - type: "integer", - minimum: 1, - maximum: 50, - }, - max_highlight_length: { - description: "Maximum result highlight length (default 200). Set to 0 to omit highlights.", - type: "integer", - minimum: 0, - maximum: 500, - }, - }, - required: [ - "query", - ], - $schema: "https://json-schema.org/draft/2020-12/schema", - additionalProperties: false, - }, - { readOnlyHint: true, destructiveHint: false }, - ), - pin( - "notion-get-tool-access", - "Read current Notion tool availability and search restrictions.", - 'read', - { - type: "object", - properties: { - tool_names: { - description: "Optional RunTool names to include, such as search and ai_search. Omit to return all tools visible to this connection. Unknown or unexposed names are omitted. An empty list returns an empty map.", - maxItems: 100, - type: "array", - items: { - type: "string", - minLength: 1, - maxLength: 100, - }, - }, - }, - $schema: "https://json-schema.org/draft/2020-12/schema", - additionalProperties: false, - }, - { readOnlyHint: true, destructiveHint: false }, + false, ), pin( "notion-fetch", @@ -360,7 +194,7 @@ export const NOTION_ENTRY: HostedMcpEntry = { properties: { id: { type: "string", - description: "The ID or URL of the Notion page, database, or data source to fetch. Supports notion.so URLs, Notion Sites URLs (*.notion.site), raw UUIDs, and data source URLs (collection://...). Pass a notion://docs/* URI to read that documentation resource. Also accepts an explicit saved view URL (view://...) from a database response. If a database block ID returns a validation error, use the collection:// URL from that error. Example: notion://docs/enhanced-markdown-spec.", + description: "The ID or URL of the Notion page, database, or data source to fetch. Supports notion.so URLs, Notion Sites URLs (*.notion.site), raw UUIDs, and data source URLs (collection://...). Pass \"memory\" to fetch the connected user's About page and memory database in this workspace without creating them. Pass a notion://docs/* URI to read that documentation resource. Also accepts an explicit saved view URL (view://...) from a database response. If a database block ID returns a validation error, use the collection:// URL from that error. Example: notion://docs/enhanced-markdown-spec.", }, include_transcript: { description: "Whether to include meeting note transcripts. Defaults to false. When true, full transcripts are included; when false, a placeholder with the meeting note URL is shown instead.", @@ -370,6 +204,10 @@ export const NOTION_ENTRY: HostedMcpEntry = { description: "Whether to include discussion/comment indicators in the page output. When true, adds a summary with discussion count, preview snippets, and discussion:// URLs. Use with the get_comments tool to retrieve full discussion content. Defaults to false.", type: "boolean", }, + include_file_urls: { + description: "Whether to return signed download URLs for uploaded files. Defaults to false. When false, page Markdown cites uploaded files by stable notion-file-block:// references and the response has no references map; call get_file_download_urls with the references when you need those files' contents. When true, the response's references map gives the signed URL for each reference.", + type: "boolean", + }, }, required: [ "id", @@ -378,6 +216,7 @@ export const NOTION_ENTRY: HostedMcpEntry = { additionalProperties: {}, }, { readOnlyHint: true, destructiveHint: false }, + false, ), pin( "notion-create-pages", @@ -456,8 +295,15 @@ export const NOTION_ENTRY: HostedMcpEntry = { ], }, parent: { - description: "All pages in one call share this parent. Otherwise use a page (page_id), database page (database_id), or data source (data_source_id). A database_id cannot be used when the database has more than one data source; fetch it and use the right collection:// URL as data_source_id. If omitted, pages are private at the workspace level. When no destination is named, prefer explicit \"creation_mode\": \"draft\" over omitting the parent.", + description: "All pages in one call share this parent. Pass \"memory\" to save a personal memory; see notion://docs/memory. Otherwise use a page (page_id), database page (database_id), data source (data_source_id), or teamspace root (teamspace_id, from get_teams). Teamspace roots require a user-backed connection and permission to add top-level pages. A database_id cannot be used when the database has more than one data source; fetch it and use the right collection:// URL as data_source_id. If omitted, pages are private at the workspace level. When no destination is named, prefer explicit \"creation_mode\": \"draft\" over omitting the parent.", anyOf: [ + { + type: "string", + enum: [ + "memory", + ], + description: "Always `memory`", + }, { type: "object", properties: { @@ -518,6 +364,19 @@ export const NOTION_ENTRY: HostedMcpEntry = { ], additionalProperties: {}, }, + { + type: "object", + properties: { + teamspace_id: { + type: "string", + description: "The ID of the teamspace in which to create top-level pages (with or without dashes).", + }, + }, + required: [ + "teamspace_id", + ], + additionalProperties: false, + }, ], }, allow_async: { @@ -532,6 +391,7 @@ export const NOTION_ENTRY: HostedMcpEntry = { additionalProperties: {}, }, { readOnlyHint: false, destructiveHint: false }, + false, ), pin( "notion-update-page", @@ -627,7 +487,7 @@ export const NOTION_ENTRY: HostedMcpEntry = { type: "string", }, content_updates: { - description: "Required for \"update_content\" command. An array of search-and-replace operations, each with old_str (content to find) and new_str (replacement content).", + description: "Required for \"update_content\" command. An array of search-and-replace operations, each with old_str (content to find) and new_str (replacement content). Operations that match are applied, and each one that matches nothing is reported in \"warnings\". The call fails only when no operation that changes content matches.", maxItems: 100, type: "array", items: { @@ -867,6 +727,7 @@ export const NOTION_ENTRY: HostedMcpEntry = { additionalProperties: {}, }, { readOnlyHint: false, destructiveHint: false }, + false, ), pin( "notion-create-database", @@ -905,7 +766,7 @@ export const NOTION_ENTRY: HostedMcpEntry = { type: "string", }, schema: { - description: "SQL DDL CREATE TABLE statement defining the database schema. Cannot be combined with database_type. Column names must be double-quoted and type options use single quotes.\n\nProperty type syntax:\n- Simple: TITLE, RICH_TEXT, DATE, PEOPLE, CHECKBOX, URL, EMAIL, PHONE_NUMBER, STATUS, FILES\n- SELECT('opt':color, ...) / MULTI_SELECT('opt':color, ...)\n- NUMBER [FORMAT 'dollar'] / FORMULA('expression')\n- RELATION('ds') for a one-way relation\n- RELATION('ds', DUAL) for a two-way relation\n- RELATION('ds', DUAL 'Children') with a synced property name\n- RELATION('ds', DUAL 'Children' 'children') with a synced name and synced_id (for self-relations)\n- ROLLUP('rel_prop', 'target_prop', 'function')\n- UNIQUE_ID [PREFIX 'X'] / CREATED_TIME / LAST_EDITED_TIME\n- Any column: COMMENT 'description text' Colors: default, gray, brown, orange, yellow, green, blue, purple, pink, red.\n\n\nExamples:\n- Minimal: CREATE TABLE (\"Name\" TITLE)\n- With options: CREATE TABLE (\"Name\" TITLE, \"Budget\" NUMBER FORMAT 'dollar', \"Tags\" MULTI_SELECT('eng':blue, 'design':pink), \"Task ID\" UNIQUE_ID PREFIX 'PRJ')\n- Self-relations are a two-step flow: create the database, then use its data source ID with update_data_source to add paired properties such as RELATION('ds', DUAL 'Children' 'children').", + description: "SQL DDL CREATE TABLE statement defining the database schema. Cannot be combined with database_type. Column names must be double-quoted and type options use single quotes.\n\nProperty type syntax:\n- Simple: TITLE, RICH_TEXT, DATE, PEOPLE, CHECKBOX, URL, EMAIL, PHONE_NUMBER, FILES\n- SELECT('opt':color, ...) / MULTI_SELECT('opt':color, ...)\n- STATUS('Backlog':gray:to_do, 'Building':blue:in_progress, 'Shipped':green:complete); groups are to_do, in_progress, complete\n- NUMBER [FORMAT 'dollar'] / FORMULA('expression')\n- RELATION('ds') for a one-way relation\n- RELATION('ds', DUAL) for a two-way relation\n- RELATION('ds', DUAL 'Children') with a synced property name\n- RELATION('ds', DUAL 'Children' 'children') with a synced name and synced_id (for self-relations)\n- ROLLUP('rel_prop', 'target_prop', 'function')\n- UNIQUE_ID [PREFIX 'X'] / CREATED_TIME / LAST_EDITED_TIME\n- Any column: COMMENT 'description text' Colors: default, gray, brown, orange, yellow, green, blue, purple, pink, red.\n\n\nExamples:\n- Minimal: CREATE TABLE (\"Name\" TITLE)\n- With options: CREATE TABLE (\"Name\" TITLE, \"Budget\" NUMBER FORMAT 'dollar', \"Tags\" MULTI_SELECT('eng':blue, 'design':pink), \"Task ID\" UNIQUE_ID PREFIX 'PRJ')\n- Self-relations are a two-step flow: create the database, then use its data source ID with update_data_source to add paired properties such as RELATION('ds', DUAL 'Children' 'children').", type: "string", }, database_type: { @@ -922,6 +783,7 @@ export const NOTION_ENTRY: HostedMcpEntry = { additionalProperties: {}, }, { readOnlyHint: false, destructiveHint: false }, + false, ), pin( "notion-create-folder", @@ -974,6 +836,7 @@ export const NOTION_ENTRY: HostedMcpEntry = { additionalProperties: {}, }, { readOnlyHint: false, destructiveHint: false }, + false, ), pin( "notion-update-folder", @@ -1040,7 +903,7 @@ export const NOTION_ENTRY: HostedMcpEntry = { description: "The data source to update. Accepts a collection:// URI from tags, a bare UUID, or a database ID (only if the database has a single data source).", }, statements: { - description: "Semicolon-separated SQL DDL statements to update the schema. Supports ADD COLUMN, DROP COLUMN, RENAME COLUMN, and ALTER COLUMN SET.\n\nProperty type syntax:\n- Simple: TITLE, RICH_TEXT, DATE, PEOPLE, CHECKBOX, URL, EMAIL, PHONE_NUMBER, STATUS, FILES\n- SELECT('opt':color, ...) / MULTI_SELECT('opt':color, ...)\n- NUMBER [FORMAT 'dollar'] / FORMULA('expression')\n- RELATION('ds') for a one-way relation\n- RELATION('ds', DUAL) for a two-way relation\n- RELATION('ds', DUAL 'Children') with a synced property name\n- RELATION('ds', DUAL 'Children' 'children') with a synced name and synced_id (for self-relations)\n- ROLLUP('rel_prop', 'target_prop', 'function')\n- UNIQUE_ID [PREFIX 'X'] / CREATED_TIME / LAST_EDITED_TIME\n- Any column: COMMENT 'description text' Colors: default, gray, brown, orange, yellow, green, blue, purple, pink, red.\n\n\nExamples:\n- ADD COLUMN \"Priority\" SELECT('High':red, 'Medium':yellow, 'Low':green); ADD COLUMN \"Due Date\" DATE\n- RENAME COLUMN \"Status\" TO \"Project Status\"\n- DROP COLUMN \"Old Property\"\n- For a self-relation, add both relation properties in one call with matching DUAL names and IDs, such as ADD COLUMN \"Parent\" RELATION('ds', DUAL 'Children' 'children').", + description: "Semicolon-separated SQL DDL statements to update the schema. Supports ADD COLUMN, DROP COLUMN, RENAME COLUMN, and ALTER COLUMN SET.\n\nProperty type syntax:\n- Simple: TITLE, RICH_TEXT, DATE, PEOPLE, CHECKBOX, URL, EMAIL, PHONE_NUMBER, FILES\n- SELECT('opt':color, ...) / MULTI_SELECT('opt':color, ...)\n- STATUS('Backlog':gray:to_do, 'Building':blue:in_progress, 'Shipped':green:complete); groups are to_do, in_progress, complete\n- NUMBER [FORMAT 'dollar'] / FORMULA('expression')\n- RELATION('ds') for a one-way relation\n- RELATION('ds', DUAL) for a two-way relation\n- RELATION('ds', DUAL 'Children') with a synced property name\n- RELATION('ds', DUAL 'Children' 'children') with a synced name and synced_id (for self-relations)\n- ROLLUP('rel_prop', 'target_prop', 'function')\n- UNIQUE_ID [PREFIX 'X'] / CREATED_TIME / LAST_EDITED_TIME\n- Any column: COMMENT 'description text' Colors: default, gray, brown, orange, yellow, green, blue, purple, pink, red.\n\n\nExamples:\n- ADD COLUMN \"Priority\" SELECT('High':red, 'Medium':yellow, 'Low':green); ADD COLUMN \"Due Date\" DATE\n- RENAME COLUMN \"Status\" TO \"Project Status\"\n- DROP COLUMN \"Old Property\"\n- For a self-relation, add both relation properties in one call with matching DUAL names and IDs, such as ADD COLUMN \"Parent\" RELATION('ds', DUAL 'Children' 'children').", type: "string", }, title: { @@ -1074,7 +937,6 @@ export const NOTION_ENTRY: HostedMcpEntry = { type: "string", enum: [ "cover", - "properties", "editor", "discussions", "relations", @@ -1090,6 +952,111 @@ export const NOTION_ENTRY: HostedMcpEntry = { ], additionalProperties: false, }, + { + type: "object", + properties: { + type: { + type: "string", + enum: [ + "properties", + ], + description: "The module type.", + }, + properties: { + description: "Properties in order. Unlisted properties follow in their current order and show. Don't list the title or properties placed elsewhere in the layout.", + type: "array", + items: { + type: "object", + properties: { + property: { + type: "string", + description: "The property name.", + }, + visibility: { + description: "Defaults to show. Changes how pages look, not who can see the value.", + type: "string", + enum: [ + "show", + "hide_if_empty", + "hide", + ], + }, + }, + required: [ + "property", + ], + additionalProperties: false, + }, + }, + }, + required: [ + "type", + ], + additionalProperties: false, + }, + { + type: "object", + properties: { + type: { + type: "string", + enum: [ + "properties", + ], + description: "The module type.", + }, + sections: { + minItems: 1, + type: "array", + items: { + type: "object", + properties: { + name: { + type: "string", + minLength: 1, + description: "The section name.", + }, + properties: { + type: "array", + items: { + type: "object", + properties: { + property: { + type: "string", + description: "The property name.", + }, + visibility: { + description: "Defaults to show. Changes how pages look, not who can see the value.", + type: "string", + enum: [ + "show", + "hide_if_empty", + "hide", + ], + }, + }, + required: [ + "property", + ], + additionalProperties: false, + }, + description: "Properties in this section, in order. Don't list the title or properties placed elsewhere in the layout.", + }, + }, + required: [ + "name", + "properties", + ], + additionalProperties: false, + }, + description: "Named sections in order. Unlisted properties go in the last section and show.", + }, + }, + required: [ + "type", + "sections", + ], + additionalProperties: false, + }, { type: "object", properties: { @@ -1206,12 +1173,101 @@ export const NOTION_ENTRY: HostedMcpEntry = { ], description: "The module type.", }, + properties: { + description: "Properties in order. Unlisted properties follow in their current order and show. Don't list the title or properties placed elsewhere in the layout.", + type: "array", + items: { + type: "object", + properties: { + property: { + type: "string", + description: "The property name.", + }, + visibility: { + description: "Defaults to show. Changes how pages look, not who can see the value.", + type: "string", + enum: [ + "show", + "hide_if_empty", + "hide", + ], + }, + }, + required: [ + "property", + ], + additionalProperties: false, + }, + }, }, required: [ "type", ], additionalProperties: false, }, + { + type: "object", + properties: { + type: { + type: "string", + enum: [ + "properties", + ], + description: "The module type.", + }, + sections: { + minItems: 1, + type: "array", + items: { + type: "object", + properties: { + name: { + type: "string", + minLength: 1, + description: "The section name.", + }, + properties: { + type: "array", + items: { + type: "object", + properties: { + property: { + type: "string", + description: "The property name.", + }, + visibility: { + description: "Defaults to show. Changes how pages look, not who can see the value.", + type: "string", + enum: [ + "show", + "hide_if_empty", + "hide", + ], + }, + }, + required: [ + "property", + ], + additionalProperties: false, + }, + description: "Properties in this section, in order. Don't list the title or properties placed elsewhere in the layout.", + }, + }, + required: [ + "name", + "properties", + ], + additionalProperties: false, + }, + description: "Named sections in order. Unlisted properties go in the last section and show.", + }, + }, + required: [ + "type", + "sections", + ], + additionalProperties: false, + }, { type: "object", properties: { @@ -1278,7 +1334,6 @@ export const NOTION_ENTRY: HostedMcpEntry = { type: { type: "string", enum: [ - "properties", "editor", "discussions", "relations", @@ -1291,6 +1346,111 @@ export const NOTION_ENTRY: HostedMcpEntry = { ], additionalProperties: false, }, + { + type: "object", + properties: { + type: { + type: "string", + enum: [ + "properties", + ], + description: "The module type.", + }, + properties: { + description: "Properties in order. Unlisted properties follow in their current order and show. Don't list the title or properties placed elsewhere in the layout.", + type: "array", + items: { + type: "object", + properties: { + property: { + type: "string", + description: "The property name.", + }, + visibility: { + description: "Defaults to show. Changes how pages look, not who can see the value.", + type: "string", + enum: [ + "show", + "hide_if_empty", + "hide", + ], + }, + }, + required: [ + "property", + ], + additionalProperties: false, + }, + }, + }, + required: [ + "type", + ], + additionalProperties: false, + }, + { + type: "object", + properties: { + type: { + type: "string", + enum: [ + "properties", + ], + description: "The module type.", + }, + sections: { + minItems: 1, + type: "array", + items: { + type: "object", + properties: { + name: { + type: "string", + minLength: 1, + description: "The section name.", + }, + properties: { + type: "array", + items: { + type: "object", + properties: { + property: { + type: "string", + description: "The property name.", + }, + visibility: { + description: "Defaults to show. Changes how pages look, not who can see the value.", + type: "string", + enum: [ + "show", + "hide_if_empty", + "hide", + ], + }, + }, + required: [ + "property", + ], + additionalProperties: false, + }, + description: "Properties in this section, in order. Don't list the title or properties placed elsewhere in the layout.", + }, + }, + required: [ + "name", + "properties", + ], + additionalProperties: false, + }, + description: "Named sections in order. Unlisted properties go in the last section and show.", + }, + }, + required: [ + "type", + "sections", + ], + additionalProperties: false, + }, { type: "object", properties: { @@ -1392,12 +1552,16 @@ export const NOTION_ENTRY: HostedMcpEntry = { type: "string", description: "The ID of the page to comment on (with or without dashes).", }, + reply_to_comment_id: { + description: "The ID of the comment to reply to.", + type: "string", + }, discussion_id: { description: "The ID or URL of an existing discussion to reply to (e.g., discussion://pageId/blockId/discussionId).", type: "string", }, selection_with_ellipsis: { - description: "Unique start and end snippet of the content to comment on. DO NOT provide the entire string. Instead, provide up to the first ~10 characters, an ellipsis, and then up to the last ~10 characters. Make sure you provide enough of the start and end snippet to uniquely identify the content. For example: \"# Section heading...last paragraph.\"", + description: "Unique content snippet: ~10 characters from each end, joined by \"...\". A match within one block's text gets an inline comment on that text; otherwise, comment on the block where the match starts. No match returns an error.", type: "string", }, rich_text: { @@ -1824,6 +1988,7 @@ export const NOTION_ENTRY: HostedMcpEntry = { additionalProperties: {}, }, { readOnlyHint: false, destructiveHint: false }, + false, ), pin( "notion-get-comments", @@ -1856,6 +2021,7 @@ export const NOTION_ENTRY: HostedMcpEntry = { additionalProperties: {}, }, { readOnlyHint: true, destructiveHint: false }, + false, ), pin( "notion-get-async-task", @@ -1877,6 +2043,7 @@ export const NOTION_ENTRY: HostedMcpEntry = { additionalProperties: {}, }, { readOnlyHint: true, destructiveHint: false }, + false, ), pin( "notion-get-teams", @@ -1896,6 +2063,7 @@ export const NOTION_ENTRY: HostedMcpEntry = { additionalProperties: {}, }, { readOnlyHint: true, destructiveHint: false }, + false, ), pin( "notion-get-users", @@ -1932,6 +2100,7 @@ export const NOTION_ENTRY: HostedMcpEntry = { additionalProperties: {}, }, { readOnlyHint: true, destructiveHint: false }, + false, ), pin( "notion-query-data-sources", @@ -1941,7 +2110,7 @@ export const NOTION_ENTRY: HostedMcpEntry = { type: "object", properties: { data: { - description: "Mode parameter reference and examples.\n\nSQL mode:\n- Checkbox values: use \"__YES__\" for checked, \"__NO__\" for unchecked\n\n\nRows mode: Return up to 100 rows with faithful rich-text property values and optional structured filters and sorts.\n\nExample:\n{\"mode\":\"rows\",\"data_source_url\":\"collection://f336d0bc-b841-465b-8045-024475c079dd\",\"filter\":{\"type\":\"group\",\"operator\":\"and\",\"filters\":[{\"type\":\"property\",\"property\":\"Status\",\"propertyType\":\"select\",\"operator\":\"enum_is\",\"value\":{\"type\":\"exact\",\"value\":\"In Progress\"}}]},\"limit\":20}\n\nExamples:\n- Simple SQL: {\"data_source_urls\":[\"collection://f336d0bc-b841-465b-8045-024475c079dd\"],\"query\":\"SELECT * FROM [collection://f336d0bc-b841-465b-8045-024475c079dd] LIMIT 10\"}\n- SQL parameters: {\"mode\":\"sql\",\"data_source_urls\":[\"collection://abc123\"],\"query\":\"SELECT * FROM [collection://abc123] WHERE Status = ? AND Priority = ?\",\"params\":[\"In Progress\",\"High\"]}\n- Checkbox query: {\"data_source_urls\":[\"collection://def456\"],\"query\":\"SELECT * FROM [collection://def456] WHERE Completed = ?\",\"params\":[\"__YES__\"]}\n\nView mode: Execute a specific database view's query with its filters and sorts. Omit \"is_archived\" or set it to false for non-archived rows. Set \"is_archived\": true to apply the view inside the archived partition. When the response has \"has_more\": true, pass its \"next_cursor\" as \"start_cursor\" in a follow-up view-mode request with the same \"is_archived\" value.\n\nExample:\n{\"mode\":\"view\",\"view_url\":\"https://www.notion.so/workspace/Tasks-DB-abc123?v=def456\",\"is_archived\":false}", + description: "Mode parameter reference and examples.\n\nSQL mode:\n- Use single quotes for SQL string values, such as `\"Status\" = 'Done'`. Use double quotes for table and column names. In SQL, `''` is an empty string.\n- Prefer `?` placeholders for values. For text values, the `params` array uses JSON strings, so `[\"\"]` passes an empty string and `[\"__YES__\"]` passes a checked checkbox value. Do not add SQL quote marks around a bound value.\n- Checkbox SQL values: `'__YES__'` means checked; `'__NO__'` means unchecked.\n\n\nRows mode: Return up to 100 rows with faithful rich-text property values and optional structured filters and sorts.\n\nExample:\n{\"mode\":\"rows\",\"data_source_url\":\"collection://f336d0bc-b841-465b-8045-024475c079dd\",\"filter\":{\"type\":\"group\",\"operator\":\"and\",\"filters\":[{\"type\":\"property\",\"property\":\"Status\",\"propertyType\":\"select\",\"operator\":\"enum_is\",\"value\":{\"type\":\"exact\",\"value\":\"In Progress\"}}]},\"limit\":20}\n\nExamples:\n- Simple SQL: {\"data_source_urls\":[\"collection://f336d0bc-b841-465b-8045-024475c079dd\"],\"query\":\"SELECT * FROM [collection://f336d0bc-b841-465b-8045-024475c079dd] LIMIT 10\"}\n- SQL parameters: {\"mode\":\"sql\",\"data_source_urls\":[\"collection://abc123\"],\"query\":\"SELECT * FROM [collection://abc123] WHERE Status = ? AND Priority = ?\",\"params\":[\"In Progress\",\"High\"]}\n- Checkbox query: {\"data_source_urls\":[\"collection://def456\"],\"query\":\"SELECT * FROM [collection://def456] WHERE Completed = ?\",\"params\":[\"__YES__\"]}\n\nView mode: Execute a specific database view's query with its filters and sorts. Omit \"is_archived\" or set it to false for non-archived rows. Set \"is_archived\": true to apply the view inside the archived partition. When the response has \"has_more\": true, pass its \"next_cursor\" as \"start_cursor\" in a follow-up view-mode request with the same \"is_archived\" value.\n\nExample:\n{\"mode\":\"view\",\"view_url\":\"https://www.notion.so/workspace/Tasks-DB-abc123?v=def456\",\"is_archived\":false}", anyOf: [ { type: "object", @@ -1956,7 +2125,7 @@ export const NOTION_ENTRY: HostedMcpEntry = { }, query: { type: "string", - description: "Read-only SQLite query to execute against the data sources. Use a data source URL as the table name, e.g. SELECT * FROM \"collection://...\" WHERE .... Include every needed filter in WHERE (filters on views of the data source are not automatically applied). For time comparisons or ordering, normalize text timestamps with datetime(...) or date(...). SQL text values can omit rich-text mentions and formatting, and links can lose their destination. Use faithful rows mode or fetch the page before rewriting a rich-text property.", + description: "Read-only SQLite query to execute against the data sources. Use a data source URL as the table name, e.g. SELECT * FROM \"collection://...\" WHERE .... Use only table and column names shown in the fetched `` definition; date properties use the expanded column names listed there, not the base name. Include every needed filter in WHERE (filters on views of the data source are not automatically applied). For time comparisons or ordering, normalize text timestamps with datetime(...) or date(...). SQL text values can omit rich-text mentions and formatting, and links can lose their destination. Use faithful rows mode or fetch the page before rewriting a rich-text property.", }, mode: { description: "Optional mode parameter. Defaults to 'sql' if not specified. SQL mode does not accept is_archived; that parameter belongs only to view mode.", @@ -6909,6 +7078,7 @@ export const NOTION_ENTRY: HostedMcpEntry = { additionalProperties: {}, }, { readOnlyHint: true, destructiveHint: false }, + false, ), pin( "notion-query-multiple-data-sources", @@ -6919,7 +7089,7 @@ export const NOTION_ENTRY: HostedMcpEntry = { properties: { query: { type: "string", - description: "Read-only SQLite query to execute against the data sources. Use a data source URL as the table name, e.g. SELECT * FROM \"collection://...\" WHERE .... Include every needed filter in WHERE (filters on views of the data source are not automatically applied). For time comparisons or ordering, normalize text timestamps with datetime(...) or date(...). SQL text values can omit rich-text mentions and formatting, and links can lose their destination. Use faithful rows mode or fetch the page before rewriting a rich-text property.", + description: "Read-only SQLite query to execute against the data sources. Use a data source URL as the table name, e.g. SELECT * FROM \"collection://...\" WHERE .... Use only table and column names shown in the fetched `` definition; date properties use the expanded column names listed there, not the base name. Include every needed filter in WHERE (filters on views of the data source are not automatically applied). For time comparisons or ordering, normalize text timestamps with datetime(...) or date(...). SQL text values can omit rich-text mentions and formatting, and links can lose their destination. Use faithful rows mode or fetch the page before rewriting a rich-text property.", }, data_source_urls: { description: "Notion data source URLs whose SQLite tables are available to the query; each data source is exposed as a table named by its URL. Obtain them from the fetch tool, in the format: collection://f336d0bc-b841-465b-8045-024475c079dd", @@ -6967,6 +7137,7 @@ export const NOTION_ENTRY: HostedMcpEntry = { additionalProperties: false, }, { readOnlyHint: true, destructiveHint: false }, + false, ), pin( "notion-query-meeting-notes", @@ -8042,6 +8213,7 @@ export const NOTION_ENTRY: HostedMcpEntry = { additionalProperties: {}, }, { readOnlyHint: true, destructiveHint: false }, + false, ), pin( "notion-list-private-pages", @@ -8063,6 +8235,7 @@ export const NOTION_ENTRY: HostedMcpEntry = { additionalProperties: false, }, { readOnlyHint: true, destructiveHint: false }, + false, ), pin( "notion-list-shared-pages", @@ -8084,6 +8257,7 @@ export const NOTION_ENTRY: HostedMcpEntry = { additionalProperties: false, }, { readOnlyHint: true, destructiveHint: false }, + false, ), pin( "notion-list-favorite-pages", @@ -8105,6 +8279,7 @@ export const NOTION_ENTRY: HostedMcpEntry = { additionalProperties: false, }, { readOnlyHint: true, destructiveHint: false }, + false, ), pin( "notion-list-recent-pages", @@ -8126,6 +8301,7 @@ export const NOTION_ENTRY: HostedMcpEntry = { additionalProperties: false, }, { readOnlyHint: true, destructiveHint: false }, + false, ), pin( "notion-create-view", @@ -8167,7 +8343,7 @@ export const NOTION_ENTRY: HostedMcpEntry = { type: "string", }, configure: { - description: "View configuration DSL directives and examples:\n- FILTER \"Property\" = \"value\" — filter rows. Relation values must be a page URL or UUID; person values must be a user URI (user://), user UUID, or \"me\". Names are not supported for either.\n- QUICK FILTER \"Property\" — add a quick filter to the view's filter bar with no criteria; add a condition to preselect one (QUICK FILTER \"Status\" = \"Done\")\n- SORT BY \"Property\" ASC — sort rows\n- GROUP BY \"Property\" — group by property (required for board views)\n- CALENDAR BY \"Property\" — date property (required for calendar views)\n- TIMELINE BY \"Start\" TO \"End\" — date range (required for timeline views)\n- MAP BY \"Property\" — location property (required for map views)\n- CHART column|bar|line|donut|number — chart type with optional AGGREGATE, COLOR, HEIGHT, SORT, STACK BY, CAPTION\n- FORM CLOSE|OPEN — close/open form submissions\n- FORM ANONYMOUS true|false — toggle anonymous submissions\n- FORM PERMISSIONS none|reader|editor — set submission permissions\n- SHOW \"Prop1\", \"Prop2\" — set visible properties\n- COVER \"Property\" — cover image property\n\n\nSHOW \"Name\", \"Status\", \"Due Date\"\nGROUP BY \"Status\"\nFILTER \"Status\" = \"In Progress\"; SORT BY \"Due Date\" ASC\nCALENDAR BY \"Due Date\"\nTIMELINE BY \"Start\" TO \"End\"\nFILTER \"Company\" = \"Acme\"", + description: "View configuration DSL directives and examples:\n- FILTER \"Property\" = \"value\" — filter rows. Relation values must be a page URL or UUID; person values must be a user URI (user://), user UUID, or \"me\". Names are not supported for either.\n- QUICK FILTER \"Property\" — add a quick filter to the view's filter bar with no criteria; add a condition to preselect one (QUICK FILTER \"Status\" = \"Done\")\n- SORT BY \"Property\" ASC — sort rows\n- GROUP BY \"Property\" [BY OPTION | BY GROUP] [SHOW EMPTY | HIDE EMPTY] — group by property (required for board views)\n- SUB GROUP BY \"Property\" [BY OPTION | BY GROUP] [SHOW EMPTY | HIDE EMPTY] — add board sub-grouping\n- CARD LAYOUT default | compact — set board or gallery card layout\n- CALENDAR BY \"Property\" — date property (required for calendar views)\n- TIMELINE BY \"Start\" TO \"End\" — date range (required for timeline views)\n- MAP BY \"Property\" — location property (required for map views)\n- CHART column|bar|line|donut|number — chart type with optional AGGREGATE, COLOR, HEIGHT, SORT, STACK BY, CAPTION\n- FORM CLOSE|OPEN — close/open form submissions\n- FORM ANONYMOUS true|false — toggle anonymous submissions\n- FORM PERMISSIONS none|reader|editor — set submission permissions\n- SHOW \"Prop1\", \"Prop2\" — set visible properties\n- COVER \"Property\" — cover image property\n\n\nSHOW \"Name\", \"Status\", \"Due Date\"\nGROUP BY \"Status\" BY GROUP SHOW EMPTY; SUB GROUP BY \"Priority\"; CARD LAYOUT compact\nFILTER \"Status\" = \"In Progress\"; SORT BY \"Due Date\" ASC\nCALENDAR BY \"Due Date\"\nTIMELINE BY \"Start\" TO \"End\"\nFILTER \"Company\" = \"Acme\"", type: "string", }, }, @@ -8180,6 +8356,7 @@ export const NOTION_ENTRY: HostedMcpEntry = { additionalProperties: {}, }, { readOnlyHint: false, destructiveHint: false }, + false, ), pin( "notion-update-view", @@ -8197,7 +8374,7 @@ export const NOTION_ENTRY: HostedMcpEntry = { type: "string", }, configure: { - description: "View configuration DSL string. Supports FILTER, QUICK FILTER, SORT BY, GROUP BY, CALENDAR BY, TIMELINE BY, MAP BY, CHART, FORM, SHOW, HIDE, COVER, WRAP CELLS, FREEZE COLUMNS, and CLEAR directives.", + description: "View configuration DSL string. Supports FILTER, QUICK FILTER, SORT BY, GROUP BY, SUB GROUP BY, CARD LAYOUT, CALENDAR BY, TIMELINE BY, MAP BY, CHART, FORM, SHOW, HIDE, COVER, WRAP CELLS, FREEZE COLUMNS, and CLEAR directives.", type: "string", }, }, @@ -8208,6 +8385,7 @@ export const NOTION_ENTRY: HostedMcpEntry = { additionalProperties: {}, }, { readOnlyHint: false, destructiveHint: false }, + false, ), ], }; diff --git a/frontend/src/v2/icons/platforms/index.tsx b/frontend/src/v2/icons/platforms/index.tsx index a0bfeefcca..9e727b4171 100644 --- a/frontend/src/v2/icons/platforms/index.tsx +++ b/frontend/src/v2/icons/platforms/index.tsx @@ -71,6 +71,14 @@ const Airtable = () => ( ); +// Original monochrome drawing of a page with an N, inheriting the row's ink. +const Notion = () => ( + + + + +); + // Original Commonly drawing; no third-party glyph or licensed asset. This is // a simplified calendar symbol, not Google's trademarked brand mark. const GoogleCalendar = () => ( @@ -86,6 +94,7 @@ export const PLATFORM_GLYPHS: Record = { 'google-calendar': GoogleCalendar, atlassian: Atlassian, airtable: Airtable, + notion: Notion, telegram: Telegram, slack: Slack, discord: Discord, From c1e689b8f0a863dde49fade7d24d8f1a38b22784 Mon Sep 17 00:00:00 2001 From: Lily Shen <115414357+lilyshen0722@users.noreply.github.com> Date: Mon, 19 Oct 2026 02:46:12 -0700 Subject: [PATCH 3/4] fix(connectors): mark Notion view updates irreversible Co-authored-by: forge Agent-Model: codex/gpt-6-sol/medium --- .../unit/services/hostedMcpEntry.test.js | 20 ++++++++++++++++++- backend/integrations/hostedMcp/notion.ts | 19 ++++++++++++------ 2 files changed, 32 insertions(+), 7 deletions(-) diff --git a/backend/__tests__/unit/services/hostedMcpEntry.test.js b/backend/__tests__/unit/services/hostedMcpEntry.test.js index 4f7d67664c..3bbe151353 100644 --- a/backend/__tests__/unit/services/hostedMcpEntry.test.js +++ b/backend/__tests__/unit/services/hostedMcpEntry.test.js @@ -757,7 +757,7 @@ describe('the shipped catalogue cannot land half-wired', () => { }); expect(tool.class).toBe(source.annotations.readOnlyHint ? 'read' : 'write'); expect(Boolean(tool.irreversible)).toBe(Boolean(source.annotations.destructiveHint) - || tool.upstreamName === 'notion-move-pages'); + || ['notion-move-pages', 'notion-update-view'].includes(tool.upstreamName)); } const names = entry.tools.map((tool) => tool.upstreamName); expect(names).toContain('notion-create-pages'); @@ -769,8 +769,26 @@ describe('the shipped catalogue cannot land half-wired', () => { expect(names).not.toContain('notion-upload-skill'); expect(names).not.toContain('notion-ai-search'); expect(names).not.toContain('notion-get-tool-access'); + const newlyListedExcluded = [ + 'notion-memory-search', 'notion-get-file-download-urls', + 'notion-delete-pages', 'notion-delete-databases', 'notion-restore-pages', + 'notion-get-enabled-skills', 'notion-update-enabled-skills', + 'notion-update-comment', 'notion-delete-comment', + 'notion-set-discussion-resolved', 'notion-set-comment-reaction', + 'notion-get-groups', 'notion-list-page-backlinks', + 'notion-calendar-list-calendars', 'notion-calendar-list-events', + 'notion-calendar-list-coworkers-events', 'notion-calendar-list-calendar-resources', + 'notion-calendar-list-contacts', 'notion-calendar-create-events', + 'notion-calendar-update-events', 'notion-calendar-cancel-events', + 'notion-get-self', + ]; + expect(newlyListedExcluded).toHaveLength(22); + expect(newlyListedExcluded.every((name) => capture.tools.some((tool) => tool.name === name))).toBe(true); + expect(newlyListedExcluded.some((name) => names.includes(name))).toBe(false); expect(entryToolProjections(entry).find((tool) => tool.name === 'notion.notion_move_pages')) .toMatchObject({ requiredWriteMode: 'write-with-confirm', irreversible: true }); + expect(entryToolProjections(entry).find((tool) => tool.name === 'notion.notion_update_view')) + .toMatchObject({ requiredWriteMode: 'write-with-confirm', irreversible: true }); }); test('the Linear pin is the measured list minus caller-chosen fetch paths', () => { diff --git a/backend/integrations/hostedMcp/notion.ts b/backend/integrations/hostedMcp/notion.ts index 7984a53714..faf2c15f64 100644 --- a/backend/integrations/hostedMcp/notion.ts +++ b/backend/integrations/hostedMcp/notion.ts @@ -6,7 +6,14 @@ * Agent-session, skill-transfer, attachment, connected-source search, and * tool-access catalogue calls are excluded. create-pages and update-page can * still mark a page as a skill via is_skill, with member approval. - * Destructive writes and moves keep the irreversible floor. + * Destructive writes, moves, and update-view keep the irreversible floor; + * update-view can clear shared filters and sorts without a view-specific undo. + * The 22 tools added since the 10-01 capture remain excluded: eight Calendar + * tools reach connected accounts outside Notion; get/update-enabled-skills + * lead into skill transfer or change instructions available to other agents; + * memory-search, get-file-download-urls, delete/restore-pages and databases, + * comment mutations and reactions, get-groups, list-page-backlinks, and + * get-self are not needed for this entry. A new tool joins only by ruling. */ import type { HostedMcpEntry, HostedMcpPinnedTool } from '../../services/hostedMcpEntryService'; @@ -187,7 +194,7 @@ export const NOTION_ENTRY: HostedMcpEntry = { ), pin( "notion-fetch", - "Read one Notion page, database, data source or saved view.", + "Read one Notion page, database, data source or saved view, or the connected user's memory with id: memory. include_file_urls can return short-lived signed URLs for files on that record.", 'read', { type: "object", @@ -220,7 +227,7 @@ export const NOTION_ENTRY: HostedMcpEntry = { ), pin( "notion-create-pages", - "Create pages in the connected Notion workspace.", + "Create pages in the connected Notion workspace, including top-level teamspace pages. parent: memory saves a memory that the member's connected agents can read in later sessions.", 'write', { type: "object", @@ -8305,7 +8312,7 @@ export const NOTION_ENTRY: HostedMcpEntry = { ), pin( "notion-create-view", - "Create a view on a Notion database.", + "Create a view on a Notion database. A form view can open or close submissions, allow anonymous responses, and set whether respondents can view or edit their responses.", 'write', { type: "object", @@ -8360,7 +8367,7 @@ export const NOTION_ENTRY: HostedMcpEntry = { ), pin( "notion-update-view", - "Update a Notion database view.", + "Update a Notion database view, replacing shared settings. Form settings can open or close submissions, allow anonymous responses, and control whether respondents can view or edit their responses; CLEAR can remove filters, sorts and grouping.", 'write', { type: "object", @@ -8385,7 +8392,7 @@ export const NOTION_ENTRY: HostedMcpEntry = { additionalProperties: {}, }, { readOnlyHint: false, destructiveHint: false }, - false, + true, ), ], }; From 50e2b3fb8c050de99f090c750f7e19267a6b8fe5 Mon Sep 17 00:00:00 2001 From: Lily Shen <115414357+lilyshen0722@users.noreply.github.com> Date: Mon, 19 Oct 2026 03:04:32 -0700 Subject: [PATCH 4/4] test(connectors): guard Notion pin disclosures Co-authored-by: forge Agent-Model: codex/gpt-6-sol/medium --- backend/__tests__/unit/services/hostedMcpEntry.test.js | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/backend/__tests__/unit/services/hostedMcpEntry.test.js b/backend/__tests__/unit/services/hostedMcpEntry.test.js index 3bbe151353..cab1a9ba22 100644 --- a/backend/__tests__/unit/services/hostedMcpEntry.test.js +++ b/backend/__tests__/unit/services/hostedMcpEntry.test.js @@ -785,6 +785,12 @@ describe('the shipped catalogue cannot land half-wired', () => { expect(newlyListedExcluded).toHaveLength(22); expect(newlyListedExcluded.every((name) => capture.tools.some((tool) => tool.name === name))).toBe(true); expect(newlyListedExcluded.some((name) => names.includes(name))).toBe(false); + const descriptionOf = (name) => entry.tools.find((tool) => tool.upstreamName === name).description; + expect(descriptionOf('notion-fetch')).toContain('id: memory'); + expect(descriptionOf('notion-fetch')).toContain('include_file_urls'); + expect(descriptionOf('notion-create-pages')).toContain('parent: memory'); + expect(descriptionOf('notion-create-view')).toContain('anonymous responses'); + expect(descriptionOf('notion-update-view')).toContain('CLEAR can remove filters, sorts and grouping'); expect(entryToolProjections(entry).find((tool) => tool.name === 'notion.notion_move_pages')) .toMatchObject({ requiredWriteMode: 'write-with-confirm', irreversible: true }); expect(entryToolProjections(entry).find((tool) => tool.name === 'notion.notion_update_view'))