continuedev · bdougie · Oct 9, 2025 · Oct 2, 2025 · Oct 2, 2025 · Oct 2, 2025
@@ -262,7 +262,8 @@
               "guides/posthog-github-continuous-ai",
               "guides/snyk-mcp-continue-cookbook",
               "guides/dlt-mcp-continue-cookbook",
-              "guides/netlify-mcp-continuous-deployment"
+              "guides/netlify-mcp-continuous-deployment",
+              "guides/notion-continue-cookbook"
             ]
           }
         ]

diff --git a/docs/guides/notion-continue-cookbook.mdx b/docs/guides/notion-continue-cookbook.mdx
@@ -0,0 +1,313 @@
+---
+title: "Developer & Team Workflows with Notion MCP + Continue"
+description: "Use Continue CLI and the Notion MCP to generate docs, manage tasks, and automate project workflows – all through natural-language prompts."
+sidebarTitle: "Notion with Continue"
+---
+
+<Card title="What You'll Build" icon="notion">
+
+  A workflow that lets you query, update, and create Notion pages or database
+  entries from natural-language prompts. Generate PRDs, sprint tasks, meeting
+  notes, or status reports automatically – perfect for individual developers
+  and cross-functional teams.
+
+</Card>
+
+## What You'll Learn
+
+- Connect the [Notion MCP](https://hub.continue.dev/notion/notion-mcp) to Continue
+- Securely add both Notion and Continue API keys as Hub secrets
+- Use a pre-built agent (`continuedev/notion-continuous-ai`) for instant productivity
+- Issue advanced prompts to automate docs, tasks, and reporting
+
+## Prerequisites
+
+Before starting, ensure you have:
+
+- [Continue CLI](/guides/cli) installed (`npm i -g @continuedev/cli`)
+- A [Notion workspace](https://notion.so) with Editor (or higher) access
+- Node.js 18+ installed locally
+- [Continue account](https://hub.continue.dev) with **Hub access**
+
+<Warning>
+
+  **Agent usage requires credits** – create a Continue API key at
+  [hub.continue.dev/settings/api-keys](https://hub.continue.dev/settings/api-keys)
+  and store it as a secret.
+
+</Warning>
+
+<Steps>
+  <Step title="Install Continue CLI">
+    ```bash
+    npm i -g @continuedev/cli
+    ```
+    Verify installation:
+    ```bash
+    cn --version
+    ```
+  </Step>
+
+  <Step title="Create Notion Integration & Get Token">
+    1. Go to **[Notion Integrations](https://www.notion.so/my-integrations)**
+    2. Click **+ New integration** → give it a name (e.g. "Continue MCP")
+    3. Select your workspace
+    4. Under **Capabilities** enable **Read** / **Write**
+    5. Click **Submit** and Copy the **Internal Integration Token**
+
+    <Info>
+
+      This token is your `NOTION_MCP_TOKEN` secret.
+      Keep it safe – you won't be able to view it again.
+
+    </Info>
+
+    6. In Notion, open each database or top-level page you want accessible → **Share** → **Invite** your new integration → **Full access**.
+  </Step>
+
+  <Step title="Add Secrets to Continue Hub">
+    1. Open **[Continue Hub Secrets](https://hub.continue.dev/settings/secrets)**
+    2. Click **+ New Secret** and add the following:
+      - **Key:** `NOTION_MCP_TOKEN` → **Value:** `secret_...` (Your token from Step 2)
+      - **Key:** `CONTINUE_API_KEY` → **Value:** `cont_api_...` (Your Continue API key)
+
+    <Tip>
+
+      Continue's secure storage means secrets are available in any prompt as
+      `$NOTION_MCP_TOKEN` etc.
+
+    </Tip>
+  </Step>
+</Steps>
+
+## Notion Continuous AI Workflow Options
+
+<Card title="🚀 Fastest Path to Success" icon="zap">
+
+  Skip the manual setup and use our pre-built Notion agent that includes
+  optimized prompts, rules, and the Notion MCP for more consistent results.
+
+</Card>
+
+<Tabs>
+  <Tab title="⚡ Quick Start (Recommended)">
+    **Perfect for:** Immediate results with optimized prompts and built-in workflows
+
+    <Steps>
+      <Step title="Load the Pre-Built Agent">
+        Navigate to your project directory and run:
+        ```bash
+        cn --config continuedev/notion-continuous-ai
+        ```
+
+        This agent includes:
+        - **Pre-installed Notion MCP** for seamless integration
+        - **Developer-focused rules** for technical documentation
+        - **Code-aware prompts** that understand your repository structure
+      </Step>
+
+      <Step title="Run Your First Prompt">
+        ```bash
+        cn "Create a PRD outline for the new payment flow and save it to my Product Specs database."
+        ```
+
+        That's it! The agent handles everything automatically.
+      </Step>
+    </Steps>
+
+    <Info>
+
+      **Why Use the Agent?** Results are more consistent and debugging is easier thanks to the Notion MCP integration and pre-tested prompts.
+
+    </Info>
+
+  </Tab>
+
+  <Tab title="🛠️ Manual Setup">
+    <Steps>
+      <Step title="Connect Notion MCP Manually">
+        Run the Notion MCP directly:
+        ```bash
+        npx -y @notionhq/mcp-remote https://mcp.notion.com/sse \
+        --header Authorization:$NOTION_MCP_TOKEN
+        ```
+      </Step>
+
+      <Step title="Create / Edit Your Agent on Hub">
+        1. Click **New Agent** on **[Continue Hub](https://hub.continue.dev)**
+        2. Add **Notion MCP** under **Tools**
+        3. Add any **rules** / **prompts** you like
+      </Step>
+
+      <Step title="Launch With Continue CLI">
+        ```bash
+        cn --config user/my-notion-agent
+        ```
+      </Step>
+    </Steps>
+  </Tab>
+</Tabs>
+
+<Accordion title="Agent Requirements">
+
+  To use the pre-built agent, you need either:
+  - **Continue CLI Pro Plan** with the models add-on, OR
+  - **Your own API keys** added to Continue Hub secrets
+
+  The agent will automatically detect and use your configuration.
+
+</Accordion>
+
+---
+
+## Example Prompts & Workflows
+
+Now you can use natural language prompts to automate Notion. The Continue agent automatically calls the appropriate Notion MCP tools.
+
+<CardGroup cols={2}>
+  <Card title="API Documentation" icon="code">
+    **Prompt:**
+    ```
+    Generate API documentation for all endpoints in src/api/routes
+    with request/response schemas. Create a page in the
+    Technical Docs database with authentication requirements.
+    ```
+  </Card>
+
+  <Card title="Sprint Planning from Code" icon="list-checks">
+    **Prompt:**
+    ```
+    Scan the codebase for TODO and FIXME comments. Create tasks
+    in the Engineering Backlog database with code context,
+    file paths, and estimated complexity.
+    ```
+  </Card>
+
+  <Card title="Launch Week Orchestration" icon="rocket">
+    **Prompt:**
+    ```
+    Review commits since last release and my Launch Ideas notes.
+    Generate a Launch Week page with: feature announcements,
+    daily checklists, draft X/LinkedIn posts, and demo scripts.
+    ```
+  </Card>
+
+  <Card title="RFC from Discussion" icon="comments">
+    **Prompt:**
+    ```
+    Turn our Slack architecture discussion from #eng-design into
+    a proper RFC. Include problem statement, proposed solution,
+    alternatives considered, and implementation timeline.
+    ```
+  </Card>
+</CardGroup>
+
+---
+
+## Advanced Workflows
+
+### Multi-Tool Workflows
+
+Combine Notion with other MCPs for powerful automation:
+
+<CardGroup cols={2}>
+  <Card title="Notion + GitHub" icon="github">
+    ```
+    "Analyze all merged PRs this sprint, extract feature
+    descriptions and breaking changes, then create a
+    technical changelog in Notion with links to PRs."
+    ```
+  </Card>
+
+  <Card title="Notion + PostHog" icon="chart-bar">
+    ```
+    "Pull feature adoption metrics from PostHog for our last
+    release. Create a product insights page with usage graphs,
+    user segments, and recommendations for improvements."
+    ```
+    See the [PostHog Analytics Guide](/guides/posthog-github-continuous-ai)
+  </Card>
+
+  <Card title="Code Review Insights" icon="magnifying-glass">
+    **🎯 Outside the Box:**
+    ```
+    "Analyze my code review comments from the past month.
+    Create a 'Personal Code Review Patterns' page highlighting
+    what I catch most often and blind spots to improve."
+    ```
+  </Card>
+
+  <Card title="Notion + Linear" icon="list">
+    ```
+    "Sync Linear issues tagged 'customer-reported' to Notion's
+    Customer Feedback database. Add impact scores based on
+    number of duplicate reports and affected users."
+    ```
+  </Card>
+</CardGroup>
+
+---
+
+## Security Best Practices
+
+<Warning>
+
+  **Protect Your API Keys:**
+  - Treat `NOTION_MCP_TOKEN` like a password → rotate every 90 days
+  - Grant the integration only required page/database access
+  - Use Continue's secrets, never commit tokens to git
+  - Monitor token usage for unusual activity
+
+</Warning>
+
+---
+
+## What You've Built
+
+After completing this guide, you have a complete **AI-powered Notion automation system** that:
+
+- **Generates content** - Create PRDs, meeting notes, and documentation with natural language
+- **Manages tasks** - Update databases, track progress, and sync with other tools  
+- **Runs autonomously** - Set up GitHub Actions for scheduled documentation updates
+- **Scales with your team** - Handle growing documentation needs automatically
+
+<Card title="Continuous AI" icon="rocket">
+
+  Your system now operates at **[Level 2 Continuous AI](https://blog.continue.dev/what-is-continuous-ai-a-developers-guide/)** -
+  AI handles routine documentation and task management with human oversight
+  through review and approval of generated content.
+
+</Card>
+
+---
+
+## Next Steps
+
+- Add a **GitHub Actions** workflow to run `cn` nightly and publish status pages
+- Combine with **Slack MCP** for bi-directional updates
+- Explore **rule-based guardrails** to enforce doc templates
+- Set up **multi-tool workflows** connecting GitHub, Linear, or other services
+
+---
+
+## Resources
+
+<CardGroup>
+  <Card title="Notion MCP Docs" icon="book" href="https://developers.notion.com/docs/mcp/">
+    Official documentation for the Notion MCP.
+  </Card>
+
+  <Card title="Continue CLI Reference" icon="terminal" href="/guides/cli">
+    A complete guide to using the Continue CLI.
+  </Card>
+
+  <Card title="Pre-built Notion Agent" icon="robot" href="https://hub.continue.dev/agents/continuedev/notion-continuous-ai">
+    View the pre-built agent on Continue Hub.
+  </Card>
+
+  <Card title="Notion API Documentation" icon="code" href="https://developers.notion.com/reference/intro">
+    Complete Notion API reference and guides.
+  </Card>
+</CardGroup>
+
+Happy automating!
@@ -22,6 +22,7 @@ Step-by-step guides for integrating Model Context Protocol (MCP) servers with Co
 - [PostHog Session Analysis Cookbook](/guides/posthog-github-continuous-ai) - Analyze user behavior data to optimize your codebase with automatic issue creation
 - [Netlify Performance Optimization Cookbook](/guides/netlify-mcp-continuous-deployment) - Optimize web performance with A/B testing and automated monitoring using Netlify MCP
 - [Snyk + Continue Hub Agent Cookbook (MCP)](/guides/snyk-mcp-continue-cookbook) - Integrate Snyk MCP via Continue Hub to scan code, deps, IaC, and containers
+- [Notion + Continue Cookbook](/guides/notion-continue-cookbook) - Automate docs, tasks, and release workflows 
 
 ## What Advanced Tutorials Are Available