Notion

Import pages and databases from Notion into PuppyOne.

Supported content

Setup steps

Step 1: Start the import

1. Open your Project
2. Click Import → Notion

Step 2: Authorize Notion

The first time you use it, you need to complete OAuth authorization:

1. Click Connect Notion
2. In the Notion popup, choose the Workspace you want to authorize
3. Select the pages you want to share with PuppyOne, either all or only some of them
4. Click Allow access

💡 Tip: You can authorize only specific pages. PuppyOne can access only the content you explicitly grant access to.

Step 3: Choose what to import

After authorization succeeds, you will see a list of pages available for import:

1. Check the pages or databases you want to import
2. Click Import

Step 4: Wait for processing

The import runs in the background. You can track progress in the Tasks panel.

When processing is complete, your Notion content is converted into content nodes and written into your project file tree.

Data structure examples

Notion page → JSON

{
  "title": "Product Requirements Document",
  "content": "## Background\n\nThis is a...",
  "created_at": "2024-01-15",
  "last_edited": "2024-01-20",
  "properties": {
    "Status": "In Progress",
    "Owner": "Alice"
  }
}

Notion database → JSON array

{
  "database_title": "Product List",
  "items": [
    {
      "name": "Widget Pro",
      "price": 99.99,
      "category": "Electronics"
    },
    {
      "name": "Gadget X",
      "price": 149.99,
      "category": "Accessories"
    }
  ]
}

Sync settings

Manual sync

Find the corresponding Notion connection in your Project connection list, then click Sync to manually pull the latest content.

Automatic sync (coming soon)

Scheduled automatic sync will be supported in the future.

FAQ

Why can't I see some pages?

Make sure you selected those pages during Notion OAuth authorization. You can re-authorize from Settings → Connections.

Why is the import slow?

Large Notion databases may take a few minutes. You can check progress in the Tasks panel.

Why weren't images imported?

For now, images are kept as links. If a Notion image is private, the agent may not be able to access it directly.

Next steps

• Manage imported data
• Auth for Agents
• Distribute to Agents