Notion
In one line: Connect Notion so your UnleashX agent can search and read pages, create and update content, query databases, add comments, and keep your workspace organized — all in plain language.
1. Overview
Notion is a connected workspace for notes, docs, wikis, and databases. It holds your pages, the databases that organize them, the blocks of content inside each page, and the comments your team leaves along the way. Once connected to UnleashX, your agent can search for pages, read a page or an individual block, create and update pages, query and manage database items, and add comments. It works against your live Notion workspace using your own Notion sign-in, so it respects the pages and databases you’ve shared with the connection. Connecting Notion to UnleashX turns your workspace into something you can ask questions of and update by talking. Instead of opening Notion to jot a page, log a database row, or leave a comment, you tell your agent and it makes the change — while keeping everything in sync.2. What you’ll need
- A Notion account with a workspace you can access.
- Permission to view and edit the pages and databases you want the agent to work with.
- The pages or databases you want the agent to reach shared with the Notion connection during authorization.
- An UnleashX account with access to Data Connectors.
No API key to paste. Notion uses OAuth — you click Authorize and sign in with Notion, then choose which pages and databases to grant access to.
3. Get your credentials
There’s no key to copy. Authentication runs through Notion’s secure OAuth sign-in.1
Start the connection in UnleashX
Connecting Notion (Section 4) opens a Notion Authorize window.
2
Sign in with Notion
Sign in with your Notion account at
https://www.notion.so/login. Complete two-factor authentication if prompted.3
Select the workspace
If you belong to more than one Notion workspace, pick the one you want the agent to work with.
4
Choose the pages to share
Notion asks which pages and databases to give access to. Select the pages (and their subpages) the agent should be able to read and edit. You can broaden or narrow this later by reconnecting.
5
Review and accept the access
Notion shows the access UnleashX is requesting (see the scopes table). Click Allow access.
6
Return to UnleashX
Notion redirects you back automatically and the connector links to your workspace. Behind the scenes UnleashX calls Notion with a
Bearer token — you never handle the token yourself.Notion access is scoped to the pages and databases you selected during authorization — not your whole workspace. Notion, not UnleashX, enforces those limits.
4. Connect on UnleashX
1
Open your agent
Go to https://www.tryunleashx.com and open the agent you want to connect.
2
Open Data Connectors
Inside the agent, go to Data Connectors.
3
Find Notion
Locate Notion and click Connect (or Add / Configure).
4
Authorize with Notion
Click Authorize, sign in with Notion, choose the pages and databases to share, and accept the access.
5
Confirm success
You return to UnleashX and the Notion connector shows a Connected badge.
Use Notion in a Workflow
Once connected, you can add Notion to any automation from the Workflows builder. Its triggers and tools appear in the Apps panel, marked with an MCP badge.1
Add a trigger node
Open Workflows → New Workflow. On the canvas, click + Add Trigger. In the Paths panel, open the Apps tab and select Notion — its Triggers are listed underneath. Use the search box if you have many connectors.
2
Add an action node
Click the + below any node to add a step, then pick Notion again — this time the panel lists its Actions.
3
Configure the step
Fill in the fields for the trigger or action you picked. Required fields are marked with a red asterisk (*).
4
Add or select your account
Under Selected account, choose an already-connected account, or click Add Account to connect one now.
5
Save and test
Click Save. Use Test to verify the step, then toggle Publish when the workflow is ready.
The steps are the same for every connector. For the full workflow builder guide, see Using MCP in Workflows.
5. Available tools
Available triggers
6. Example usage
“Add a row to the Roadmap database: title ‘Q3 launch’, status In Progress, owner Priya.” → Runs Create Database Item on the Roadmap database with the title, status, and owner values. “Find the meeting notes page from yesterday and add a comment asking for the action items.” → Runs Search Pages to locate the notes page, then Create Comment to post the question on it.7. Permissions & data access
UnleashX can:- Search and read pages, blocks, page properties, and databases you shared.
- Create and update pages, add content, and duplicate pages.
- Create, update, and find items in databases.
- Read and add comments on shared pages.
- Access pages or databases you didn’t share during authorization.
- Reach content in a different Notion workspace than the one you connected.
- Change your Notion account, billing, or workspace-wide settings.
8. Troubleshooting
For general MCP issues, see /mcp/integrations.
9. Frequently asked questions
Is my Notion content stored by UnleashX? No. UnleashX reads and writes your pages live through the Notion API per request; it doesn’t keep a copy of your workspace. Why can’t the agent see a page I know exists? Notion only exposes pages you explicitly shared with the connection. Reconnect and add that page (or its parent) to the shared selection. Can the agent really delete pages? Deleting a page archives it (the Delete Page tool is marked ⚠️). Archived pages can be restored from Notion’s trash, but treat the action deliberately. Which workspace does the agent use? The one you selected when connecting. To switch workspaces, reconnect and choose a different one.10. References
- Notion API documentation: https://developers.notion.com/
- Notion API reference: https://developers.notion.com/reference/intro
- Authorization (OAuth): https://developers.notion.com/docs/authorization
- Manage connections: https://www.notion.so/help/add-and-manage-connections-with-the-api