Notion AI in 2026 ships in three surfaces, and most people mix them up. There is the chat you open with Cmd+J for quick answers. There are Notion Custom Agents you configure once and forget about until they finish a job.
There are External Agents from third parties living in your sidebar. Knowing the difference is the difference between paying for things you do not need and getting real value out of Notion AI Chat plus the new credit budget.
This guide breaks down Notion Custom Agents from the ground up, compares them with the built-in Notion Agent (the chat AI), explains the credit system going live on May 4, 2026, and shows you when each one earns its place in your workspace.
Table of Contents
What You’ll Learn
The three faces of Notion AI in 2026
Since Notion 3.0 (September 2025) and Notion 3.5 (May 2026), Notion AI is a layered product.
- Notion Agent (Chat AI): The Cmd+J chat bar built into every workspace with the AI add-on. Answers questions, drafts text, runs Research Mode, summarizes pages, and edits content on the page open in front of you.
- Notion Custom Agents: Configurable agents you build with a name, an icon, an instructions page, connections to other tools, and triggers. They run autonomously or on demand.
- External Agents: Third-party agents (built via the Notion Developer Platform) installed into your workspace from outside.
The Notion Agent is interactive. Notion Custom Agents are persistent workers. External Agents are partners. This article focuses on the first two and how they fit together.
What is Notion AI Chat (the Notion Agent)?
The Notion Agent is the chat panel you summon with Cmd+J or by clicking the AI button. It opens beside your page and helps you in real time.
What Notion AI Chat does well:
- Answers questions about your workspace using Enterprise Search across every page, database, data source, and connected tool.
- Drafts and edits text on the page open in front of you.
- Runs Research Mode to pull from the open web and synthesize a structured brief.
- Summarizes long pages, meeting transcripts, and database queries.
- Translates text into 16 languages.
- Switches between 12 models from the same picker.
Notion AI Chat is part of the Notion AI add-on. It is fair-use within a monthly soft cap and does not consume credits. If you use Notion mostly to write, search, and ask questions, Notion AI Chat is the surface you live in.
What are Notion Custom Agents?
Notion Custom Agents are persistent AI workers you configure once. Each Custom Agent has:
- A name and icon. Same as a teammate.
- An instructions page. A regular Notion page where you write the rules, tone, examples, banned words, and workflows the agent follows.
- Connections. Slack, Gmail, Google Drive, GitHub, Linear, Jira, Salesforce, and any MCP server you wire up. The agent uses the connected tools on your behalf.
- Triggers. When the agent runs (scheduled recurrence, a database row added, a button press, an @mention, a comment).
- Permissions. Which databases, data sources, and pages the agent reads and writes.
Once you set up a Notion Custom Agent, it works without being asked. A weekly content review agent reads your Content Hub every Friday at 9 AM and posts a digest to Slack. A CRM enrichment agent fills missing fields on every new lead row. An email triage agent labels and drafts replies in your inbox.
Custom Agents went into free beta on February 24, 2026, and went generally available with billing on May 4, 2026.
Notion Agent vs Custom Agents (head-to-head)
| Feature | Notion Agent (Chat AI) | Notion Custom Agents |
|---|---|---|
| Surface | Cmd+J chat panel | Sidebar workspace items, mentions, triggers |
| How it runs | You prompt, it answers | Runs autonomously on triggers or on demand |
| Instructions | Inline prompts each session | Persistent instructions page |
| Connections | Workspace search, Research Mode | Slack, Gmail, Google Drive, GitHub, Salesforce, MCP servers |
| Triggers | Manual prompt only | Schedule, row change, button, mention, comment |
| Memory | Session only | Per-agent across runs |
| Cost model | Included in AI add-on (fair use) | Notion credits add-on ($10 per 1,000) |
| Best for | Writing, search, quick edits | Repeatable workflows, automation, background jobs |
The short version: Notion AI Chat is a tool you pick up. A Notion Custom Agent is a teammate you hire and brief once.
The 12 models behind both
Both surfaces pull from the same model picker. As of June 2026, the picker holds 12 models:
- Auto (Notion picks the best model for the job)
- Sonnet 4.6
- Opus 4.7
- Opus 4.8
- Gemini 3.1 Pro
- GPT-5.2
- GPT-5.4
- GPT-5.5
- Grok 4.3
- Grok Build 0.1
- Kimi K2.6
- DeepSeek V4 Pro
The picker is the same everywhere. The interesting part for Notion Custom Agents is the per-agent default: pick a model once on the agent settings, and every run uses it unless you override.
For background jobs and long workflows, Opus 4.7 or 4.8 is the safe default. For fast formatting and CRM autofill, Sonnet 4.6 is light and quick. For coding-style tasks inside a Custom Agent, Grok Build 0.1 or GPT-5.5 are strong picks.
How Notion AI credits work (only Custom Agents pay)
The Notion AI credits add-on went live with Custom Agents GA on May 4, 2026. Here is how it works:
- Pricing: $10 per 1,000 credits.
- Scope: Only Notion Custom Agents consume credits. Notion AI Chat and other AI features stay on fair-use.
- Workspace pool: Credits are shared across the workspace, not per user.
- Refresh: Credits reset monthly. They do not roll over.
- When you run out: Custom Agents pause until you top up or wait for the next refresh.
- Visibility: A Credits Dashboard inside workspace admin settings shows usage per agent, per period, and per workspace.
Admin controls landed at GA too:
- Per-agent credit caps.
- Per-workspace caps.
- Unusual-spend detection.
- Agent-creation permissions (lock who is allowed to build agents).
A light Notion Custom Agent (a weekly Slack digest reading one data source) burns a few credits per run. A heavy agent doing long research, multi-step writes, and tool calls across Gmail and Google Drive consumes more. The dashboard is the source of truth on Notion AI agents pricing in your workspace.
When to use Notion AI Chat vs a Custom Agent
Use Notion AI Chat when:
- You need an answer in the next 30 seconds.
- You are drafting or editing inside one specific page.
- You want a one-time research brief.
- You are exploring the workspace and asking ad-hoc questions.
Use a Notion Custom Agent when:
- The same job runs more than once.
- The job touches more than one tool (Slack + Notion, Gmail + a database).
- The job runs on a schedule or off a data source trigger.
- You want consistent style and rules across runs without re-prompting.
- You want a teammate who handles a workflow while you sleep.
If you find yourself pasting the same prompt into Notion AI Chat twice a week, build it as a Notion Custom Agent.
How to create Notion Custom Agent (step by step)
Here is how to create Notion Custom Agent workflows from scratch:
- Open the Agents directory. Click your workspace avatar, then Agents. Click “New custom agent.”
- Name and icon. Give the agent a name and an icon. Treat it like hiring a teammate.
- Write the instructions page. A Notion page with the agent’s purpose, banned words, tone, examples of good output, examples of bad output, and the workflow steps.
- Pick the default model. Auto is fine to start. Switch to Opus 4.8 for long jobs or Sonnet 4.6 for fast ones.
- Add connections. Slack, Gmail, Google Drive, GitHub, or an MCP server. Grant access only to the data sources and pages the agent needs.
- Add triggers. Schedule (every Friday 9 AM), database row added, a button on a page, an @mention, or a comment reply.
- Test with a dry run. Run the agent once with a low-stakes input. Watch the run log. Edit the instructions page until the output matches your bar.
- Set the credit cap. Cap the agent so a runaway run does not drain the workspace pool.
The instructions page is the lever. The more specific the page is (examples, tone rules, banned words, decision rules), the better the Notion Custom Agent performs.
Notion Custom Agent triggers explained
Notion Custom Agent triggers are the difference between an on-demand tool and a real worker. The active triggers in 2026:
- Recurrence. Run on a schedule (every Monday at 8 AM, every day at 6 PM).
- Database row created. Run when a new row lands in a chosen data source.
- Database row updated. Run when a row property changes.
- Database row deleted. Run when a row is archived or removed.
- Button press. A button on a Notion page triggers the agent.
- @Mention. Mentioning the agent in a comment or doc fires it.
- Comment added. A new discussion comment on a chosen page fires the agent.
Combine triggers for real workflows. A weekly content review agent uses recurrence. A new-lead enrichment agent uses database row created. A page approval agent uses @mention plus a button.
6 Notion Custom Agents worth building this month
- Weekly content review. Reads the Content Hub data source every Friday, posts a Slack digest with what shipped, what slipped, and what is due. Pairs with SEO Manager V.02
- CRM autofill. Runs on new-lead row created, fills industry, headcount, and LinkedIn URL using web search. Pairs with CRM System
- Inbox triage. Reads new Gmail messages on a schedule, labels them, drafts replies to repeat questions. Pairs with Email Marketing Toolkit.
- Finance categorizer. Runs on every new transaction row, classifies it, suggests a category. Pairs with Finance OS.
- UGC brief generator. Runs on @mention, drafts a 60-second video script from a one-line idea. Pairs with UGC Creator OS.
- Automation runbook drafter. Reads a new workflow row, drafts the step-by-step runbook, suggests the right triggers and tools. Pairs with Workflow & Automation OS.
Each of these saves an hour a week minimum once tuned.
Common mistakes with Notion Custom Agents
- Thin instructions page. A two-line page produces a two-line agent. Write the instructions like you are onboarding a new hire.
- Too many tools. An agent with eight connections is an agent making eight kinds of mistakes. Start with one or two.
- No credit cap. A buggy trigger plus an open credit pool drains a workspace overnight. Set a per-agent cap before going live.
- Wrong model default. Auto is safe. Opus on a fast routine job wastes credits. Sonnet on long research underdelivers.
- Skipping the dry run. The run log is the truth. Read it before connecting the agent to live data.
Frequently Asked Questions
Are Notion Custom Agents the same as Notion AI Chat?
No. Notion AI Chat (the Notion Agent) is the Cmd+J chat panel for interactive use. Notion Custom Agents are persistent, configurable agents with instructions, connections, and triggers. The chat lives in front of you. The Custom Agent runs in the background.
Do Notion Custom Agents cost extra on top of the AI add-on?
Yes. Notion Custom Agents consume credits from the Notion AI credits add-on at $10 per 1,000 credits, monthly reset, shared across the workspace. Notion AI Chat and other AI features stay on fair use and do not consume credits.
How many Notion Custom Agents am I allowed to build?
The number of agents is not capped by your AI add-on. The credit pool and admin permissions are the real limit. Workspace admins control who is allowed to build agents and how many credits each agent uses per period.
What is the difference between a Notion Custom Agent and an automation?
A Notion automation runs deterministic actions (set a property, send a notification). A Notion Custom Agent reads context, reasons, and takes multi-step actions across tools. Use automations for one-step rules. Use Custom Agents when judgment is needed.
Does a Notion Custom Agent read every page in my workspace?
Only the pages, databases, and data sources you explicitly share with the agent. Custom Agents respect Notion permissions. Grant access narrowly. The instructions page should also list which sources the agent reads and which it writes to.
Final thoughts
Notion Custom Agents are the layer of Notion AI most workspaces miss. The chat panel earns its keep on every plan with the AI add-on, but the real leverage shows up when a Custom Agent runs a repeatable workflow on a schedule with the right instructions and the right model. Pair the agent with the data source it owns, set a credit cap, write the instructions page like an onboarding doc, and you end up with a workspace where the busywork takes care of itself.
If you are already paying for Notion AI Chat and finding yourself pasting the same prompt twice a week, build the Custom Agent. Cap the credits. Watch the dashboard. Iterate the instructions page. Repeat.
