Granola MCP

npx add-mcp 'https://mcp.granola.ai/mcp'

Índice da Documentação

Obtenha o índice completo da documentação em: https://docs.granola.ai/llms.txt Use este arquivo para descobrir todas as páginas disponíveis antes de explorar mais.

Granola MCP

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.

Conecte suas ferramentas de IA às suas notas de reunião do Granola com o Granola MCP. Uma vez 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 suporta 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, sujeitos aos escopos de acesso abaixo.

Notas de outros workspaces do Granola não são incluídas, mesmo se estiverem 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
Basic (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	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.

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 que suporte MCP, como Claude e ChatGPT

Como conectar

1. Abra e faça login 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 faça login no ChatGPT 2. Vá para Configurações 3. Pesquise por 'Granola' e conecte 4. Agora você pode usar @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 granola MCP e escolha '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 suportar:

* **Protocolo de cliente MCP** usando [transporte HTTP Streamable](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 de conta de serviço para MCP.

<Info>
  Se você precisar de acesso por chave de API para scripts, automações ou integrações personalizadas, consulte nossa [API Granola](./granola-api).
</Info>

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 que suportem EMA (o Granola testou 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 SSO da empresa com o Granola antes, peça para entrarem no Granola com SSO uma vez antes de usar EMA.

Configurar EMA

1. No Granola, clique no nome do seu workspace no canto inferior esquerdo e selecione Configurações. Vá para Configurações → Workspace → Geral → Aplicativos e conectores → Acesso MCP e habilite o acesso às notas que sua empresa deseja permitir.
2. No seu IdP, adicione ou selecione o Granola e habilite sua capacidade de autorização gerenciada ou servidor de recursos.
3. Crie uma conexão de recurso gerenciado do seu cliente MCP para o Granola.
4. 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

5. 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 suporta 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 suportados e use o emissor exato anunciado como 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 testou EMA com Claude e Okta Cross App Access (XAA):

1. No Okta, adicione a integração Granola.
2. Abra a aba Servidor de recursos e habilite Cross App Access (XAA).
3. Siga as instruções do Okta para configurar um conector de servidor de recursos entre Claude e Granola.
4. 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	Apenas planos pagos — Liste as pastas que você pode acessar, incluindo ID da pasta, título, descrição e contagem de notas.	Quais pastas de reuniões tenho acesso?
list_meetings	Liste as notas de reunião que você pode acessar, incluindo ID da reunião, título, data e participantes. Pode ser filtrado por pasta em planos pagos.	Quais reuniões tive com Sam na semana passada?
get_meetings	Leia as notas de reunião que você pode acessar, 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_attachment	Veja capturas de tela de telas compartilhadas durante uma reunião, como slides, gráficos ou código.	O que estava no slide de preços na revisão de hoje?
get_meeting_transcript	Apenas planos pagos — Amplie suas transcrições, inclui: ID da reunião, transcrição bruta	Dê citações específicas de como a equipe descreveu o problema
get_account_info	Retorna o e-mail, workspace ativo e workspaces dos quais participa para a 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)	Em qual conta Granola estou conectado?
switch_workspace	Disponível apenas se você pertencer a mais de um workspace — Altere seu workspace ativo do Granola. Isso também o altera no aplicativo Granola e em qualquer outra ferramenta de IA conectada à sua conta.	Alterne meu workspace do Granola para Acme
sign_out	Desconecte esta ferramenta de IA da sua conta Granola. Para usar uma conta diferente, reconecte o Granola depois.	Desconecte-me do Granola

Guia de solução de problemas

Os limites de taxa variam dependendo do seu plano de assinatura do Granola e da 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.

<Info>
  Se você está no plano Basic (Grátis), só pode consultar notas dos últimos 30
  dias.
</Info>

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

1. Vá para [configurações do conector do Claude](https://claude.ai/customize/connectors) na web. Você deve 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 longe, escolha **Conectar** novamente
   e conclua a autenticação.

<Info>
  Se você está em um plano Claude Team ou Enterprise, pode precisar que um
  administrador do workspace desconecte e reconecte o Granola por você.
</Info>

Se você vir este erro após concluir o fluxo de login OAuth, pode ter autenticado com um endereço de e-mail diferente daquele sob o qual 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 é mostrado sob 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 diz que não consegue encontrar nenhuma nota, ou retorna 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: **"Em 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 inferior esquerdo e escolha o correto). O MCP segue seu workspace ativo, então a próxima consulta o usará. Você também pode pedir à sua ferramenta de IA para alternar os workspaces por você, por exemplo: "Alterne meu workspace do Granola para [nome do workspace]."

  • E-mail totalmente errado: siga as etapas 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 diferente do Granola:
  1. Peça ao Claude para sair do Granola.
  2. Clique no link mcp-auth.granola.ai/api/logout que ele fornecer.
  3. Peça ao Claude para reconectar ao Granola e entre com o e-mail da sua conta principal do Granola.

  O motivo pelo qual uma desconexão/reconexão normal não resolve isso é que sua sessão existente do Granola permanece ativa, então ela pula a etapa de login. Sair pelo link limpa essa sessão, o que permite que você escolha a conta correta.

FAQ Geral

Não, você pode usar contas diferentes para sua ferramenta de IA e para o Granola. Você autenticará a conta do Granola à qual deseja que sua ferramenta de IA tenha acesso. Para verificar qual e-mail sua conta do Granola usa, abra o aplicativo do Granola e vá para **Configurações** (⌘ + , no macOS, Ctrl + , no Windows) — o e-mail da sua conta é mostrado sob 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:** Os 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 no 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 que o MCP está conectado à conta e ao workspace ativo corretos, perguntando à sua ferramenta de IA: **"Com qual conta do 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 de navegador, não. O Granola MCP usa Registro Dinâmico de Cliente (DCR), o que significa que as credenciais são tratadas automaticamente. Você não precisa gerar ou inserir nenhum ID de cliente ou segredo de cliente.

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

A configuração de EMA é diferente. Seu provedor de identidade pode solicitar um **ID de cliente no recurso** ao criar a conexão gerenciada. Insira a URL do Documento de Metadados do ID de Cliente 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 segredo de cliente.

Se você estiver construindo seu próprio cliente MCP confidencial, você cria e hospeda o Documento de Metadados do ID de Cliente. A URL do documento é o ID do cliente, e o cliente autentica com sua chave privada em vez de um segredo de cliente emitido pelo Granola. Veja [Se sua empresa construir 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 de navegador, ou EMA se suportar a extensão e sua organização tiver configurado um IdP compatível. Veja as seções "Outras ferramentas de IA" e [Autorização Gerenciada pela Empresa](#enterprise-managed-authorization) acima.

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

FAQ Enterprise

Sim. Os 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** em **Apps e conectores**.
3. Clique em **Gerenciar**.
4. Ative **Notas pessoais**, **Notas públicas**, ambas ou nenhuma.

Para impedir que ferramentas de IA leiam transcrições de reuniões, desative **Transcrições de reuniões** na mesma caixa de diálogo. Isso se aplica a todas as reuniões no seu workspace, para todos que podem acessá-lo, incluindo administradores e pessoas com quem uma nota é compartilhada. Notas e resumos permanecem disponíveis. Está ativado por padrão.

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**. 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. Os controles de acesso a notas não. Eles determinam o que membros não administradores do workspace podem acessar por meio do MCP. Os administradores Enterprise podem acessar tanto notas pessoais quanto notas públicas por meio do MCP.

O interruptor **Transcrições de reuniões** se aplica a todos, incluindo administradores.

Esta documentação é construída e hospedada no Mintlify, uma plataforma de documentação para desenvolvedores.