Customizing for Your Use Case

Configure Supermemory's behavior for your specific application

Configure how Supermemory processes and retrieves content for your specific use case.

Filter Prompts

Tell Supermemory what content matters during ingestion. This helps filter and prioritize what gets indexed.

// Example: Brand guidelines assistant
await client.settings.update({
  shouldLLMFilter: true,
  filterPrompt: `You are ingesting content for Brand.ai's brand guidelines system.

    Index:
    - Official brand values and mission statements
    - Approved tone of voice guidelines
    - Logo usage and visual identity docs
    - Approved messaging and taglines

    Skip:
    - Draft documents and work-in-progress
    - Outdated brand materials (pre-2024)
    - Internal discussions about brand changes
    - Competitor analysis docs`
});

Personal Assistant

```typescript
filterPrompt: `Personal AI assistant. Prioritize recent content, action items,
and personal context. Exclude spam and duplicates.`
```

Customer Support

```typescript
filterPrompt: `Customer support agent. Prioritize verified solutions, official docs,
and resolved tickets. Exclude internal discussions and PII.`
```

Legal Assistant

```typescript
filterPrompt: `Legal research assistant. Prioritize precedents, current regulations,
and approved contract language. Exclude privileged communications.`
```

Finance Agent

```typescript
filterPrompt: `Financial analysis assistant. Prioritize latest reports, verified data,
and regulatory filings. Exclude speculative data and MNPI.`
```

Healthcare

```typescript
filterPrompt: `Healthcare information assistant. Prioritize evidence-based guidelines
and FDA-approved info. Exclude PHI and outdated recommendations.`
```

Developer Docs

```typescript
filterPrompt: `Developer documentation assistant. Prioritize current APIs, working
examples, and best practices. Exclude deprecated APIs and test fixtures.`
```

---

Entity Context

Guide memory extraction for a specific container tag. Filter prompts are org-wide; entity context is per container.

await client.add({
  content: "User asked about logo variations for dark backgrounds...",
  containerTag: "session_abc123",
  entityContext: `Design exploration conversation between john@acme.com and Brand.ai assistant.
    Focus on John's design preferences and brand requirements.`
});

Update entity context only

Update entity context for a container tag without uploading content.

await client.containerTags.update("session_abc123", {
  entityContext: `Design exploration conversation between john@acme.com and Brand.ai assistant.
    Focus on John's design preferences and brand requirements.`
});

INFO

Entity context persists on the container tag and combines with org-level filter prompts.

---

Chunk Size

Control how documents are split into searchable pieces. Smaller chunks = more precise retrieval but less context per result.

await client.settings.update({
  chunkSize: 512  // -1 for default
});

Use Case	Chunk Size	Why
Citations & references	256-512	Precise source attribution
Q&A / Support	512-1024	Balanced context
Long-form analysis	1024-2048	More context per chunk
Default	-1	Supermemory's optimized default

INFO

Smaller chunks generate more memories per document. Larger chunks provide more context but may reduce precision.

---

Connector Branding

Show "Log in to YourApp" instead of "Log in to Supermemory" when users connect external services. See Connectors Overview for the full list of supported integrations.

Google Drive

1. Create OAuth credentials in Google Cloud Console
2. Redirect URI: `https://api.supermemory.ai/v3/connections/google-drive/callback`

```typescript
await client.settings.update({
  googleDriveCustomKeyEnabled: true,
  googleDriveClientId: "your-client-id.apps.googleusercontent.com",
  googleDriveClientSecret: "your-client-secret"
});
```

Notion

1. Create integration at Notion Developers
2. Redirect URI: `https://api.supermemory.ai/v3/connections/notion/callback`

```typescript
await client.settings.update({
  notionCustomKeyEnabled: true,
  notionClientId: "your-notion-client-id",
  notionClientSecret: "your-notion-client-secret"
});
```

OneDrive

1. Register app in Azure Portal
2. Redirect URI: `https://api.supermemory.ai/v3/connections/onedrive/callback`

```typescript
await client.settings.update({
  onedriveCustomKeyEnabled: true,
  onedriveClientId: "your-azure-app-id",
  onedriveClientSecret: "your-azure-client-secret"
});
```

---

API Reference

// Get current settings
const settings = await client.settings.get();

// Update settings
await client.settings.update({
  shouldLLMFilter: true,
  filterPrompt: "...",
  chunkSize: 512
});

INFO

Settings are organization-wide. Changes apply to new content only—existing memories aren't reprocessed.

---

Next Steps

Add Memories

See your custom settings in action

Connectors

Set up automatic syncing from external platforms