Integrations

Notion Integration

Connect Notion to sync your knowledge base, wikis, and project documentation. Pages are automatically classified with smart type detection for powerful filtering.

Smart Type Detection

Notion pages are automatically classified based on database properties (Status, Priority, Due Date, Assignee). This enables filtering like "show me high-priority tasks" or "find bugs in progress" without manual tagging.

What You Get

Once connected, your Notion content enriches AI interactions across ContextStream. Here's how it adds value:

Automatic Context Enrichment

When you call context_smart or session_smart_search, relevant Notion pages and decisions are automatically included in AI responses. No extra tools needed — your existing prompts become smarter.

Example: Ask "What is our onboarding process?" and get content from your Engineering Onboarding wiki without calling any Notion-specific tool.

Smart Type Detection

Pages are automatically classified as Tasks, Meetings, Wiki, Bugs, Features, or Journals based on their database properties. Filter by type, status, priority, due date, or tags.

Example: Use integration(provider="notion", action="search_pages", event_type="NotionTask", priority="High") to find high-priority tasks.

Extracted Knowledge

ContextStream automatically distills decisions, lessons, and insights from your Notion pages. These become searchable memory that persists across sessions.

Example: Use integration(provider="notion", action="knowledge") to see decisions extracted from meeting notes.

Unified Memory

Notion pages become memory events alongside your manual captures. Use memory(action="search", ...) or session(action="recall", ...) to find Notion content mixed with your other decisions and notes.

Example: "What do we know about the payment system?" returns your captured decisions AND relevant Notion documentation.

Project-Scoped Pages

Pages created via the API while in a project context are automatically scoped to that project. This means they appear in Project Knowledge rather than just workspace-level memory.

Example: Create a task from your IDE while working on a specific project, and it becomes part of that project's knowledge base.

Smart Type Detection

Pages are automatically classified based on their database properties:

Type	Detection Criteria	Example Use
NotionTask	Status + Due Date + Assignee	Project tasks, sprint items
NotionMeeting	Status + Date + Attendees	Meeting notes, 1:1s
NotionBugReport	Status + Priority + Bug-related	Bug tracking databases
NotionFeature	Status + Priority + Feature-related	Feature requests
NotionWiki	Content-focused, no workflow props	Documentation, wikis
NotionJournal	Date-based entries	Daily logs, standups
NotionPage	Generic fallback	Any other pages

Example Prompts

Try these prompts in your AI editor to see Notion integration in action:

>"How do I set up the dev environment?"

>"Show me all high-priority tasks"

>"What meetings happened this week?"

>"Find bugs that are in progress"

>"What decisions are recorded in our meeting notes?"

>"Save this plan to Notion"

>"What documentation has changed this week?"

Overview

The Notion integration brings your knowledge base into ContextStream, making pages, databases, and documentation searchable and available as context for your AI tools. Content is synced as memory events with smart type detection.

Real-Time Webhooks

Pages are synced via webhooks as they're created or updated.

Smart Filtering

Filter by type, status, priority, due date, or tags extracted from properties.

Knowledge Extraction

Decisions, facts, and lessons are automatically extracted from pages.

Setup Guide

1. Connect Your Notion Workspace

1Go to your ContextStream workspace settings and navigate to Integrations.
2Click Connect on the Notion card to start the OAuth flow.
3Select the pages and databases you want to share with ContextStream.
4Once connected, the Notion card will show "Connected" status.

2. Select Databases and Pages

1Click Configure on the connected Notion integration.
2Browse available databases and standalone pages from your Notion workspace.
3Select the content you want to sync. Database pages are synced with smart type detection.

3. Initial Sync

After selecting content, ContextStream will perform an initial sync to import pages with their properties and content.

Click Sync Now at any time to trigger an immediate sync of all configured content.

What Gets Synced

Content Type	Details	Metadata Captured
Database Pages	All pages from selected databases	Title, content, Status, Priority, Due Date, Assignee, Tags
Wiki Pages	Standalone pages and wikis	Title, full text content, structure
Blocks	Page content blocks	Text, headings, lists, code blocks
Properties	Database properties	Extracted for smart type detection and filtering

MCP Tools (v0.4.x)

Access Notion data through the consolidated integration tool available in Claude Code, Cursor, Windsurf, and other MCP-compatible editors.

Use integration(provider="notion", action="...") for Notion-specific queries.

integration(provider="notion", action="stats")

Get overview statistics: total pages synced, databases tracked, knowledge nodes extracted, and sync status.

integration(provider="notion", action="search_pages", event_type="NotionTask", priority="High")Smart Filtering

Search pages with smart type detection. Filter by event_type, status, priority, has_due_date, tags.

integration(provider="notion", action="list_databases")

List all synced databases with their names, IDs, and property schemas.

integration(provider="notion", action="get_page", page_id="...")

Get detailed content of a specific page including all blocks, properties, and metadata.

integration(provider="notion", action="activity")

Get recent activity feed showing recently updated pages with titles, URLs, and timestamps.

integration(provider="notion", action="knowledge")

Get decisions, lessons, and insights automatically extracted from Notion pages. Filter by knowledge type.

integration(provider="notion", action="summary")

Get a high-level summary of Notion integration status with sync health and content overview.

integration(provider="notion", action="create_page", title="...", content="...")Write

Create a new page in Notion. Supports Markdown content which is automatically converted to Notion blocks. Specify parent_database_id or parent_page_id. If project_id is provided (or inferred from session context), the page memory event is scoped to that project.

integration(provider="all", action="search", query="...")Cross-Source

Search across Notion, GitHub, and Slack in a single query. Results ranked by relevance across all sources.

Security & Privacy

OAuth 2.0 Authentication

ContextStream uses Notion's official OAuth flow. Your credentials are never stored — only encrypted access tokens.

Explicit Page Selection

You choose exactly which pages and databases to share. No content is synced without your explicit selection.

Read-Only by Default

We only read content for syncing. The create_page action is the only write operation, and it's opt-in.

Revoke Anytime

Disconnect the integration at any time from your workspace settings or Notion settings. This revokes access and stops all syncing.

Sync Behavior

Real-Time Webhooks

New and updated pages are captured via Notion webhooks as they're modified. This provides near-instant sync for content changes.

Periodic Polling

A background sync runs periodically to catch any missed events and ensure content is up to date.

Manual Sync

Click Sync Now in the integration settings to trigger an immediate full sync of all configured content.

Smart Type Detection

Properties are extracted during sync to automatically classify pages by type (Task, Meeting, Wiki, etc.).

Troubleshooting

No Notion data found

In Notion, you must explicitly share pages/databases with the ContextStream integration if you didn't select "All pages" during OAuth. Go to the page in Notion, click Share, and add the ContextStream integration.

Smart type detection not working

Ensure your database has the expected properties (Status, Priority, Due Date, Assignee). Property names are detected case-insensitively. Pages without workflow properties default to NotionPage type.

Sync not updating

Check integrations_status for error messages. Try disconnecting and reconnecting if the token has expired or permissions changed.

Permission denied

Verify that the specific page or database is shared with the ContextStream integration. Check that your ContextStream workspace membership allows access.

Next Steps

Once connected, Notion pages become Memory Events (source: notion) with smart type detection, available to your AI tools via MCP.

Back to integrations overview or see GitHub integration or Slack integration.

Notion is a trademark of Notion Labs, Inc. ContextStream is not affiliated with, endorsed by, or sponsored by Notion Labs, Inc.