Notion Custom Agents Now Cost Extra: Build Your Own with Claude API + Notion MCP at a Fraction of the Cost

Starting May 4, 2026, Notion Custom Agents are no longer free. They now run on a credit-based pricing model. If you're on Notion Business and run agents 10 times a day, expect to pay an extra $9-90 per month on top of your $20 subscription. But there's another way: Claude Haiku 4.5 + the official Notion MCP Server costs under $0.01 per run, with API costs billed by usage, and takes about 30 minutes to set up.

TL;DR

• Notion Custom Agents real cost: Business $20/mo + credits $9-90/mo (10 runs/day) = $29-110/mo
• Claude API + Notion MCP alternative: Plus $10/mo + API fees billed by usage (Claude Haiku 4.5: $1/MTok input, $5/MTok output)
• No coding required: n8n/Make + Claude API works without writing a single line of code
• Known limitations: Notion MCP doesn't support image uploads or database deletion; the npm package is no longer actively maintained

Note: Credit costs vary by agent task complexity. The figures above are mid-range estimates based on per-run costs published in the official Help Center.

First, Do the Math on What You're Actually Paying

Many people assume the $20/month Notion Business plan "includes" Custom Agents. It doesn't. Custom Agents are an add-on for Business and Enterprise plans. As of May 4, they're billed in Notion credits at $10 per 1,000 credits.

Credit Cost per Run

According to the official pricing page, different agent types consume different amounts per run:

Agent Type	Cost per Run (USD)	Depends On
Q&A Lookup	$0.03-$0.11	Volume of data read
Task Assignment	$0.05-$0.15	Number of decision steps
Status Update	$0.08-$0.18	Number of write operations
Email Triage	$0.04-$0.10	Email content length
Daily Summary	$0.10-$0.30	Scope of aggregated data

Monthly Cost Breakdown

Usage Level	Runs per Month	Monthly Credit Cost	Including Business Plan
Light (2/day)	60	$6-18	$26-38/mo
Medium (10/day)	300	$9-90	$29-110/mo
Heavy (30/day)	900	$99-270	$119-290/mo

We've been running similar Notion automation workflows on the Claude API, and the gap is most striking at medium usage: Notion's approach costs $29-110/month, while the Claude API path — Notion Plus at $10 plus usage-based API fees — is significantly lower.

What Is Claude API + Notion MCP, and What Does It Cost?

Notion MCP Server is an official Notion-maintained Model Context Protocol package that lets any MCP-compatible AI tool (including Claude Desktop and Claude Code) read from and write to your Notion workspace.

22 Supported Operations

The MCP package supports a full range of Notion data operations:

• Search pages and databases
• Read/create/update page content
• Query/create/update database items
• Add comments
• Read user information

Actual Cost per Run

Using Claude Haiku 4.5 (official pricing: $1/MTok input + $5/MTok output) for a typical Notion agent task:

• Input: ~5,000 tokens (system prompt + Notion data response + user query)
• Output: ~1,000 tokens (structured response or action commands)
• Cost per run: (5,000 x $1 + 1,000 x $5) / 1,000,000 = $0.01

At 300 runs/month with these token estimates, API costs stay well under $0.01 per run. Add Notion Plus ($10/user/month, same collaboration features) and the total remains significantly below a Notion Business subscription.

Three Connection Methods Compared

Method	Technical Barrier	Best For	Fully Automated
Hosted MCP (mcp.notion.com)	Low	General users	No (requires OAuth manual auth)
npm package + NOTION_TOKEN	Medium	Engineers	Yes
n8n/Make + Claude API	Low	Non-engineers	Yes

Important: The hosted version requires OAuth authorization with manual interaction each time, so it can't run fully unattended. For 24/7 scheduled automation, use the npm package or the n8n path.

30-Minute Setup Guide (npm Package)

This walkthrough is for anyone comfortable with basic terminal commands. Actual setup time is about 30 minutes. This is the same method our own fleet uses to connect to Notion.

Step 1: Create a Notion Internal Integration

1. Go to notion.so/my-integrations
2. Click "New integration"
3. Name it (e.g., claude-agent) and select your workspace
4. Copy the Internal Integration Token (starts with ntn_)
5. Under "Capabilities," confirm these are checked: Read content, Update content, Insert content

Step 2: Share Pages with the Integration

In Notion, for each page or database you want the agent to access:

1. Click "..." (top right) > "Connections"
2. Search for the integration you just created
3. Click "Confirm"

Step 3: Install the Notion MCP Server

npx -y @notionhq/notion-mcp-server

Step 4: Configure MCP in Claude Desktop

Add the following to your Claude Desktop config file (~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "notion": {
      "command": "npx",
      "args": ["-y", "@notionhq/notion-mcp-server"],
      "env": {
        "NOTION_TOKEN": "ntn_your_token_here"
      }
    }
  }
}

Restart Claude Desktop. If the MCP icon appears, the connection is live.

Step 5: Test It

Type this into a Claude conversation: "Search my Notion workspace for all pages containing 'Project'." If it returns results, you're all set.

The No-Code Path (n8n/Make)

Don't want to touch the terminal? n8n (free self-hosted) or Make (cloud-based) can achieve the same outcome.

How It Works

1. Trigger: A Notion Webhook detects a database change (Notion supports native Webhooks, so polling is no longer needed)
2. Process: An n8n node calls the Claude API, passing Notion data as context
3. Write back: After Claude responds, n8n updates the Notion page or creates a new item via the Notion API

Real-World Example: Auto-Classifying Customer Feedback

Scenario: An e-commerce team receives 20 pieces of customer feedback daily and needs them auto-classified (product issue / logistics issue / positive review) with follow-up tasks created.

n8n Workflow:

1. Notion Webhook triggers when new feedback enters the database
2. HTTP Request node calls Claude Haiku 4.5 API with the prompt: "Classify the following feedback as product/logistics/positive and suggest a follow-up action"
3. Notion API node updates the category field and creates a follow-up task based on Claude's response

Cost: Each feedback item costs roughly $0.005-$0.01 (shorter input). 600 items/month = $3-6.

Webhook Limitations to Note

According to the official docs, Notion Webhooks have several constraints:

• Max 5 webhook actions per automation
• API rate limit of ~3 requests/second
• Payload uses a sparse format (sends only IDs; you need additional API calls for full content)

Known Limitations and Risks

A DIY approach isn't a silver bullet. Before you switch, here's what you should know.

Operations Not Supported by Notion MCP

• Image uploads (cannot upload attachments to Notion pages via MCP)
• Database deletion (can delete pages, but not entire databases)
• Complex relation/rollup writes (readable, but write support is limited)

npm Package Maintenance Status

The official @notionhq/notion-mcp-server npm package is no longer actively maintained. Notion recommends migrating to the remote MCP (OAuth version). This means:

• Current functionality works fine, but future API features may not be supported
• If Notion introduces breaking API changes, the npm package may not be updated promptly
• Check the GitHub repo's issues and releases periodically

Data Privacy Considerations

When using the Claude API to process Notion data, your data is sent to Anthropic's servers. Per Anthropic's privacy policy:

• API call data is not used for model training (unless you explicitly opt in)
• Data is encrypted in transit and at rest
• If your Notion contains highly sensitive data (customer PII, financial records), assess whether this meets your compliance requirements

Reliability Comparison

Aspect	Notion Custom Agents	Claude API + MCP
Uptime	Guaranteed by Notion	Depends on Anthropic API uptime
Error handling	Built-in retry logic	You handle API errors yourself
Management UI	Managed directly in Notion	Requires config files or n8n dashboard
Fallback	Automatic degradation	You build your own fallback logic

Decision Framework: Should You Stay or Switch?

Based on our testing and cost analysis, here's our recommendation:

Your Situation	Recommendation	Reason
Non-engineer + light use (<60 runs/mo)	Stay with Notion Custom Agents	Credits cost $6-18; not worth the hassle
Engineer + medium-to-heavy use (>100 runs/mo)	Switch to Claude API + npm MCP	Significant cost reduction at usage-based pricing; 30-minute setup
Non-engineer + heavy use (>100 runs/mo)	Switch to n8n + Claude API	No-code path, big savings
Need image/attachment handling	Stay with Notion Custom Agents	MCP doesn't support image uploads
5+ person team with centralized management	Stay with Notion Custom Agents	Team management convenience > cost savings
Already using Claude API	Switch immediately	Marginal cost is nearly zero

Team Cost Comparison (5 Users)

• Notion approach: $100 (Business x 5) + $45 (shared credits) = $145/mo
• Claude API approach: $50 (Plus x 5) + API fees by usage (typically well under $10/mo for a 5-person team)

Conclusion

Notion Custom Agents going paid isn't the end of the world, but for medium-to-heavy users, an extra $9-90/month is hard to ignore. The Claude Haiku 4.5 + Notion MCP combination has been running reliably in our own deployment, at 1/5 to 1/10 the cost of Notion's native offering.

Your next steps:

1. Check your current Custom Agents usage at the Notion credits dashboard
2. If you're over 100 runs/month, head to notion.so/my-integrations and create an Integration Token
3. In 30 minutes, you'll have a Notion agent that costs $0.01 per run

Related reading:

• The Complete Guide to MCP Servers in 2026
• 5 Pitfalls of Deploying MCP in Production
• AI API Cost Comparison for Indie Makers