Learning Timeline
Key Insights
Tool Description Tips for AI
Avoid leaving the tool description blank or using the default text. You need to write a clear description so the AI understands exactly when it needs to pull data from Notion.
Permission Error
If the AI cannot find your data, ensure you have added (Invited) the Integration you created into that specific Notion database via the 'Connections' menu. Without this step, the token will not have access even if the connection shows as 'Success' in Make.
The Advantage of 'Let the AI Decide'
By setting the 'Limit' to 'Let the agent decide', the AI can dynamically adjust the amount of data it fetches. For example, if a user asks 'What are my top 3 tasks?', the AI will automatically set the limit to 3.
Step by Step
How to Add the Notion 'Search Objects' Tool to your AI Agent
- Open the 'Tools' section in your AI Agent interface and click the 'Add' button.
- Select 'Module Tool' from the available options.
- In the dropdown menu, search for and select the 'Notion - Search Objects' module.
- Set the 'Tool Name' to 'get_open_tasks'.
- Enter a clear instruction in the 'Description' field: 'Get my open tasks from my notion tasks database'.
- Click the 'Add' button in the 'Connection' section to link your Notion account.
- Prepare your 'Integration Token' from Notion (refer to the next step card) and paste it into the token field in Make.
- Click 'Save' to activate the connection.
- Click the 'Search' button in the 'Database ID' field and type your database name (e.g., 'Tasks') to automatically detect the ID.
- In the 'Filter' section, select the 'Status' property, set the operator to 'Equals', and enter the value 'Open'.
- Add an 'And' filter for the 'Assigned to' property (People object), set the operator to 'Equals', and enter your Notion User ID.
- In the 'Limit' field, enter a value (e.g., 50) or select 'Let the AI agent decide' to allow the AI to determine the amount of data to retrieve based on the user's prompt.
- Click 'Add Tool' to complete the configuration.
How to Get an Integration Token & Connect Notion
- Open the Notion database you want to use.
- Click the three dots (...) icon in the top right corner of the page.
- Select 'Connections' and click 'Add Connection'.
- Click on 'Develop Integration'.
- Click 'Create New Integration', give it a name (e.g., 'Make AI Agent Demo'), and select the correct Workspace.
- Confirm the 'Capabilities' (Read, Update, Insert content) and click 'Submit'.
- Click 'Show' on the 'Internal Integration Token' and copy the code.
- Go back to your Notion database page, click the three dots, select 'Add Connection', and search for the name of the integration you just created to grant access permissions.
