> ## Documentation Index
> Fetch the complete documentation index at: https://supermemory-capy-add-llmstxt-summary-and.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Granola connector

> Sync AI meeting notes and transcripts from Granola into your Supermemory knowledge base

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.

<Note>
  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**.
</Note>

## Quick setup

### From the console

1. Open the [Supermemory Console](https://console.supermemory.ai).
2. Go to **Connectors**.
3. Find the **Granola** row and click **Connect**.
4. Paste your Granola API key.
5. Optionally set a document limit and container tag.
6. Click **Connect**.

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

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

### With the API

<Tabs>
  <Tab title="TypeScript">
    ```typescript theme={"theme":{"light":"github-light-default","dark":"github-dark-default"}}
    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);
    ```
  </Tab>

  <Tab title="Python">
    ```python theme={"theme":{"light":"github-light-default","dark":"github-dark-default"}}
    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}')
    ```
  </Tab>

  <Tab title="cURL">
    ```bash theme={"theme":{"light":"github-light-default","dark":"github-dark-default"}}
    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
      }'
    ```
  </Tab>
</Tabs>

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) |

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

## 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:

```typescript theme={"theme":{"light":"github-light-default","dark":"github-dark-default"}}
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

<Tabs>
  <Tab title="TypeScript">
    ```typescript theme={"theme":{"light":"github-light-default","dark":"github-dark-default"}}
    await client.connections.deleteByID('conn_granola_abc123');
    ```
  </Tab>

  <Tab title="Python">
    ```python theme={"theme":{"light":"github-light-default","dark":"github-dark-default"}}
    client.connections.delete_by_id('conn_granola_abc123')
    ```
  </Tab>

  <Tab title="cURL">
    ```bash theme={"theme":{"light":"github-light-default","dark":"github-dark-default"}}
    curl -X DELETE "https://api.supermemory.ai/v3/connections/conn_granola_abc123" \
      -H "Authorization: Bearer $SUPERMEMORY_API_KEY"
    ```
  </Tab>
</Tabs>

<Warning>
  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`
</Warning>

### Manual sync

<Tabs>
  <Tab title="TypeScript">
    ```typescript theme={"theme":{"light":"github-light-default","dark":"github-dark-default"}}
    await client.connections.import('granola', {
      containerTags: ['org-123']
    });
    ```
  </Tab>

  <Tab title="Python">
    ```python theme={"theme":{"light":"github-light-default","dark":"github-dark-default"}}
    client.connections.import_(
        'granola',
        container_tags=['org-123']
    )
    ```
  </Tab>

  <Tab title="cURL">
    ```bash theme={"theme":{"light":"github-light-default","dark":"github-dark-default"}}
    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"]}'
    ```
  </Tab>
</Tabs>

## 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 |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.