@oomol-lab/open-connector 1.6.5 → 1.8.0

package/assets/open-connector/catalog/apps/notion_mcp.json

@@ -0,0 +1,490 @@
+{
+  "service": "notion_mcp",
+  "displayName": "Notion MCP",
+  "description": "Search, read, and list comments on Notion pages through Notion's official remote MCP server, signed in with the connected user's own Notion account.",
+  "categories": [
+    "Productivity"
+  ],
+  "authTypes": [
+    "oauth2"
+  ],
+  "auth": [
+    {
+      "type": "oauth2",
+      "authorizationUrl": "https://mcp.notion.com/authorize",
+      "tokenUrl": "https://mcp.notion.com/token",
+      "scopes": [],
+      "tokenEndpointAuthMethod": "none",
+      "pkce": {
+        "method": "S256"
+      },
+      "authorizationParams": {
+        "resource": "https://mcp.notion.com/mcp"
+      },
+      "clientSetup": {
+        "docsUrl": "https://developers.notion.com/guides/mcp/build-mcp-client",
+        "steps": [
+          "Copy the Callback URL shown below.",
+          "POST {\"client_name\":\"Open Connector\",\"redirect_uris\":[\"<Callback URL>\"],\"grant_types\":[\"authorization_code\",\"refresh_token\"],\"response_types\":[\"code\"],\"token_endpoint_auth_method\":\"none\"} as JSON to https://mcp.notion.com/register.",
+          "Copy the returned client_id into the Client ID field below and leave Client Secret empty.",
+          "Connect with OAuth. Notion MCP is in beta: tool names and result shapes can change without notice, and some search filters need a Business or Enterprise plan."
+        ]
+      }
+    }
+  ],
+  "homepageUrl": "https://www.notion.so",
+  "actions": [
+    {
+      "id": "notion_mcp.fetch_page",
+      "service": "notion_mcp",
+      "name": "fetch_page",
+      "description": "Read one Notion page through notion-fetch by ID or URL. Returns the title, properties block, Markdown content, a truncated flag, and the raw response.",
+      "operationType": "read",
+      "requiredScopes": [],
+      "providerPermissions": [],
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "id": {
+            "type": "string",
+            "minLength": 1,
+            "description": "The Notion page ID or URL."
+          }
+        },
+        "additionalProperties": false,
+        "required": [
+          "id"
+        ],
+        "description": "The page to read."
+      },
+      "outputSchema": {
+        "type": "object",
+        "properties": {
+          "id": {
+            "type": "string",
+            "description": "The requested page ID or URL, echoed back."
+          },
+          "title": {
+            "type": "string",
+            "description": "The page title, when the server names one."
+          },
+          "url": {
+            "type": "string",
+            "description": "The Notion URL of the page, when the server names one."
+          },
+          "page_last_edited_at": {
+            "type": "string",
+            "description": "The last-edited time, when the server reports one."
+          },
+          "properties": {
+            "type": "string",
+            "description": "The page's properties block as the server rendered it."
+          },
+          "content": {
+            "type": "string",
+            "description": "The page content as Markdown."
+          },
+          "truncated": {
+            "type": "boolean",
+            "description": "Whether the server cut the content short."
+          },
+          "raw": {
+            "type": "string",
+            "description": "The untouched text Notion's MCP tool returned, kept beside the typed fields so a changed tool shape can still be read."
+          }
+        },
+        "additionalProperties": false,
+        "required": [
+          "id",
+          "truncated",
+          "raw"
+        ],
+        "description": "A Notion page as notion-fetch returned it."
+      }
+    },
+    {
+      "id": "notion_mcp.get_self",
+      "service": "notion_mcp",
+      "name": "get_self",
+      "description": "Identify the connected Notion user through notion-get-users with user_id self. Returns the user ID, name, and email the server reports.",
+      "operationType": "read",
+      "requiredScopes": [],
+      "providerPermissions": [],
+      "inputSchema": {
+        "type": "object",
+        "properties": {},
+        "additionalProperties": false
+      },
+      "outputSchema": {
+        "type": "object",
+        "properties": {
+          "user": {
+            "type": "object",
+            "properties": {
+              "id": {
+                "type": "string",
+                "description": "The Notion user ID."
+              },
+              "name": {
+                "type": "string",
+                "description": "The user's display name."
+              },
+              "email": {
+                "type": "string",
+                "description": "The user's email address, when the server reports one."
+              },
+              "type": {
+                "type": "string",
+                "description": "The user type, such as person or bot."
+              }
+            },
+            "additionalProperties": true,
+            "description": "A Notion user as the MCP server reports it. Fields the server omits are absent."
+          },
+          "raw": {
+            "type": "string",
+            "description": "The untouched text Notion's MCP tool returned, kept beside the typed fields so a changed tool shape can still be read."
+          }
+        },
+        "additionalProperties": false,
+        "required": [
+          "raw"
+        ],
+        "description": "The connected user."
+      }
+    },
+    {
+      "id": "notion_mcp.list_comments",
+      "service": "notion_mcp",
+      "name": "list_comments",
+      "description": "List the comments on one Notion page through notion-get-comments, flattened across discussions. Block-level and resolved discussions are included unless turned off; the server offers no paging.",
+      "operationType": "read",
+      "requiredScopes": [],
+      "providerPermissions": [],
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "page_id": {
+            "type": "string",
+            "minLength": 1,
+            "description": "The Notion page ID."
+          },
+          "include_all_blocks": {
+            "type": "boolean",
+            "description": "Whether to include comments on every block of the page. Defaults to true."
+          },
+          "include_resolved": {
+            "type": "boolean",
+            "description": "Whether to include resolved discussions. Defaults to true."
+          }
+        },
+        "additionalProperties": false,
+        "required": [
+          "page_id"
+        ],
+        "description": "The page whose comments to list."
+      },
+      "outputSchema": {
+        "type": "object",
+        "properties": {
+          "comments": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "properties": {
+                "id": {
+                  "type": "string",
+                  "description": "The comment ID."
+                },
+                "discussion_id": {
+                  "type": "string",
+                  "description": "The discussion thread the comment belongs to."
+                },
+                "plain_text": {
+                  "type": "string",
+                  "description": "The comment text."
+                },
+                "created_time": {
+                  "type": "string",
+                  "description": "When the comment was created."
+                },
+                "created_by": {
+                  "type": "object",
+                  "properties": {
+                    "id": {
+                      "type": "string",
+                      "description": "The Notion user ID."
+                    },
+                    "name": {
+                      "type": "string",
+                      "description": "The user's display name."
+                    },
+                    "email": {
+                      "type": "string",
+                      "description": "The user's email address, when the server reports one."
+                    },
+                    "type": {
+                      "type": "string",
+                      "description": "The user type, such as person or bot."
+                    }
+                  },
+                  "additionalProperties": true,
+                  "description": "A Notion user as the MCP server reports it. Fields the server omits are absent."
+                }
+              },
+              "additionalProperties": true,
+              "description": "One comment. Fields the server omits are absent."
+            },
+            "description": "Comments in the server's order."
+          },
+          "raw": {
+            "type": "string",
+            "description": "The untouched text Notion's MCP tool returned, kept beside the typed fields so a changed tool shape can still be read."
+          }
+        },
+        "additionalProperties": false,
+        "description": "Comments on a Notion page, flattened across discussions."
+      }
+    },
+    {
+      "id": "notion_mcp.search",
+      "service": "notion_mcp",
+      "name": "search",
+      "description": "Search Notion pages through notion-search with optional text, sort, page size, date-range and creator filters. Returns typed results, the search type that ran, the server's notices about dropped filters, and the raw response. Filtering by editor or last-edited date and sorting by date need a Business or Enterprise plan; other plans drop them and name them in notices. When the connection can use AI search, a non-empty keyword query with no exact filter and relevance order runs AI search and can return results from connected apps. Notion allows 30 searches a minute.",
+      "operationType": "read",
+      "requiredScopes": [],
+      "providerPermissions": [],
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "query": {
+            "type": "string",
+            "description": "Search text. An empty string lists pages by the sort order alone."
+          },
+          "sort": {
+            "type": "string",
+            "description": "Result order. The beta server accepted \"relevance\" (the default), \"last_edited\" and \"created\"; the value is passed through as given. Date sorts need a Business or Enterprise plan; other plans fall back to relevance and say so in notices."
+          },
+          "page_size": {
+            "type": "integer",
+            "minimum": 1,
+            "maximum": 50,
+            "description": "Maximum number of results. Notion allows 1 to 50."
+          },
+          "max_highlight_length": {
+            "type": "integer",
+            "minimum": 0,
+            "description": "Maximum length of the highlight snippet on each result; 0 turns highlights off."
+          },
+          "last_edited_date_range": {
+            "type": "object",
+            "properties": {
+              "start_date": {
+                "type": "string",
+                "description": "The earliest day, inclusive, as YYYY-MM-DD."
+              },
+              "end_date": {
+                "type": "string",
+                "description": "The latest day, inclusive, as YYYY-MM-DD."
+              }
+            },
+            "additionalProperties": false,
+            "description": "Only pages last edited in this day-precision range. Business and Enterprise plans only; other plans drop the filter and name it in notices."
+          },
+          "created_date_range": {
+            "type": "object",
+            "properties": {
+              "start_date": {
+                "type": "string",
+                "description": "The earliest day, inclusive, as YYYY-MM-DD."
+              },
+              "end_date": {
+                "type": "string",
+                "description": "The latest day, inclusive, as YYYY-MM-DD."
+              }
+            },
+            "additionalProperties": false,
+            "description": "Only pages created in this day-precision range."
+          },
+          "created_by_user_ids": {
+            "type": "array",
+            "items": {
+              "type": "string",
+              "minLength": 1
+            },
+            "description": "Only pages created by these Notion user IDs."
+          },
+          "edited_by_user_ids": {
+            "type": "array",
+            "items": {
+              "type": "string",
+              "minLength": 1
+            },
+            "description": "Only pages edited by these Notion user IDs. Business and Enterprise plans only; other plans drop the filter and name it in notices."
+          },
+          "filters": {
+            "type": "object",
+            "additionalProperties": true,
+            "description": "Extra filters passed through under the tool's filters argument as given. The typed filters above take precedence over the same keys here."
+          }
+        },
+        "additionalProperties": false,
+        "description": "Arguments for Notion's notion-search tool."
+      },
+      "outputSchema": {
+        "type": "object",
+        "properties": {
+          "type": {
+            "type": "string",
+            "description": "Which search ran, as the server reports it: \"workspace_search\", or \"ai_search\" when Notion routed a keyword query to AI search, whose results can come from connected apps such as Slack that fetch_page cannot read."
+          },
+          "results": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "properties": {
+                "id": {
+                  "type": "string",
+                  "description": "The page or data source ID."
+                },
+                "title": {
+                  "type": "string",
+                  "description": "The result title."
+                },
+                "url": {
+                  "type": "string",
+                  "description": "The Notion URL of the result."
+                },
+                "type": {
+                  "type": "string",
+                  "description": "The result type, such as page."
+                },
+                "timestamp": {
+                  "type": "string",
+                  "description": "The last-edited time the server reports for the result."
+                },
+                "path": {
+                  "type": "string",
+                  "description": "The breadcrumb path to the result."
+                }
+              },
+              "additionalProperties": true,
+              "description": "One search result. Fields the server omits are absent."
+            },
+            "description": "Results in the server's order."
+          },
+          "notices": {
+            "type": "array",
+            "items": {
+              "type": "string",
+              "description": "One notice."
+            },
+            "description": "Server notices as plain text, such as a filter dropped on this plan."
+          },
+          "raw": {
+            "type": "string",
+            "description": "The untouched text Notion's MCP tool returned, kept beside the typed fields so a changed tool shape can still be read."
+          }
+        },
+        "additionalProperties": false,
+        "required": [
+          "results",
+          "notices",
+          "raw"
+        ],
+        "description": "Notion search results."
+      },
+      "followUpActions": [
+        "notion_mcp.fetch_page",
+        "notion_mcp.list_comments"
+      ]
+    },
+    {
+      "id": "notion_mcp.tool_access",
+      "service": "notion_mcp",
+      "name": "tool_access",
+      "description": "Report each MCP tool's access status on the connected Notion plan through notion-get-tool-access, keyed by the tool's base name such as search, with the parameters the plan restricts and the reason for each, such as the edited-by search filter below the Business plan.",
+      "operationType": "read",
+      "requiredScopes": [],
+      "providerPermissions": [],
+      "inputSchema": {
+        "type": "object",
+        "properties": {},
+        "additionalProperties": false
+      },
+      "outputSchema": {
+        "type": "object",
+        "properties": {
+          "tools": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "properties": {
+                "tool": {
+                  "type": "string",
+                  "description": "The tool's base name as the server keys it, such as search or ai_search: the notion- prefix dropped and hyphens turned into underscores."
+                },
+                "status": {
+                  "type": "string",
+                  "description": "The access status: available, available_with_limit, plan_required, upgrade_required, full_version_required, or not_enabled."
+                },
+                "restricted_parameters": {
+                  "type": "array",
+                  "items": {
+                    "type": "object",
+                    "properties": {
+                      "parameter": {
+                        "type": "string",
+                        "description": "The parameter path, such as filters.title_only."
+                      },
+                      "reason": {
+                        "type": "string",
+                        "description": "Why the parameter is unavailable, as the server words it. Check it against the value you plan to send: a restriction on several teamspaces still allows one."
+                      }
+                    },
+                    "additionalProperties": false,
+                    "required": [
+                      "parameter",
+                      "reason"
+                    ],
+                    "description": "One parameter the plan restricts."
+                  },
+                  "description": "Parameters the plan restricts, independent of the status."
+                },
+                "upgrade_url": {
+                  "type": "string",
+                  "description": "Where a workspace upgrade changes the status."
+                },
+                "full_version_url": {
+                  "type": "string",
+                  "description": "Where to get the full version of Notion MCP when the tool needs it."
+                },
+                "landing_page_url": {
+                  "type": "string",
+                  "description": "The plan landing page Notion routes the user through."
+                },
+                "landing_page_action": {
+                  "type": "string",
+                  "description": "What the landing page offers: start_trial, request_trial, or learn_more."
+                }
+              },
+              "additionalProperties": true,
+              "required": [
+                "tool",
+                "restricted_parameters"
+              ],
+              "description": "Access to one MCP tool on the connected plan."
+            },
+            "description": "One entry per tool the connection exposes, in the server's order."
+          },
+          "raw": {
+            "type": "string",
+            "description": "The untouched text Notion's MCP tool returned, kept beside the typed fields so a changed tool shape can still be read."
+          }
+        },
+        "additionalProperties": false,
+        "description": "The plan report from notion-get-tool-access."
+      }
+    }
+  ]
+}