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.ai

O que você pode fazer com Granola MCP?

Pesquise seu histórico de reuniões — Faça perguntas sobre reuniões passadas e obtenha respostas usando query_granola_meetings.
Navegue pelas pastas de reuniões — Liste as pastas que você pode acessar, incluindo títulos e contagens de notas, com list_meeting_folders (planos pagos).
Liste e filtre reuniões — Recupere reuniões por data, título ou participantes, opcionalmente filtradas por pasta em planos pagos via list_meetings.
Leia as notas completas da reunião — Acesse notas privadas, resumos, participantes e itens de ação de reuniões específicas usando get_meetings.
Pesquise transcrições brutas — Extraia citações exatas e a transcrição completa de uma reunião com get_meeting_transcript (planos pagos).
Confirme a conta conectada — Verifique qual e-mail e workspace do Granola estão ativos na sessão atual via get_account_info.

Documentação

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 em 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 de suas notas, responder perguntas com base no seu histórico de reuniões e muito mais.

Atualmente, oferecemos suporte apenas à autenticação via OAuth no navegador. Para outras formas de autenticação, envie seu feedback para hey@granola.so.

O que o MCP pode acessar

O Granola MCP conecta-se como um usuário individual através de OAuth no navegador. Ele retorna notas do workspace ativo do Granola do usuário, sujeito aos escopos de acesso abaixo.

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

Seu plano e 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	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.

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, procure por Granola

4. Conecte, autentique e certifique-se de estar ativado ao
   conversar

1. Abra e faça login no ChatGPT 2. Vá para Configurações 3. Procure 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-se 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 cliente MCP** usando [transporte HTTP Streamable](https://modelcontextprotocol.io/specification/2025-03-26/basic/transports#streamable-http)
* **Autenticação OAuth 2.0** — o servidor usa OAuth baseado em navegador, então sua ferramenta precisa ser capaz de abrir uma janela do navegador para o usuário fazer login no Granola. Após o login, a ferramenta recebe um token de portador para incluir nas requisições subsequentes.

Cada usuário autentica-se individualmente através do fluxo OAuth no navegador. Não há chave de API ou método de acesso de conta de serviço para MCP.

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

Ferramentas e descrições

Ferramenta	Descrição	Exemplos de prompts
`query_granola_meetings`	Conversar com o Granola	Veja exemplos completos de chat aqui
`list_meeting_folders`	Apenas planos pagos — Lista as pastas que você pode acessar, incluindo ID da pasta, título, descrição e contagem de notas.	A quais pastas de reunião eu tenho acesso?
`list_meetings`	Lista 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 eu tive com Sam na semana passada?
`get_meetings`	Lê 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_transcript`	Apenas planos pagos — Aprofunde-se em 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 e o workspace ativo da conta Granola atualmente conectada a esta sessão MCP — útil para confirmar se 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 dependendo do seu plano de assinatura do Granola e da ferramenta MCP que você está usando. Atualmente, os limites de taxa giram em torno de 100 requisições por minuto em todas as ferramentas. Os limites de taxa estão sujeitos a alterações.

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

Se você está recebendo uma mensagem de que seu agente 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 as [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 outro lugar, escolha **Conectar** novamente
   e complete 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 para você.
</Info>

Se você vir este erro após completar o fluxo de login OAuth, 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 é mostrado sob sua foto de perfil no canto superior esquerdo.

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

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

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 conectado 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 completamente 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 de navegação anônima/privada e faça login 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ê faça login novamente, então use o e-mail da sua conta principal do Granola.
4. Uma vez conectado, volte para o seu navegador normal e deve estar funcionando com a conta certa.

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

Perguntas frequentes gerais

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 é mostrado sob sua foto de perfil no canto superior esquerdo. Primeiro, verifique quais escopos de acesso se aplicam a você:

* **Básico (Grátis):** 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 no workspace. A nota deve ser sua, compartilhada diretamente com você ou estar 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.
Confirme também que o MCP está conectado à conta correta e ao espaço de trabalho ativo 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 aprimorados na sua próxima consulta. Não. O Granola MCP usa OAuth baseado em navegador com 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 o Composio) que exibe campos de ID de cliente e segredo de cliente, deixe-os em branco — a plataforma se registrará no Granola automaticamente quando você se conectar.

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 precisará lidar com o fluxo de autenticação do navegador OAuth 2.0 para que cada usuário possa fazer login em sua conta do Granola. Consulte a seção "Outras ferramentas de IA" acima para detalhes técnicos.

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

Perguntas Frequentes Empresariais

Sim. Os administradores empresariais podem configurar o acesso às notas disponível para os membros do espaço de trabalho:

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

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