It’s a Planv1.12.0

Integrations/Notion

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

In a run

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.

Succeeded in 57sDOC-41 Release notes for 2.4 in the team wiki
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

  1. 09:12:04get_issue{"key":"DOC-41"}
  2. 09:12:06list_issues{"cycle":"2.4"}
  3. 09:12:11notion_search{"query":"Release notes"}
  4. 09:12:14notion_read_page{"pageId":"1f2c9e…"}
  5. 09:12:40notion_update_page{"mode":"append"}
  6. 09:12:58add_comment{"issue":"DOC-41"}
  7. 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 }

Tools

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_search

Read Page

Read a Notion page: its properties and its full body as markdown, tables, callouts and sub-pages included.

notion_read_page

Create Page

Create a Notion page under an existing page.

notion_create_page

Update Page

Edit a Notion page.

notion_update_page

Comments

Read Comments

Read the open comments on a Notion page.

notion_read_comments

Add Comment

Comment on a Notion page.

notion_add_comment

Set up

Connect Notion once for the team

  1. Make a Notion integration

    Notion › Developers › Connections

    Then share each page the agent may use: the page menu, Connections, add it. A page you do not share stays invisible.

  2. Add its token to the team

    Team settings › Integrations › Add credential

    It’s a Plan checks the token with Notion before you save it and stores it encrypted.

  3. Pick the tools

    Team settings › Tools › Add tool

    Add the Notion tools for the team, then turn on the ones each agent may use in its Tools.

Beacon›Add tool

Search tools

Notion6 toolsSelect all
SearchFind Notion pages by name.
Read PageRead a Notion page: its properties and its full body as markdown, tables, callouts and sub-pages included.
Create PageCreate a Notion page under an existing page.
Update PageEdit a Notion page.
Credential

Team wiki

Add credential

Required token permissionsRead contentInsert content

3 tools selectedCancelAdd 3 tools

Use cases

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.

Free and Pro

Notion comes with the free edition

FREE

Notion and 11 more integrations, on every agent trigger: delegate, mention, chat and schedules.

PRO

HTTP tools for services not on the list, agent workflows, and an agent that starts on every new issue.

See Pro
FAQ

Notion 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.

Connect Notion to your first agent

Try the free edition on your computer with one setup command.

Or deploy to Railway in one click

AGPL-3.0 · No per-seat fees · Use your own AI key or subscription