Skip to main content

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.

Connect your AI tools to your Granola meeting notes with Granola MCP. Once connected you can use this to: search through your meeting notes, find specific topics discussed in past meetings, browse meeting folders, extract action items or decisions from your notes, answer questions based on your meeting history and more. We currently only support authentication through browser OAuth. For other forms of authentication, please send feedback to hey@granola.so.
Granola MCP is currently generally available to test, but please note that availability and features may change in future.

​
Set-up guide

​
Pre-requisites

  • A Granola account with existing meeting notes
  • AI tool that supports MCP, such as Claude and ChatGPT
You will need a paid Claude or ChatGPT account. Refer below for specific tiers that support custom connectors.

​
How to connect

Claude is only available on Paid plans. If you are on a Team or Enterprise plan, you might need your admin to approve custom connectors or connect Granola for you.
  1. Open and sign in to Claude
  2. Go to Settings
  3. Go to Connectors, search for Granola
  4. Connect, authenticate and make sure you’re toggled on when chatting
ChatGPT Apps is only available on Plus, Pro, Business or Enterprise plans.
  1. Open and sign in to ChatGPT
  2. Go to Settings
  3. Search for ‘Granola’ and connect
  4. You can now @Granola or just ask to reference your meetings in ChatGPT
  1. Run claude in your terminal
  2. Run this command:
  claude mcp add granola --transport http https://mcp.granola.ai/mcp
  1. Open a new terminal tab and run claude again
  2. Run /mcp, select the granola MCP, and select ‘Authenticate’
  3. Ask Claude to reference your meetings
You can manually connect to the Granola MCP by using the public URL https://mcp.granola.ai/mcp as a custom connection.Your AI tool must support:
  • MCP client protocol using Streamable HTTP transport
  • OAuth 2.0 authentication — the server uses browser-based OAuth, so your tool needs to be able to open a browser window for the user to sign in to Granola. After sign-in, the tool receives a bearer token to include in subsequent requests.
Each user authenticates individually through the browser OAuth flow. There is no API key or service account access method for MCP.
If you need programmatic access without per-user browser authentication (e.g. a service account for workspace-wide access), see our Granola API instead.

​
Tools and descriptions

ToolDescriptionExample prompts
query_granola_meetingsChat with GranolaSee full chat examples here
list_meeting_foldersPaid plans only — List folders you’re a member of, including folder ID, title, description, and note countWhat meeting folders do I have access to?
list_meetingsScan through your list of meetings, includes: meeting ID, meeting title, meeting date, attendees. On paid plans, also includes notes shared with you, and can be filtered by folder.What meetings did I have with Sam last week?
get_meetingsSearch through your meeting content, including: meeting ID, meeting title, meeting date, attendees, private notes, enhanced notes. On paid plans, can also fetch notes shared with you when you have the meeting ID.What are the remaining action items for each person on this project?
get_meeting_transcriptPaid plans only — Zoom in to your transcripts, includes: meeting ID, raw transcriptGive specific quotes of how the team described the issue
get_account_infoReturns the email and active workspace for the Granola account currently connected to this MCP session — useful for confirming you connected the right Granola account when you have multiple (e.g. personal + work)Which Granola account am I signed in with?

​
Troubleshooting guide

​
Rate limits

Rate limits will vary depending on your Granola subscription plan and the MCP tool that you’re using. Rate limits currently average around 100 requests per minute across all tools. Rate limits are subject to change.
If you’re on the Basic (Free) plan, you can only query notes in the last 30 days.

​
MCP tools not working

If you’re getting a message that your LLM agent can’t access your meeting notes or use the Granola MCP tools, try re-authenticating.

​
Claude shows “No tools available”

If Granola is connected in Claude but shows No tools available, reconnect the Granola connector in Claude to reset the connection:
  1. Go to Claude connector settings on the web. You must do this on claude.ai even if you use the Claude desktop app.
  2. Select Granola.
  3. Click the three-dot menu in the top-right.
  4. Choose Disconnect.
  5. Without refreshing the page or navigating away, choose Connect again and complete authentication.
If you’re on a Claude Team or Enterprise plan, you may need a workspace admin to disconnect and reconnect Granola for you.

​
”Unauthorized: user has not created a Granola account yet”

If you see this error after completing the OAuth sign-in flow, you may have authenticated with a different email address than the one your Granola account is registered under. To check which email your Granola account uses, open the Granola app and go to Settings (⌘ + , on macOS, Ctrl + , on Windows). Your account email is shown under your profile picture in the top left. When reconnecting MCP, make sure you sign in with that same email address during the OAuth flow.

​
MCP can’t find any of my notes

If your AI tool says it can’t find any notes, or returns no results when you know you have meetings, MCP may be connected to the wrong Granola account or the wrong workspace within the right account. Ask your AI tool: “Which Granola account am I signed in with?” It will use the get_account_info tool to return the email and active workspace currently connected to MCP. Then:
  • Right email, wrong workspace: switch workspace in the Granola desktop app (click your workspace name in the top left and pick the right one). MCP follows your active workspace, so the next query will use it.
  • Wrong email entirely: follow the steps in Signed into Claude with the wrong account below (or the equivalent for your AI tool) to disconnect and reconnect with the correct account.

​
Signed into Claude with the wrong account

Here’s how to reconnect Claude MCP with a different Granola account:
  1. Open an incognito/private browsing window and sign in to claude.ai.
  2. Go to Settings -> Connectors and disconnect Granola.
  3. Still in incognito, reconnect Granola. This will prompt you to sign in again, so use your main Granola account email.
  4. Once connected, switch back to your normal browser and it should be working with the right account.
The reason a normal disconnect/reconnect doesn’t fix this is that your existing Granola session stays active, so it skips the login step. Incognito forces a fresh login, which lets you pick the right account.

​
General FAQ

​
Do I have to use the same email address for my AI tool and Granola?

No, you can use different accounts for your AI tool and Granola. You’ll authenticate the Granola account you want your AI tool to have access to. To verify which email your Granola account uses, open the Granola app and go to Settings (⌘ + , on macOS, Ctrl + , on Windows) — your account email is shown under your profile picture in the top left.

​
Why can’t I access a certain note?

What you can access via MCP depends on your plan:
  • Free plan: Your own notes from the last 30 days.
  • Paid plans: Your own notes, plus notes shared with you and notes in private folders you’re a member of.
MCP can only access folders in your “My notes” (private) space. Folders in the team space are never accessible via MCP, even if you created them and explicitly added all members. To make a team space folder accessible via MCP, move it from the team space into “My notes” using the folder’s sharing settings, then explicitly add each team member who needs access. Note that these folders will no longer be visible to the whole workspace by default.

​
I’ve just upgraded from Basic to Business/Enterprise, when will I get access to extra tools?

This should happen immediately, and you’ll have access to extra tools and upgraded rate limits on your next query.

​
Do I need a client ID or client secret?

No. Granola MCP uses browser-based OAuth with Dynamic Client Registration (DCR), which means credentials are handled automatically. You don’t need to generate or enter any client ID or client secret. If you’re using a third-party platform (like Composio) that shows client ID and client secret fields, leave them blank — the platform will register with Granola automatically when you connect.

​
Can I connect Granola MCP to my own internal AI tool?

Yes — any tool that implements the MCP client specification with Streamable HTTP transport can connect to Granola MCP. Your tool will need to handle the OAuth 2.0 browser authentication flow so that each user can sign in to their Granola account. See the “Other AI tools” section above for technical details. If you’re building a custom integration and need help, reach out to hey@granola.so.

​
Enterprise FAQ

​
Is MCP available for Granola Enterprise customers?

Yes, MCP is available for Enterprise customers. Admins can enable MCP for their workspace by going to Settings → Workspace > General and toggling MCP on. MCP toggle in workspace settings

​
Will this be turned on by default?

MCP is disabled by default for all workspace members. Admins can enable it in Settings → Workspace > General.

​
I can’t find the MCP toggle

The MCP toggle is located in Settings → Workspace > General and is only visible to workspace admins. If you are a non-admin member, you will see a “Workspace admin access required” message instead of the toggle. To check your role, go to Settings > Team — admins are labeled there. If you need MCP enabled, ask your workspace admin to turn it on or to promote you to admin.

​
Coming soon

We’re developing additional enterprise capabilities including advanced access controls, usage monitoring and analytics, higher rate limits, and flexible pricing options (more to come on this soon!)