MCP Setup Guide

How to Set Up Notion MCP with ClawdBot

Turn your Notion workspace into ClawdBot's knowledge base—search pages, read databases, and create content via chat.

Overview

The Notion MCP enables:

Search across all pages and databases
Read page content and database entries
Create new pages (with write permissions)
Query database properties and filters

Prerequisites

ClawdBot installed and running
Notion account with workspace access
Node.js 18+ (for CLI method)

Step 1 — Choose Your Config Method

Option A: CLI Server (Recommended)

Uses OAuth for authentication. Browser will open to authorize.

Notion CLI Config json

{
  "Notion": {
    "command": "npx",
    "args": ["-y", "mcp-remote", "https://mcp.notion.com/mcp"]
  }
}

Option B: SSE Server

Direct connection to Notion's hosted MCP endpoint.

Notion SSE Config json

{
  "Notion": {
    "url": "https://mcp.notion.com/sse"
  }
}

Step 2 — Authorize via OAuth

Add the config to ClawdBot and start the MCP
A browser window will open automatically
Log in to Notion if prompted
Select which pages/databases to share with ClawdBot
Click "Allow access"

Tip: Start with a few test pages. You can expand access later.

Step 3 — Verify

Run clawdbot status — Notion MCP should show as "running"
Test: "Search my Notion for meeting notes"
Test: "Read the page titled 'Project Roadmap'"

Common Errors

Error	Cause	Fix
`OAuth failed`	Browser blocked or timeout	Disable popup blocker, try again
`Page not found`	Page not shared with integration	Re-authorize and include the page
`Rate limited`	Too many API requests	Wait a few minutes, reduce query frequency
`Workspace admin required`	Enterprise workspace restrictions	Contact workspace admin to allow integrations

Enterprise Workspace Notes

Admins may need to approve the Notion MCP integration first
Some workspaces restrict third-party OAuth apps
Test with a personal workspace first if unsure

Example Prompts

"Search Notion for pages about Q1 planning"
"Read my Tasks database and list items due this week"
"Create a new page titled 'Meeting Notes Jan 26' in my Notes database"
"Summarize the page 'Product Roadmap 2026'"

Related MCPs

Google Drive — for Docs/Sheets integration
Slack — for team communication
Top 10 MCPs — full curated list