Verdict: Notion is no longer just a place to store data; with the version 3.5 update, it has become a programmable orchestration layer for AI agents. By integrating external agents like Claude Code directly into your workspace and deploying custom logic via Notion Workers, you can transition from manual document management to a proactive "Agent OS" that executes work autonomously.
What is the Notion 3.5 Developer Platform?
On May 13, 2026, Notion launched its most significant architectural shift to date: the Developer Platform. This update (version 3.5) introduced three core primitives that allow AI agents to operate as native, tracked participants in your workspace rather than just external tools.
The platform is built on Notion Workers, a hosted TypeScript runtime, and the External Agents API, which partners with Anthropic, OpenAI, and Anysphere to bring tools like Claude Code and Cursor directly into Notion pages and databases.
How do Notion Workers change the game?
Notion Workers are lightweight TypeScript programs that run on Notion’s hosted infrastructure (built on Vercel Sandbox). Unlike traditional integrations that require you to manage your own servers or use third-party platforms like Zapier, Workers sit directly next to your data.
- Hosted Compute: Deploy custom logic via the
ntnCLI without managing infrastructure. - Deterministic Tools: Use Workers to perform specific, reliable tasks—like querying a database or calling an external API—that AI agents can then use as "tools."
- Event-Driven: Workers can be triggered by webhooks, schedules, or database changes.
Pricing Note: Notion Workers are currently in free beta through August 11, 2026. After this date, they will consume workspace credits at an estimated rate of $0.0023 per run (Notion Help Center).
Connecting Claude Code via the External Agents API
The External Agents API allows third-party AI agents to join your workspace as first-class participants. They appear in @ mentions, can be assigned to tasks in a database, and can chat directly within your documents.
Supported partners at launch include:
- Claude Code (Anthropic): For general-purpose reasoning and business logic.
- Cursor (Anysphere): For technical documentation and coding tasks.
- Codex (OpenAI): For complex multi-step orchestration.
- Decagon: For specialized customer service workflows.
This integration removes the "copy-paste tax." Instead of prompting an AI in a separate tab, you assign a document to @Claude in Notion, and it writes the update directly back to the page.
4 Real-World Agent Flows for Small Business
To move from "data storage" to "data action," you should implement these four proactive workflows:
1. The Auto-Onboarding Engine
What it does: Automatically drafts a personalized welcome message for every new lead or customer based on their specific needs. The Flow: When a new entry hits your "Signups" database, a Notion Worker triggers Claude to read the member’s profile and draft a message highlighting relevant resources. Benefit: Scale high-touch personalization without manual effort.
2. Intelligent Content Calendars
What it does: Analyzes your best-performing posts from the last 30 days and generates 15 fresh content angles every Monday morning. The Flow: A scheduled Worker queries your "Analytics" database, sends the data to Claude, and populates the "Content Ideas" database with ready-to-use hooks. Context: Learn more about scaling content in our Agentic SEO Playbook.
3. Automated Coaching Prep
What it does: Groups community questions by theme and drafts a structured call outline before your weekly session. The Flow: Every Tuesday, Claude reviews all submissions in your "Q&A" database and creates a "Run of Show" document with talking points. Context: This is a key part of building a Resilient Agent OS.
4. The Lead Follow-up Tracker
What it does: Monitors your CRM and drafts personalized follow-up messages for any lead that has gone cold for more than 48 hours. The Flow: A daily Worker flags "Open" leads with no recent contact and tasks Claude with drafting a follow-up based on their interests.
What this means for you
The transition to an Agent OS means your business can move faster than competitors who are still manually "shepherding" tasks. By leveraging Claude Code for Business Automation, you can build systems that execute decisions without needing a human in the room for every step.
Action Plan:
- Install the CLI: Run
curl -fsSL https://ntn.dev | bashto get started. - Audit your databases: Identify which manual tasks (syncing, summarizing, tagging) can be offloaded to a Worker.
- Build before August 11: Take advantage of the free beta period to test your workflows before the credit system kicks in.
FAQ
Q: Do I need to be a developer to use Notion Workers?
A: While Workers use TypeScript, Notion’s CEO Ivan Zhao suggests that you can use AI coding agents like Claude Code to write and deploy the code for you via the ntn CLI.
Q: How much do Notion credits cost? A: Custom Agents and Workers use a credit system that costs $10 per 1,000 monthly credits. This has been the standard for Custom Agents since May 4, 2026.
Q: Is the External Agents API available to everyone?
A: No, the External Agents API is currently in private beta and requires joining a waitlist. However, the Workers runtime and ntn CLI are in open beta for Business and Enterprise plans.
Q: Can I use Notion Workers on a personal plan? A: No, Notion Workers require a Business or Enterprise plan. Plus plans have access to the CLI but cannot deploy Workers to Notion’s hosted infrastructure.
Discussion
0 comments