Connectors Overview

Connect external platforms to automatically sync documents into supermemory. Supported connectors include Google Drive, Gmail, Notion, OneDrive, GitHub, Granola and Web Crawler with real-time synchronization and intelligent content processing.

Supported Connectors

Google Drive

Google Docs, Slides, SheetsReal-time sync via webhooks. Supports shared drives, nested folders, and collaborative documents.

Gmail

Email ThreadsReal-time sync via Pub/Sub webhooks. Syncs threads with full conversation history and metadata.

Notion

Pages, Databases, BlocksInstant sync of workspace content. Handles rich formatting, embeds, and database properties.

OneDrive

Word, Excel, PowerPointScheduled sync every 4 hours. Supports personal and business accounts with file versioning.

GitHub

GitHub RepositoriesReal-time incremental sync via webhooks. Supports documentation files in repositories.

Granola

Meeting notes and transcriptsSyncs AI meeting notes, summaries, attendees, and transcripts from your Granola workspace.

Web Crawler

Web Pages, DocumentationCrawl websites automatically with robots.txt compliance. Scheduled recrawling keeps content up to date.

Quick Start

1. Create Connection

import Supermemory from 'supermemory';

const client = new Supermemory({
  apiKey: process.env.SUPERMEMORY_API_KEY!
});

const connection = await client.connections.create('notion', {
  redirectUrl: 'https://yourapp.com/callback',
  containerTag: 'user-123',
  documentLimit: 5000,
  metadata: { department: 'sales' }
});

// Redirect user to complete OAuth
console.log('Auth URL:', connection.authLink);
console.log('Expires in:', connection.expiresIn);
// Output: Auth URL: https://api.notion.com/v1/oauth/authorize?...
// Output: Expires in: 1 hour

from supermemory import Supermemory
import os

client = Supermemory(api_key=os.environ.get("SUPERMEMORY_API_KEY"))

connection = client.connections.create(
    'notion',
    redirect_url='https://yourapp.com/callback',
    container_tag='user-123',
    document_limit=5000,
    metadata={'department': 'sales'}
)

# Redirect user to complete OAuth
print(f'Auth URL: {connection.auth_link}')
print(f'Expires in: {connection.expires_in}')
# Output: Auth URL: https://api.notion.com/v1/oauth/authorize?...
# Output: Expires in: 1 hour

curl -X POST "https://api.supermemory.ai/v3/connections/notion" \
  -H "Authorization: Bearer $SUPERMEMORY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "redirectUrl": "https://yourapp.com/callback",
    "containerTag": "user-123",
    "documentLimit": 5000,
    "metadata": {"department": "sales"}
  }'

# Response: {
#   "authLink": "https://api.notion.com/v1/oauth/authorize?...",
#   "expiresIn": "1 hour",
#   "id": "conn_abc123",
#   "redirectsTo": "https://yourapp.com/callback"
# }

2. Handle OAuth Callback

After user completes OAuth, the connection is automatically established and sync begins.

3. Monitor Sync Status

import Supermemory from 'supermemory';

const client = new Supermemory({
  apiKey: process.env.SUPERMEMORY_API_KEY!
});

// List all connections using SDK
const connections = await client.connections.list({
  containerTags: ['user-123']
});

connections.forEach(conn => {
  console.log('Connection:', conn.id);
  console.log('Provider:', conn.provider);
  console.log('Email:', conn.email);
  console.log('Created:', conn.createdAt);
});

// List synced documents (memories) using SDK
const memories = await client.documents.list({
  containerTags: ['user-123']
});

console.log(`Synced ${memories.memories.length} documents`);
// Output: Synced 45 documents

from supermemory import Supermemory
import os

client = Supermemory(api_key=os.environ.get("SUPERMEMORY_API_KEY"))

# List all connections using SDK
connections = client.connections.list(
    container_tags=['user-123']
)

for conn in connections:
    print(f'Connection: {conn.id}')
    print(f'Provider: {conn.provider}')
    print(f'Email: {conn.email}')
    print(f'Created: {conn.created_at}')

# List synced documents (memories) using SDK
memories = client.documents.list(container_tags=['user-123'])

print(f'Synced {len(memories.memories)} documents')
# Output: Synced 45 documents

# List all connections
curl -X POST "https://api.supermemory.ai/v3/connections/list" \
  -H "Authorization: Bearer $SUPERMEMORY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"containerTags": ["user-123"]}'

# Response: [{"id": "conn_abc", "provider": "notion", "email": "user@example.com", ...}]

# List synced documents
curl -X POST "https://api.supermemory.ai/v3/documents/list" \
  -H "Authorization: Bearer $SUPERMEMORY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"containerTags": ["user-123"]}'

# Response: {"results": [...], "totalCount": 45}

How Connectors Work

Authentication Flow

Create Connection: Call /v3/connections/{provider} to get an OAuth URL, or create a direct credential-based connection for Granola or Web Crawler
User Authorization: Redirect user to complete OAuth flow when the provider requires it
Automatic Setup: Connection established, sync begins immediately
Continuous Sync: Real-time updates via webhooks + scheduled sync every 4 hours (or scheduled recrawling for Web Crawler)

Document Processing Pipeline

Sync Mechanisms

Provider	Real-time Sync	Scheduled Sync	Manual Sync
Google Drive	✅ Webhooks (7-day expiry)	✅ Every 4 hours	✅ On-demand
Gmail	✅ Pub/Sub (7-day expiry)	✅ Every 4 hours	✅ On-demand
Notion	✅ Webhooks	✅ Every 4 hours	✅ On-demand
OneDrive	✅ Webhooks (30-day expiry)	✅ Every 4 hours	✅ On-demand
GitHub	✅ Webhooks	✅ Every 4 hours	✅ On-demand
Granola	❌ Not supported	❌ Not supported	✅ On-demand
Web Crawler	❌ Not supported	✅ Scheduled recrawling (7+ days)	✅ On-demand

Connection Management

List All Connections

import Supermemory from 'supermemory';

const client = new Supermemory({
  apiKey: process.env.SUPERMEMORY_API_KEY!
});

const connections = await client.connections.list({
  containerTags: ['org-123']
});

from supermemory import Supermemory
import os

client = Supermemory(api_key=os.environ.get("SUPERMEMORY_API_KEY"))

connections = client.connections.list(container_tags=['org-123'])

for conn in connections:
    print(f"{conn.provider}: {conn.email} ({conn.id})")
    print(f"Documents: {conn.document_limit or 'unlimited'}")
    print(f"Expires: {conn.expires_at or 'never'}")
# Output: notion: user@company.com (conn_abc123)
# Output: Documents: 5000
# Output: Expires: never

curl -X POST "https://api.supermemory.ai/v3/connections/list" \
  -H "Authorization: Bearer $SUPERMEMORY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"containerTags": ["org-123"]}'

# Response: [
#   {
#     "id": "conn_abc123",
#     "provider": "notion",
#     "email": "user@company.com",
#     "documentLimit": 5000,
#     "createdAt": "2024-01-15T10:30:00.000Z"
#   }
# ]

Delete Connections

The DELETE /v3/connections/:connectionId endpoint accepts an optional deleteDocuments query parameter:

Parameter	Type	Default	Description
`deleteDocuments`	boolean	`true`	When `true`, all documents imported by the connection are permanently deleted. When `false`, the connection is removed but documents are kept.

Setting deleteDocuments=false is useful when you want to disconnect an integration without losing the memories that were already imported.

import Supermemory from 'supermemory';

const client = new Supermemory({
  apiKey: process.env.SUPERMEMORY_API_KEY!
});

// Delete connection and all imported documents (default)
const result = await client.connections.deleteByID(connectionId);

// Delete connection but keep imported documents
const result = await client.connections.deleteByID(connectionId, {
  deleteDocuments: false
});

// Or delete by provider (requires container tags)
const result = await client.connections.deleteByProvider('notion', {
  containerTags: ['user-123']
});

console.log('Deleted:', result.id, result.provider);

from supermemory import Supermemory
import os

client = Supermemory(api_key=os.environ.get("SUPERMEMORY_API_KEY"))

# Delete connection and all imported documents (default)
result = client.connections.delete_by_id(connection_id)

# Delete connection but keep imported documents
result = client.connections.delete_by_id(connection_id, delete_documents=False)

# Or delete by provider (requires container tags)
result = client.connections.delete_by_provider(
    provider='notion',
    container_tags=['user-123']
)

print(f"Deleted: {result.id} {result.provider}")

# Delete connection and all imported documents (default)
curl -X DELETE "https://api.supermemory.ai/v3/connections/conn_abc123" \
  -H "Authorization: Bearer $SUPERMEMORY_API_KEY"

# Delete connection but keep imported documents
curl -X DELETE "https://api.supermemory.ai/v3/connections/conn_abc123?deleteDocuments=false" \
  -H "Authorization: Bearer $SUPERMEMORY_API_KEY"

# Response: {
#   "id": "conn_abc123",
#   "provider": "notion"
# }

Custom OAuth Applications

By default, Supermemory uses its own OAuth applications to connect to third-party providers. You can configure your own OAuth app credentials via PATCH /v3/settings for tighter control over data access — useful for enterprise customers.

Create the OAuth application on the provider’s developer console:
- Google: console.developers.google.com/apis/credentials/oauthclient
- Notion: notion.so/my-integrations
- OneDrive: Azure Portal → App registrations
For Google Drive specifically: choose application type Web application, and enable the Google Drive API under “APIs and Services” in the Cloud Console. Google also requires verification/approval before custom keys work in production.
Set the redirect URL to https://api.supermemory.ai/v3/connections/auth/callback/{provider} (for example, .../auth/callback/google-drive).

Enabling custom keys for a provider applies to all new connections for that provider — existing connections will need to be re-authorized.

Getting Started

Concepts

Using supermemory

Deployment

Other resources

Migration Guides

Supported Connectors

Google Drive

Gmail

Notion

OneDrive

GitHub

Granola

Web Crawler

Quick Start

1. Create Connection

2. Handle OAuth Callback

3. Monitor Sync Status

How Connectors Work

Authentication Flow

Document Processing Pipeline

Sync Mechanisms

Connection Management

List All Connections

Delete Connections

Custom OAuth Applications

​Supported Connectors

Google Drive

Gmail

Notion

OneDrive

GitHub

Granola

Web Crawler

​Quick Start

​1. Create Connection

​2. Handle OAuth Callback

​3. Monitor Sync Status

​How Connectors Work

​Authentication Flow

​Document Processing Pipeline

​Sync Mechanisms

​Connection Management

​List All Connections

​Delete Connections

​Custom OAuth Applications

Supported Connectors

Quick Start

1. Create Connection

2. Handle OAuth Callback

3. Monitor Sync Status

How Connectors Work

Authentication Flow

Document Processing Pipeline

Sync Mechanisms

Connection Management

List All Connections

Delete Connections

Custom OAuth Applications