A Notion AI agent that works from your issues
Delegate an issue to an agent. It finds the page in Notion, writes or edits it, answers the comments and reports on the issue.
Notion is the workspace for docs, wikis and projects, with 100M users in over 50 countries.
- Tools
- 6: Search, read, create and edit pages; read and add comments
- Key
- API token
- Edition
- Free in Community
- Starts on
- Delegate, mention, chat or a schedule
See each call the agent makes to Notion
Every Notion tool call is a step of the run, with what the agent sent and what came back.
- Agent
- @writer · Internal
- Trigger
- Delegate
- Started
- Nov 21, 09:12
- Run
- #418
Result
The 2.4 notes are on the Release notes page in Notion, above 2.3.
What the agent did
- 09:12:04get_issue{"key":"DOC-41"}
- 09:12:06list_issues{"cycle":"2.4"}
- 09:12:11notion_search{"query":"Release notes"}
- 09:12:14notion_read_page{"pageId":"1f2c9e…"}
- 09:12:40notion_update_page{"mode":"append"}
- 09:12:58add_comment{"issue":"DOC-41"}
- 09:13:01The notes are in Notion. The link is in a comment on DOC-41.
notion_update_page09:12:40
Input{
"pageId": "1f2c9e…",
"mode": "append",
"markdown": "## 2.4\n- Bulk edit for issues\n- Saved filters in every view\n…"
}Output{ "id": "1f2c9e…", "mode": "append", "updated": true }Six Notion tools, each with its own switch
Pick them when you add Notion, then turn them on per agent. An agent can search and read Notion and still not edit a page.
Pages
Search
Find Notion pages by name.
notion_searchRead Page
Read a Notion page: its properties and its full body as markdown, tables, callouts and sub-pages included.
notion_read_pageCreate Page
Create a Notion page under an existing page.
notion_create_pageUpdate Page
Edit a Notion page.
notion_update_pageComments
Read Comments
Read the open comments on a Notion page.
notion_read_commentsAdd Comment
Comment on a Notion page.
notion_add_commentConnect Notion once for the team
Make a Notion integration
Then share each page the agent may use: the page menu, Connections, add it. A page you do not share stays invisible.
Add its token to the team
It’s a Plan checks the token with Notion before you save it and stores it encrypted.
Pick the tools
Add the Notion tools for the team, then turn on the ones each agent may use in its Tools.
Search tools
Team wiki
Add credentialRequired token permissionsRead contentInsert content
Notion automation you can hand an agent
Delegate
Delegate DOC-41 to @writer: the release notes go to the Release notes page.
Mention
Mention @writer on an issue: it reads the Checkout spec page and creates the issues it lists.
Schedule
Every Friday at 17:00, @writer adds the week’s closed issues to the Weekly update page.
Notion comes with the free edition
Notion and 11 more integrations, on every agent trigger: delegate, mention, chat and schedules.
HTTP tools for services not on the list, agent workflows, and an agent that starts on every new issue.
See ProNotion AI agent FAQ
Is this Notion AI?
No. Notion AI works inside Notion. This agent runs in your issue tracker, on the AI model you choose, and reaches Notion through its API.
Is this the Notion MCP server?
No. The agent calls the Notion API with the team’s token. An external agent such as Claude Code, connected over MCP with an agent’s key, gets the same Notion tools.
Which pages can the agent read?
Only the pages you share with the Notion integration. A page that is not connected stays invisible to the agent.
Can it work with Notion databases?
The tools work with pages and their comments. They do not create or change databases.
Does the agent see my Notion token?
No. It is stored encrypted on your server. The agent calls a tool by name and gets back only what the tool returns.
What does it cost?
The Notion tools are free in the Community edition. You pay Notion for your plan and your AI provider for the model.
More integrations
- Jina AIRead a page as markdown, search the web and fact-check a statement.
- FirecrawlScrape, crawl and map websites, and pull structured data from pages.
- TelegramSend a message to a Telegram chat from your bot.
- ThreadsPublish posts, answer replies and read insights.
- InstagramPublish posts and reels, answer comments and read insights.
- Gitea / ForgejoList, create, update and comment on issues on your own Git server.
- GitHubList, create and update issues and discussions in your repositories.
- PDFRead a PDF from a link as markdown, with pdf-inspector. Needs no key.
- KeenableSearch the web and read pages. Works without a key.
- DataForSEOGet Google results, keyword data, backlinks and page audits.
- KieGenerate images, video, music and speech with Veo, Kling, Nano Banana and Suno.
Connect Notion to your first agent
Try the free edition on your computer with one setup command.
Or deploy to Railway in one click