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

> Connect Claude, ChatGPT, and other AI tools to your Granola meeting notes via MCP. Query your notes, search transcripts, and get meeting insights in your favorite AI assistants.

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](mailto:hey@granola.so).

<Info>
  Granola MCP is currently generally available to test, but please note that availability and features may change in future.
</Info>

# Set-up guide

## Pre-requisites

* A Granola account with existing meeting notes
* AI tool that supports MCP, such as Claude and ChatGPT

## How to connect

<AccordionGroup>
  <Accordion title="Claude">
    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
  </Accordion>

  <Accordion title="ChatGPT">
    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
  </Accordion>

  <Accordion title="Claude Code">
    1. Run `claude` in your terminal
    2. Run this command:

    ```bash theme={null}
      claude mcp add granola --transport http https://mcp.granola.ai/mcp
    ```

    3. Open a new terminal tab and run `claude` again
    4. Run `/mcp`, select the granola MCP, and select 'Authenticate'
    5. Ask Claude to reference your meetings
  </Accordion>

  <Accordion title="Other AI tools">
    You can manually connect to the Granola MCP by using the public URL{" "}
    <code>[https://mcp.granola.ai/mcp](https://mcp.granola.ai/mcp)</code> as a custom connection.

    Your AI tool must support:

    * **MCP client protocol** using [Streamable HTTP transport](https://modelcontextprotocol.io/specification/2025-03-26/basic/transports#streamable-http)
    * **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.

    <Info>
      If you need API key access for scripts, automations, or custom integrations, see our [Granola API](./granola-api) instead.
    </Info>
  </Accordion>
</AccordionGroup>

# Tools and descriptions

| Tool                     | Description                                                                                                                                                                                                          | Example prompts                                                                                                         |
| ------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------- |
| `query_granola_meetings` | [Chat with Granola](../../getting-more-from-your-notes/chatting-with-your-meetings)                                                                                                                                  | [See full chat examples here](../../getting-more-from-your-notes/chatting-with-your-meetings#common-use-cases-for-chat) |
| `list_meeting_folders`   | *Paid plans only* — List folders you're a member of, including folder ID, title, description, and note count                                                                                                         | What meeting folders do I have access to?                                                                               |
| `list_meetings`          | Scan 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_meetings`           | Search 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_transcript` | *Paid plans only* — Zoom in to your transcripts, includes: meeting ID, raw transcript                                                                                                                                | Give specific quotes of how the team described the issue                                                                |
| `get_account_info`       | Returns 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

<AccordionGroup>
  <Accordion title="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.

    <Info>
      If you're on the Basic (Free) plan, you can only query notes in the last 30
      days.
    </Info>
  </Accordion>

  <Accordion title="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.
  </Accordion>

  <Accordion title="Claude shows &#x22;No tools available&#x22;">
    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](https://claude.ai/customize/connectors) 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.

    <Info>
      If you're on a Claude Team or Enterprise plan, you may need a workspace
      admin to disconnect and reconnect Granola for you.
    </Info>
  </Accordion>

  <Accordion title="&#x22;Unauthorized: user has not created a Granola account yet&#x22;">
    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** (<kbd>⌘</kbd> + <kbd>,</kbd> on macOS, <kbd>Ctrl</kbd> + <kbd>,</kbd> 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.
  </Accordion>

  <Accordion title="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 the **Signed into Claude with the wrong account** accordion below (or the equivalent for your AI tool) to disconnect and reconnect with the correct account.
  </Accordion>

  <Accordion title="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.
  </Accordion>
</AccordionGroup>

# General FAQ

<AccordionGroup>
  <Accordion title="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** (<kbd>⌘</kbd> + <kbd>,</kbd> on macOS, <kbd>Ctrl</kbd> + <kbd>,</kbd> on Windows) — your account email is shown under your profile picture in the top left.
  </Accordion>

  <Accordion title="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.
  </Accordion>

  <Accordion title="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.
  </Accordion>

  <Accordion title="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.
  </Accordion>

  <Accordion title="Can I connect Granola MCP to my own internal AI tool?">
    Yes — any tool that implements the [MCP client specification](https://modelcontextprotocol.io/) 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](mailto:hey@granola.so).
  </Accordion>
</AccordionGroup>

# Enterprise FAQ

<AccordionGroup>
  <Accordion title="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.

    <img src="https://mintcdn.com/granola-c3940166/rTtxUdgB05Bp81mq/help-center/sharing/integrations/mcp-enterprise-toggle.png?fit=max&auto=format&n=rTtxUdgB05Bp81mq&q=85&s=4932feaa5122c0254d19ea94a224f35f" alt="MCP toggle in workspace settings" width="1200" height="217" data-path="help-center/sharing/integrations/mcp-enterprise-toggle.png" />
  </Accordion>

  <Accordion title="Will this be turned on by default?">
    MCP is disabled by default for all workspace members. Admins can enable it in **Settings → Workspace > General**.
  </Accordion>

  <Accordion title="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.
  </Accordion>

  <Accordion title="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!)
  </Accordion>
</AccordionGroup>
