> ## Documentation Index
> Fetch the complete documentation index at: https://docs.granola.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Granola API

> Create API keys for programmatic access to meeting notes, transcripts, and AI summaries.

The Granola API lets you build custom integrations with programmatic access to meeting notes, transcripts, and AI summaries.

When you create an API key, you choose which note access scopes it should include.

## What can you build?

* **Custom AI agents** - Build agents that analyze sentiment across your calls, surface recurring themes in product feedback, or combine meeting context with other data sources for deeper insights.
* **Knowledge bases & wikis** - Feed meeting notes into Notion, Confluence, or a wiki so your team's knowledge is searchable and current.
* **Task & follow-up automation** - Extract action items from meeting notes and automatically create tasks in Linear, Jira, Todoist, or your project management tool of choice.
* **CRM sync and reporting** - Push meeting summaries and action items to CRM records, dashboards, or internal reporting workflows.

<Tip>
  If you just want to chat with your notes in Claude, ChatGPT or another LLM, you can also try the [Granola MCP](/help-center/sharing/integrations/mcp). MCP uses browser-based OAuth and is optimized for AI assistants.
</Tip>

## Who is it for?

Any workspace member on a **Business** or **Enterprise** plan can create API keys.

On Enterprise plans, workspace admins can control which note access scopes members can use in **Settings → Workspace → General → API access for members**.

## Access scopes

| Access scope       | What can it access                                                                                                      |
| ------------------ | ----------------------------------------------------------------------------------------------------------------------- |
| **Personal notes** | <ul><li>Notes you own</li><li>Notes directly shared with you</li><li>Notes in private folders shared with you</li></ul> |
| **Public notes**   | <ul><li>Notes visible to everyone in the workspace</li><li>Notes in the Team space</li></ul>                            |

Notes in Granola are private by default. For a note to appear through the public notes scope, it must be in a folder visible to everyone in your workspace, such as a folder in the Team space. Notes that remain in private folders are only available through personal notes access for users who can already access them.

## Getting started

1. Open the Granola desktop app
2. Go to **Settings → Connectors → API keys**
3. Click **Create new key**
4. Select the note access scopes the key should include
5. Click **Generate API Key**
6. Copy your API key for use in other apps

<Note>
  On Enterprise plans, an admin may need to enable API access scopes before members can create keys for those scopes.
</Note>

## Managing API access on Enterprise

Workspace admins on Enterprise plans can choose which scopes members can use:

1. Open **Settings → Workspace → General**
2. Find **API access for members**
3. Click **Manage**
4. Choose which note access scopes members can use

This lets Enterprise workspaces allow personal notes access, public notes access, both, or neither.

## Revoking a key

To revoke an API key:

1. Go to **Settings → Connectors → API keys**
2. Find the key you want to revoke and click **Revoke**
3. Confirm in the dialog

Once revoked, the key is permanently disabled and moves to the **Revoked** section of the table. This cannot be undone.

<Card title="API Documentation" icon="book" href="https://docs.granola.ai/introduction">
  Full API reference with endpoints, authentication, and examples.
</Card>

## FAQs

<AccordionGroup>
  <Accordion title="What plan do I need?">
    You need a Business or Enterprise plan to create API keys.
  </Accordion>

  <Accordion title="What's the difference between the Granola API and MCP?">
    The Granola API gives you an API key for scripts, automations, and custom integrations. MCP uses browser-based OAuth and is designed for conversational AI tools like Claude and ChatGPT.
  </Accordion>

  <Accordion title="Can I access private notes or private folders?">
    Only if the key includes personal notes access and the key owner can already access those notes in Granola. Public notes access only includes notes visible to everyone in the workspace.
  </Accordion>

  <Accordion title="Can I access team notes and my own notes with one key?">
    Yes. Select both **Personal notes** and **Public notes** when creating the key.
  </Accordion>

  <Accordion title="Why is the API returning no notes?">
    The API only returns notes that match the key's access scopes. For public notes access, make sure the notes are in a folder visible to everyone in the workspace, such as a folder in the Team space. For personal notes access, make sure the key owner can access those notes in Granola.
  </Accordion>

  <Accordion title="Is there a sandbox or test environment?">
    Not currently. We recommend testing with a small number of notes in a dedicated test folder.
  </Accordion>

  <Accordion title="Are there rate limits?">
    Yes. API keys are rate limited to 25 requests burst capacity with a sustained rate of 5 requests/second. Limits may apply per user or workspace depending on the key's access scope.
  </Accordion>

  <Accordion title="Are webhooks available?">
    Not yet. You need to poll the API for new notes. Webhooks are on our roadmap.
  </Accordion>
</AccordionGroup>