Granola Connector

Connect Granola to sync AI meeting notes and transcripts into your Supermemory knowledge base. The connector uses a Granola API key, so there is no OAuth redirect flow.

The Granola connector requires a Pro Plan or higher in Supermemory and a Granola plan that can create API keys. In Granola, create one from Settings > Connectors > API keys.

Quick Setup

From the Console

Open the Supermemory Console.
Go to Connectors.
Find the Granola row and click Connect.
Paste your Granola API key.
Optionally set a document limit and container tag.
Click Connect.

The console creates the connection and starts the initial sync automatically.

The console limits connector setup to 500 documents. Use the API setup below for higher documentLimit values, up to 10,000.

With the API

TypeScript
Python
cURL

import Supermemory from 'supermemory';

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

const connection = await client.connections.create('granola', {
  metadata: {
    apiKey: process.env.GRANOLA_API_KEY!
  },
  containerTag: 'org-123',
  documentLimit: 1000
});

console.log('Granola connection:', connection.id);

from supermemory import Supermemory
import os

client = Supermemory(api_key=os.environ["SUPERMEMORY_API_KEY"])

connection = client.connections.create(
    'granola',
    metadata={
        'apiKey': os.environ["GRANOLA_API_KEY"]
    },
    container_tag='org-123',
    document_limit=1000
)

print(f'Granola connection: {connection.id}')

curl -X POST "https://api.supermemory.ai/v3/connections/granola" \
  -H "Authorization: Bearer $SUPERMEMORY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "metadata": {
      "apiKey": "'"$GRANOLA_API_KEY"'"
    },
    "containerTag": "org-123",
    "documentLimit": 1000
  }'

Supermemory validates the Granola API key before creating the connection. The initial sync starts automatically after the connection is created.

Configuration Options

For Granola, provider-specific fields are passed inside the top-level metadata object. General connection options stay top-level.

Parameter	Location	Required	Description
`apiKey`	`metadata.apiKey`	Yes	Granola API key from Settings > Connectors > API keys
`containerTag`	top-level	No	Tag for organizing imported notes by user, organization, project, or tenant
`documentLimit`	top-level	No	Maximum notes to sync per connection (default: 10,000)

In the Python SDK, use container_tags and document_limit for top-level options, but keep the Granola metadata key in camelCase: apiKey.

What Gets Synced

Granola notes are synced as markdown documents. Each document can include:

Note title
Meeting time, attendees, and meeting URL when Granola returns them
AI-generated summary when present
Full transcript when present

Document Metadata

Each synced note includes searchable metadata:

Field	Description
`type`	Always `granola`
`title`	Granola note title
`createdAt`	Granola note creation timestamp
`updatedAt`	Granola note update timestamp
`url`	Granola note URL, when available
`attendees`	Attendee names or emails, when available
`meetingStart`	Calendar event start time, when available

You can filter searches using these metadata fields:

const results = await client.search({
  q: "customer onboarding discussion",
  containerTag: 'org-123',
  searchMode: "documents",
  filters: JSON.stringify({
    AND: [
      { key: "type", value: "granola", negate: false },
      { key: "attendees", value: "alex@company.com", negate: false }
    ]
  })
});

Connection Management

Delete Connection

TypeScript
Python
cURL

await client.connections.deleteByID('conn_granola_abc123');

client.connections.delete_by_id('conn_granola_abc123')

curl -X DELETE "https://api.supermemory.ai/v3/connections/conn_granola_abc123" \
  -H "Authorization: Bearer $SUPERMEMORY_API_KEY"

By default, deleting a connection removes all synced documents from Supermemory. To keep documents, pass deleteDocuments=false as a query parameter: DELETE /v3/connections/:id?deleteDocuments=false

Manual Sync

TypeScript
Python
cURL

await client.connections.import('granola', {
  containerTags: ['org-123']
});

client.connections.import_(
    'granola',
    container_tags=['org-123']
)

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

Sync Behavior

Feature	Behavior
Initial sync	Fetches Granola notes up to `documentLimit`
Incremental sync	Uses Granola `updated_at` timestamps to fetch notes changed since the previous sync
Transcript handling	Fetches each note with transcript content included
Sync schedule	Initial sync after connection creation + manual triggers
Document limit	10,000 notes per connection (default)

Troubleshooting

Error	Solution
`Granola API key is required`	Include a non-empty `metadata.apiKey` value when creating the connection
`Granola API key is invalid`	Create a new key in Granola and reconnect
`Could not reach Granola API`	Retry after checking Granola API availability and network access
Missing notes	Check `documentLimit`; if the workspace has more notes than the limit, only notes up to the limit are imported

Getting Started

Concepts

Using supermemory

Deployment

Other resources

Migration Guides

Quick Setup

From the Console

With the API

Configuration Options

What Gets Synced

Document Metadata

Connection Management

Delete Connection

Manual Sync

Sync Behavior

Troubleshooting

​Quick Setup

​From the Console

​With the API

​Configuration Options

​What Gets Synced

​Document Metadata

​Connection Management

​Delete Connection

​Manual Sync

​Sync Behavior

​Troubleshooting

Quick Setup

From the Console

With the API

Configuration Options

What Gets Synced

Document Metadata

Connection Management

Delete Connection

Manual Sync

Sync Behavior

Troubleshooting