This is a submission for the Notion MCP Challenge
What I Built
Notion Reverse Autopilot - an AI agent that flips the productivity paradigm on its head.
Every productivity tool assumes you're organized. This one assumes you're not - and fixes it autonomously.
You dump random notes, half-thoughts, and messy content into Notion. The agent does the rest:
- Scans your entire workspace through Notion MCP and generates a Chaos Score (0-100)
- Categorizes every page using AI — project, idea, task, journal, reference, etc.
- Discovers hidden connections between pages you never linked yourself
- Generates cognitive insights — your thinking patterns, blind spots, contradictions, and predictions
- Auto-annotates pages with category/tag/summary callouts
- Creates a Brain Briefing — a rich Notion page with your workspace health, cognitive profile, and what you'll likely need next
- Builds an Autopilot Dashboard with health scores, chaos breakdown, and top insights
- Groups pages into Topic Clusters automatically
- Runs on schedule — set it and forget it, your workspace organizes itself every X hours
The core idea: you stay messy, the AI builds order — and understands you better than you understand yourself.
Key Highlights
- Multi-provider AI — works with Groq (free), Google Gemini (free), Ollama (free/local), or Anthropic. Zero cost to run.
- Full changelog — every action the agent takes is logged for transparency and undo
- CLI-first — clean terminal interface powered by Rich. Scan, organize, briefing, schedule, history — all one command away.
- Chaos detection — tracks untagged pages, orphan content, duplicates, empty pages, structureless content, and more
- Smart rescanning — after organizing, the agent recognizes its own annotations and the chaos score drops accordingly
Video Demo
Show us the code
Notion Reverse Autopilot
Your workspace organizes itself.
Most productivity tools assume you're organized. This one assumes you're NOT — and fixes it autonomously.
Notion Reverse Autopilot is an AI agent that continuously watches your messy Notion workspace, auto-organizes everything, discovers hidden patterns about how you think, and surfaces insights you never knew existed.
"What if you never had to organize Notion again — and it actually understood you better than you understand yourself?"
How It Works
You dump chaos into Notion
|
v
┌─────────────────────────┐
│ Workspace Scanner │ Crawls every page, database, block
└────────┬────────────────┘
v
┌─────────────────────────┐
│ AI Analysis Engine │ Categorizes, finds connections,
│ │ detects cognitive patterns
└────────┬────────────────┘
v
┌─────────────────────────┐
│ Auto-Organizer │ Tags pages, links related ideas,
│ │ builds topic clusters & dashboards
└────────┬────────────────┘
v
┌─────────────────────────┐
│ Brain Briefing │ Health score, hidden connections,
│ │ contradictions, predictions
└─────────────────────────┘
You stay messy. The AI builds order.
…Tech Stack
| Layer | Technology |
|---|---|
| Notion Integration | Official @notionhq/notion-mcp-server via MCP stdio protocol |
| MCP Client | Python mcp SDK with auto-discovery of tools |
| AI Engine | Google Gemini / Groq / Ollama / Anthropic (user's choice) |
| CLI | Click + Rich |
| HTTP | httpx (for LLM API calls) |
| Package Manager | uv |
How I Used Notion MCP
Notion MCP is the core backbone of this project. Every single interaction with Notion — reading pages, scanning content, creating dashboards, writing annotations — goes through the official MCP server. No direct REST API calls.
Architecture
CLI Command (scan / organize / briefing)
│
▼
Python MCP Client (mcp SDK)
│ stdio transport
▼
@notionhq/notion-mcp-server (spawned as subprocess via npx)
│
▼
Notion Workspace (read + write)
How MCP is integrated
1. Auto-discovery at startup
When the agent connects, it calls session.list_tools() to discover all 22 available MCP tools dynamically. It then resolves each logical operation (search, create page, append blocks, etc.) to the correct tool name using a deterministic mapping. This makes the agent forward-compatible with any future MCP server version.
2. Reading the workspace
The agent uses MCP's API-post-search to crawl every page and database in the workspace, then API-get-block-children to read the full content of each page — all through the MCP protocol.
3. Writing back to Notion
After AI analysis, the agent writes results back through MCP:
-
API-post-page— creates the Autopilot Hub, Dashboard, Brain Briefing, and Topic Clusters pages -
API-patch-block-children— appends annotation callouts to existing user pages and updates the dashboard with scan results
4. Full read-write loop
The complete cycle — scan → analyze → organize → briefing — is a full MCP read-write loop. The agent reads your chaos through MCP, processes it with AI, and writes the organized structure back through MCP. On the next scan, it reads its own annotations through MCP to recognize already-organized pages.
What MCP unlocks
Without MCP, this would require direct REST API calls with manual auth headers, pagination handling, and rate limiting. MCP provides:
- Standardized tool interface — one protocol for all Notion operations
- Server-managed auth — token passed via environment, not per-request headers
- Version-agnostic — auto-discovery means no hardcoded endpoints that break on API changes
- Composable — the same agent architecture could connect to multiple MCP servers (Notion + Slack + GitHub) in the future
Notion MCP turns Notion from a document store into a programmable workspace brain — and this project proves it by making that brain self-organizing.
Top comments (0)