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

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

└─────────────────────────┘

Tech Stack

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.