Skip to main content
Our API is currently for Enterprise customers only. We’ll be announcing plans for other Granola users to use their notes in other tools very soon.

​
Overview

​
What is the Granola Enterprise API?

The Enterprise API allows organizations to programmatically access meeting notes and transcripts that have been shared within workspace-wide folders. It enables use cases like CRM sync, knowledge base population, and custom integrations.

​
What endpoints are available?

The API currently has two endpoints:
  • GET /v0/notes - List all accessible notes with pagination
  • GET /v0/notes/{note_id} - Get detailed information about a specific note, including transcript and summary
For full API Documentation, please go here: https://docs.granola.ai/introduction

​
What data can I access through the API?

For each note, you can retrieve:
  • Note title and creation date
  • Owner information (name, email)
  • Calendar event details (title, invitees, organizer, start/end times)
  • Attendees list
  • Folder membership
  • AI-generated summary
  • Full transcript (with speaker identification and timestamps)

​
Access & Permissions

​
Can I access private meetings through the Enterprise API?

No. The Enterprise API only provides access to public notes - meetings that have been explicitly shared in a workspace-wide folder. Private meetings remain private. This is by design. People use Granola for sensitive conversations (one-on-ones, personal appointments, confidential discussions), and we believe this data should remain under individual control. If users wish to access their own personal notes, they can use the personal MCP and connect it to popular tools like Claude and ChatGPT.

​
Why can’t admins access all notes?

We take a privacy-first stance. Many users have personal or sensitive meetings in Granola that they wouldn’t want shared company-wide. Giving admin access to all private notes would undermine the trust users place in Granola. Alternative options:
  • Encourage your organization to share more notes in team folders by default
  • Use the personal MCP (coming soon) for individual users to access their own notes
  • Consider implementing default folders to automatically categorize notes

​
What’s the difference between the Enterprise API and the personal MCP?

Feature

Enterprise API

Personal MCP

Scope

Organization-wide public notes

Individual user’s all notes

Auth

Single API key for workspace

Per-user OAuth

Access

Public folder notes only

Private

Use case

CRM sync, knowledge base

Personal AI assistants, Claude/ChatGPT

​
How do team folders work?

When you create a team folder, all members of your workspace can see notes in that folder. Notes shared to team folders become accessible via the Enterprise API. If a user moves a note into a team folder, it becomes public to the organization and accessible via the API.

​
Technical Questions

​
How does authentication work?

Use Bearer token authentication in your request headers: 
Authorization: Bearer <your-api-key>
API keys are provided during onboarding and should be stored securely.

​
Is the API paginated?

Yes. The /v0/notes endpoint returns a maximum of 50 notes per request. Use the cursor parameter from the response to fetch additional pages. 
{
  "notes": [...],
  "hasMore": true,
  "cursor": "eyJjcmVhdGVkX2F0Ijo..."
}

​
Can I filter notes by date?

Yes. Use these query parameters:
  • created_after - ISO 8601 date (e.g., 2024-01-01)
  • created_before - ISO 8601 date (e.g., 2024-12-31)

​
Can I filter notes by folder?

Not directly in v1. However, each note response includes folder_membership with folder IDs and names, so you can filter on your side after fetching.

​
How do I get transcripts?

Add ?include=transcript to the note detail endpoint: 
GET /v0/notes/{note_id}?include=transcript

​
Are there rate limits?

The API does not currently have strict rate limits, but please use responsibly. We may introduce limits in the future based on usage patterns.

​
What’s the API versioning strategy?

The current version is v0 (alpha). Breaking changes may occur. When we release a stable version, we’ll maintain backwards compatibility.

​
Use Cases

​
Can I sync Granola notes to Hubspot or Salesforce?

Yes - this is one of the most common use cases. You can build a custom integration that:
  1. Periodically polls for new notes
  2. Matches attendees by email domain to your CRM contacts/accounts
  3. Creates activities or updates records in CRM
We’re exploring native Salesforce integration for a future release.

​
Can I build custom AI agents with Granola data?

Yes. Common patterns include:
  • Customer intelligence: Analyze sentiment across customer call transcripts
  • Product research: Query themes across hundreds of customer conversations
  • Personal assistants: Combine meeting data with other knowledge sources
The personal MCP will make this even easier for individual users.

​
What about real-time webhooks?

Not available in v1. Currently, you need to poll the API for new notes. Webhooks are on our roadmap based on customer demand.

​
Getting Started

​
How do I get API access?

Contact your Granola account manager or email [email protected]. API access is included with Enterprise plans.

​
Is there a sandbox environment?

Not currently. We recommend testing with a small number of notes in a dedicated test folder.

​
Where can I get help?

​
Roadmap & Future

​
What’s coming next?

  • Personal MCP: OAuth-based access for individual users to all their notes
  • Webhook support: Real-time notifications when notes are created/updated
  • Native integrations: Salesforce, HubSpot, and other CRM platforms
  • Richer filtering: Filter by folder, attendee, or custom metadata

​
Will API access change pricing?

API access is included with Enterprise plans. We’ll provide notice if this changes.