Connect Notion to your AI agent

Authentication methods

• OAuth 2.0
• API key

Open the local console, select a provider, and configure its credentials. OAuth providers require an OAuth app you register with that service.

What to check for this connector

The search example returns content visible to the Notion connection. A page outside that connection’s access will not become visible just because the query matches its title. Check resource sharing before treating an empty search as an error.

Inspect the Action before calling it

Example purpose

Search Notion pages and data sources by a query. Only content accessible to the connection can be returned.

Required Action scopes

• read_content

Read the schema from your running instance. Check required input, permissions, and the account connection before execution.

curl -s http://localhost:3000/v1/actions/notion.search

After connecting an account, adapt the example input to your resources. Add a runtime bearer token if runtime authentication is enabled.

curl -s -X POST \
  http://localhost:3000/v1/actions/notion.search \
  -H 'content-type: application/json' \
  -d '{"input":{"query":"OpenConnector","pageSize":5}}'

Read the result

HTTP runtime responses use success, message, data and meta. Inspect success and the Action’s output schema, not just the HTTP status. When execution metadata includes executionId, use it to find the corresponding redacted run log. The example below illustrates the envelope; it is not a live API result.

{
  "success": true,
  "message": "OK",
  "data": {},
  "meta": {}
}

If the call fails

• For an authentication failure, check the endpoint and credential type: admin access protects /api; a runtime bearer token authorizes /v1 and /mcp. A provider API key is not a runtime token.
• For a permission denial, check the Action’s required scopes, runtime Action rules and connection grants. A valid token may still be forbidden from using the selected account.
• For empty or missing results, confirm the connected account and its access to the requested resource. Successful authorization does not grant access to every workspace, channel or document.
• Inspect the error and run log before retrying. If an Action changes provider data, check whether it already completed; do not blindly repeat the request.

Next steps

For supported providers, OOMOL handles OAuth app configuration and the hosted runtime. You still choose the account and approve its permissions.