Granola MCP

oficial

Conecte Claude, ChatGPT e outras ferramentas de IA às suas notas de reunião do Granola via MCP. Consulte suas notas, pesquise transcrições e obtenha insights de reuniões em seus assistentes de IA favoritos.

Ver em granola.aiExperimente este MCPPatrocinado

O que você pode fazer com Granola MCP?

Pesquisar notas de reunião — Peça ao seu assistente para encontrar tópicos, decisões ou discussões específicas de reuniões passadas usando query_granola_meetings.
Listar pastas de reuniões — Use list_meeting_folders para navegar pelas pastas acessíveis, incluindo títulos, descrições e contagens de notas (somente planos pagos).
Recuperar detalhes da reunião — Consulte notas, participantes, datas e conteúdo resumido de reuniões específicas com get_meetings.
Extrair itens de ação — Peça os itens de ação pendentes ou decisões por pessoa das reuniões de um projeto via get_meetings.
Acessar transcrições — Obtenha transcrições brutas com get_meeting_transcript para extrair citações exatas ou esclarecer discussões (somente planos pagos).
Verificar conexão da conta — Confirme qual conta e workspace Granola está ativo usando get_account_info.

Documentação

Granola MCP

Conecte o Claude, o ChatGPT e outras ferramentas de IA às suas notas de reunião do Granola via MCP. Consulte suas notas, pesquise transcrições e obtenha insights de reuniões em seus assistentes de IA favoritos.

Conecte suas ferramentas de IA às suas notas de reunião do Granola com o Granola MCP. Depois de conectado, você pode usar isso para: pesquisar suas notas de reunião, encontrar tópicos específicos discutidos em reuniões passadas, navegar por pastas de reuniões, extrair itens de ação ou decisões das suas notas, responder perguntas com base no seu histórico de reuniões e muito mais.

O Granola oferece suporte a OAuth baseado em navegador e Autorização Gerenciada pela Empresa (EMA) para provedores de identidade e clientes MCP compatíveis.

O que o MCP pode acessar

O Granola MCP conecta-se como um usuário individual por meio de OAuth no navegador. Com EMA, o provedor de identidade da organização gerencia o acesso. Ambos os métodos retornam notas que o usuário pode acessar e que pertencem ao workspace ativo do Granola do usuário, sujeitas aos escopos de acesso abaixo.

Notas de outros workspaces do Granola não são incluídas, mesmo que estejam visíveis no workspace ativo por meio de compartilhamento.

Escopo de acesso	O que pode acessar
Notas pessoais	Notas que você possui no workspace ativo Notas no workspace ativo compartilhadas diretamente com você Notas em pastas privadas no workspace ativo compartilhadas com você
Notas públicas	Notas visíveis para todos no workspace ativo Notas no espaço da equipe do workspace ativo

Seu plano e as configurações do workspace determinam quais escopos o MCP usa:

Plano	Acesso MCP
Básico (Grátis)	Notas pessoais dos últimos 30 dias. Algumas ferramentas de pasta, pesquisa e transcrição estão disponíveis apenas em planos pagos.
Business	Notas pessoais e notas públicas.
Enterprise	Os administradores do workspace podem configurar quais escopos estão disponíveis para os membros. Se nenhum escopo estiver habilitado, os membros não podem usar o Granola MCP.

Informação

O MCP segue o workspace ativo selecionado no aplicativo Granola. Se você pertence a mais de um workspace, alterne os workspaces no Granola antes de fazer outra pergunta à sua ferramenta de IA. O MCP não combina notas de vários workspaces.

Guia de configuração

Pré-requisitos

Uma conta Granola com notas de reunião existentes
Ferramenta de IA compatível com MCP, como Claude e ChatGPT

Como conectar

1. Abra e entre no Claude

2. Vá para Configurações

3. Vá para Conectores, pesquise por Granola

4. Conecte, autentique e certifique-se de que está ativado ao
   conversar

1. Abra e entre no ChatGPT 2. Vá para Configurações 3. Pesquise por 'Granola' e conecte 4. Agora você pode @Granola ou simplesmente pedir para referenciar suas reuniões no ChatGPT 1. Execute `claude` no seu terminal 2. Execute este comando:

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

3. Abra uma nova aba do terminal e execute `claude` novamente
4. Execute `/mcp`, selecione o MCP do Granola e selecione 'Autenticar'
5. Peça ao Claude para referenciar suas reuniões

Você pode conectar manualmente ao Granola MCP usando a URL pública{" "} [https://mcp.granola.ai/mcp](https://mcp.granola.ai/mcp) como uma conexão personalizada.

Sua ferramenta de IA deve oferecer suporte a:

* **Protocolo de cliente MCP** usando [transporte Streamable HTTP](https://modelcontextprotocol.io/specification/2025-03-26/basic/transports#streamable-http)
* **Autenticação OAuth 2.0 e descoberta de metadados** — para uma conexão padrão, sua ferramenta deve ser capaz de abrir uma janela do navegador para o usuário entrar no Granola. Após o login, a ferramenta recebe um token de portador para incluir em solicitações subsequentes.

Clientes empresariais podem usar [Autorização Gerenciada pela Empresa](#enterprise-managed-authorization) em vez do fluxo de login padrão do Granola. Cada conexão ainda age em nome de um usuário individual do Granola; não há chave de API ou método de acesso por conta de serviço para MCP.

Informação

Se você precisar de acesso por chave de API para scripts, automações ou integrações personalizadas, consulte nossa API Granola.

Autorização Gerenciada pela Empresa

A Autorização Gerenciada pela Empresa (EMA) permite que sua empresa controle o acesso ao Granola MCP por meio do provedor de identidade (IdP). Os usuários entram no cliente MCP com a conta da empresa, e o IdP decide se eles podem se conectar ao Granola.

Seu IdP controla quem pode se conectar. As configurações do workspace do Granola controlam quais notas eles podem acessar.

Antes de começar

Você precisa de:

Um workspace Enterprise do Granola com SSO configurado
Um IdP e cliente MCP compatíveis com EMA (o Granola foi testado com Claude & Okta)
Acesso de administrador ao seu workspace do Granola e ao IdP, ou ajuda dos administradores relevantes

Cada usuário já deve ter uma conta Granola associada à identidade da empresa. Se eles nunca usaram o SSO da empresa com o Granola antes, peça para que entrem no Granola com SSO uma vez antes de usar EMA.

Configurar EMA

No Granola, vá para Configurações → Workspace → Geral → Apps e conectores → Acesso MCP para membros. Habilite o acesso às notas que sua empresa deseja permitir.
No seu IdP, adicione ou selecione o Granola e habilite a autorização gerenciada ou o recurso de servidor de recursos.
Crie uma conexão de recurso gerenciado do seu cliente MCP para o Granola.
Insira os valores abaixo. Seu IdP pode usar nomes de campos diferentes ou inferir alguns valores automaticamente.

Campo	Valor
URL do recurso	`https://mcp.granola.ai/mcp`
URL do emissor	`https://mcp-auth.granola.ai`
Público do ID-JAG	`https://mcp-auth.granola.ai`
Escopo	`mcp`
ID do cliente no recurso	URL do documento de metadados do ID do cliente do cliente MCP

Atribua os usuários ou grupos apropriados tanto ao Granola quanto ao cliente MCP e ative a conexão de recurso gerenciado.

Com EMA, os usuários atribuídos não concluem um fluxo de consentimento OAuth separado do Granola. O acesso deles permanece sujeito tanto à política do seu IdP quanto ao acesso MCP configurado no Granola.

Se sua empresa cria seu próprio cliente MCP

O Granola oferece suporte a clientes confidenciais que autenticam com private_key_jwt por meio de um Documento de Metadados do ID do Cliente (CIMD). Isso permite que seu cliente autentique com seu próprio par de chaves em vez de um segredo de cliente emitido pelo Granola.

Seu cliente deve implementar a extensão EMA do MCP, obter um ID-JAG do IdP da empresa e publicar um documento de metadados HTTPS público que declare private_key_jwt e um jwks_uri. Use os metadados OAuth do Granola para descobrir os recursos e endpoints compatíveis e use o emissor anunciado exatamente como o público da asserção do cliente.

Consulte a especificação EMA do MCP para os requisitos completos do protocolo.

Exemplo: Claude e Okta

O Granola foi testado com EMA usando Claude e Okta Cross App Access (XAA):

No Okta, adicione a integração do Granola.
Abra a aba Servidor de recursos e habilite Cross App Access (XAA).
Siga as instruções do Okta para configurar um conector de servidor de recursos entre Claude e Granola.
Use https://claude.ai/oauth/mcp-oauth-client-metadata como ID do cliente no recurso.

Ferramentas e descrições

Ferramenta	Descrição	Exemplos de prompts
`query_granola_meetings`	Converse com o Granola	Veja exemplos completos de conversas aqui
`list_meeting_folders`	Somente planos pagos — Liste as pastas às quais você tem acesso, incluindo ID da pasta, título, descrição e contagem de notas.	A quais pastas de reuniões tenho acesso?
`list_meetings`	Liste as notas de reunião às quais você tem acesso, incluindo ID da reunião, título, data e participantes. Pode ser filtrado por pasta em planos pagos.	Quais reuniões tive com o Sam na semana passada?
`get_meetings`	Leia as notas de reunião às quais você tem acesso, incluindo ID da reunião, título, data, participantes, notas privadas e notas resumidas.	Quais são os itens de ação restantes para cada pessoa neste projeto?
`get_meeting_transcript`	Somente planos pagos — Aprofunde-se nas suas transcrições, inclui: ID da reunião, transcrição bruta	Dê citações específicas de como o time descreveu o problema
`get_account_info`	Retorna o e-mail e o workspace ativo da conta Granola atualmente conectada a esta sessão MCP — útil para confirmar que você conectou a conta Granola correta quando tem várias (ex.: pessoal + trabalho)	Com qual conta Granola estou conectado?

Guia de solução de problemas

Os limites de taxa variam de acordo com seu plano de assinatura do Granola e a ferramenta MCP que você está usando. Os limites de taxa atualmente giram em torno de 100 solicitações por minuto em todas as ferramentas. Os limites de taxa estão sujeitos a alterações.

Informação

Se você está no plano Básico (Grátis), só pode consultar notas dos últimos 30 dias.

Se você está recebendo uma mensagem de que seu agente de LLM não consegue acessar suas notas de reunião ou usar as ferramentas do Granola MCP, tente reautenticar. Se o Granola estiver conectado no Claude, mas mostrar **Nenhuma ferramenta disponível**, reconecte o conector do Granola no Claude para redefinir a conexão:

1. Acesse [Configurações do conector do Claude](https://claude.ai/customize/connectors) na web. Você precisa fazer isso no claude.ai mesmo se usar o aplicativo de desktop do Claude.
2. Selecione **Granola**.
3. Clique no menu de três pontos no canto superior direito.
4. Escolha **Desconectar**.
5. Sem atualizar a página ou navegar para outro lugar, escolha **Conectar** novamente
   e conclua a autenticação.

Info

Se você estiver em um plano Claude Team ou Enterprise, talvez seja necessário que um administrador do workspace desconecte e reconecte o Granola para você.

Se você vir este erro após concluir o fluxo de login OAuth, você pode ter autenticado com um endereço de e-mail diferente daquele em que sua conta Granola está registrada.

Para verificar qual e-mail sua conta Granola usa, abra o aplicativo Granola e vá para **Configurações** (<kbd>⌘</kbd> + <kbd>,</kbd> no macOS, <kbd>Ctrl</kbd> + <kbd>,</kbd> no Windows). O e-mail da sua conta é exibido abaixo da sua foto de perfil no canto superior esquerdo.

Ao reconectar o MCP, certifique-se de entrar com o mesmo endereço de e-mail durante o fluxo OAuth.

Se sua ferramenta de IA disser que não consegue encontrar nenhuma nota, ou retornar nenhum resultado quando você sabe que tem reuniões, o MCP pode estar conectado à conta Granola errada ou ao workspace errado dentro da conta correta.

Pergunte à sua ferramenta de IA: **"Com qual conta Granola estou conectado?"** Ela usará a ferramenta `get_account_info` para retornar o e-mail e o workspace ativo atualmente conectados ao MCP. Então:

* **E-mail certo, workspace errado**: alterne o workspace no aplicativo de desktop do Granola (clique no nome do seu workspace no canto superior esquerdo e escolha o correto). O MCP segue seu workspace ativo, então a próxima consulta o usará.
* **E-mail totalmente errado**: siga os passos no acordeão **Conectado ao Claude com a conta errada** abaixo (ou o equivalente para sua ferramenta de IA) para desconectar e reconectar com a conta correta.

Veja como reconectar o Claude MCP com uma conta Granola diferente:

1. Abra uma janela anônima/navegação privada e entre no claude.ai.
2. Vá para **Configurações -> Conectores** e desconecte o Granola.
3. Ainda no modo anônimo, reconecte o Granola. Isso solicitará que você entre novamente, então use o e-mail da sua conta Granola principal.
4. Após conectar, volte ao seu navegador normal e ele deve estar funcionando com a conta correta.

O motivo pelo qual uma desconexão/reconexão normal não resolve isso é que sua sessão Granola existente permanece ativa, então ela pula a etapa de login. O modo anônimo força um novo login, o que permite que você escolha a conta correta.

FAQ Geral

Não, você pode usar contas diferentes para sua ferramenta de IA e o Granola. Você autenticará a conta Granola à qual deseja que sua ferramenta de IA tenha acesso. Para verificar qual e-mail sua conta Granola usa, abra o aplicativo Granola e vá para **Configurações** (⌘ + , no macOS, Ctrl + , no Windows) — o e-mail da sua conta é exibido abaixo da sua foto de perfil no canto superior esquerdo. Primeiro, verifique quais escopos de acesso se aplicam a você:

* **Básico (Gratuito):** Notas pessoais dos últimos 30 dias.
* **Business:** Notas pessoais e notas públicas.
* **Enterprise:** Administradores do workspace configuram quais escopos estão disponíveis para os membros.

O acesso a notas pessoais não inclui todas as notas privadas do workspace. A nota deve ser sua, compartilhada diretamente com você, ou em uma pasta privada compartilhada com você. O acesso a notas públicas inclui notas visíveis para todos no workspace, incluindo notas no espaço da equipe.

O MCP também retorna apenas notas que pertencem ao workspace ativo. Se uma nota foi criada em outro workspace do Granola, o MCP não a retornará do seu workspace atual, mesmo que você possa vê-la no Granola.

Confirme também se o MCP está conectado à conta e ao workspace ativo corretos perguntando à sua ferramenta de IA: **"Com qual conta Granola estou conectado?"**

Isso deve acontecer imediatamente, e você terá acesso a ferramentas extras e limites de taxa atualizados na sua próxima consulta. Para uma conexão OAuth padrão via navegador, não. O Granola MCP usa Dynamic Client Registration (DCR), o que significa que as credenciais são tratadas automaticamente. Você não precisa gerar ou inserir nenhum client ID ou client secret.

Se você estiver usando uma plataforma de terceiros (como Composio) que mostra campos de client ID e client secret, deixe-os em branco — a plataforma registrará com o Granola automaticamente quando você conectar.

A configuração EMA é diferente. Seu provedor de identidade pode solicitar um **Client ID at resource** ao criar a conexão gerenciada. Insira a URL do Documento de Metadados do Client ID do cliente MCP. Se você estiver usando um cliente MCP existente, como o Claude, use a URL fornecida por esse cliente; você não precisa criar uma você mesmo ou inserir um client secret.

Se você estiver criando seu próprio cliente MCP confidencial, você cria e hospeda o Documento de Metadados do Client ID dele. A URL do documento é o client ID, e o cliente autentica com sua chave privada em vez de um client secret emitido pelo Granola. Consulte [Se sua empresa cria seu próprio cliente MCP](#if-your-company-builds-its-own-mcp-client).

Sim — qualquer ferramenta que implemente a [especificação do cliente MCP](https://modelcontextprotocol.io/) com transporte HTTP Streamable pode se conectar ao Granola MCP. Sua ferramenta pode usar OAuth via navegador, ou EMA se ela suportar a extensão e sua organização tiver configurado um IdP compatível. Consulte as seções "Outras ferramentas de IA" e [Autorização Gerenciada pela Empresa](#enterprise-managed-authorization) acima.

Se você estiver criando uma integração personalizada e precisar de ajuda, entre em contato com [hey@granola.so](mailto:hey@granola.so).

FAQ Enterprise

Sim. Administradores Enterprise podem configurar o acesso a notas disponível para os membros do workspace:

1. Vá para **Configurações → Workspace → Geral**.
2. Encontre **Acesso MCP para membros** em **Apps e conectores**.
3. Clique em **Gerenciar**.
4. Ative **Notas pessoais**, **Notas públicas**, ambas, ou nenhuma.

O acesso depende da configuração MCP atual do workspace. Se nenhum escopo estiver ativado, os membros não terão acesso MCP até que um administrador ative notas pessoais, notas públicas, ou ambas. Os controles estão em **Configurações → Workspace → Geral → Apps e conectores → Acesso MCP para membros**. Todos os membros do workspace Enterprise podem ver a configuração, mas apenas administradores podem alterá-la. Se você precisar de outro escopo ativado, peça ao administrador do seu workspace. Não. Os controles determinam o que membros não administradores do workspace podem acessar através do MCP. Administradores Enterprise podem acessar tanto notas pessoais quanto notas públicas através do MCP.