Granola MCP

oficial

Conecta Claude, ChatGPT y otras herramientas de IA a tus notas de reuniones de Granola a través de MCP. Consulta tus notas, busca transcripciones y obtén información de reuniones en tus asistentes de IA favoritos.

Ver en granola.ai

¿Qué puedes hacer con Granola MCP?

Buscar notas de reuniones — Pídele a tu IA que encuentre temas o discusiones específicos de reuniones pasadas usando query_granola_meetings.
Listar reuniones y carpetas — Pregunta con quién tuviste reuniones o a qué carpetas puedes acceder mediante list_meetings y list_meeting_folders.
Extraer elementos de acción y decisiones — Solicita los elementos de acción pendientes por persona o las decisiones clave de las notas de una reunión usando get_meetings.
Revisar pantallas compartidas — Pregunta qué había en una diapositiva o gráfico mostrado durante una reunión con get_meeting_attachment.
Obtener citas exactas de la transcripción — Pide citas específicas de la transcripción cruda de una reunión usando get_meeting_transcript.
Gestionar cuenta y espacio de trabajo — Pregunta qué cuenta de Granola está conectada o cambia de espacio de trabajo mediante get_account_info y switch_workspace.

Servidor MCP alojado

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

Se instala en Claude Code, Codex, Cursor y más

Documentación

Índice de documentación

Obtén el índice completo de documentación en: https://docs.granola.ai/llms.txt Usa este archivo para descubrir todas las páginas disponibles antes de explorar más a fondo.

Granola MCP

Conecta Claude, ChatGPT y otras herramientas de IA a tus notas de reuniones de Granola mediante MCP. Consulta tus notas, busca en transcripciones y obtén información de tus reuniones en tus asistentes de IA favoritos.

Conecta tus herramientas de IA a tus notas de reuniones de Granola con Granola MCP. Una vez conectado, puedes usarlo para: buscar en tus notas de reuniones, encontrar temas específicos discutidos en reuniones pasadas, explorar carpetas de reuniones, extraer elementos de acción o decisiones de tus notas, responder preguntas basadas en tu historial de reuniones y más.

Granola admite OAuth basado en navegador y Autorización Gestionada por la Empresa (EMA) para proveedores de identidad y clientes MCP compatibles.

Qué puede acceder MCP

Granola MCP se conecta como un usuario individual mediante OAuth de navegador. Con EMA, el proveedor de identidad de la organización gestiona el acceso en su lugar. Ambos métodos devuelven notas a las que el usuario puede acceder y que pertenecen al espacio de trabajo activo de Granola del usuario, sujeto a los alcances de acceso a continuación.

Las notas de otros espacios de trabajo de Granola no se incluyen, incluso si son visibles en el espacio de trabajo activo mediante uso compartido.

Alcance de acceso	¿A qué puede acceder?
Notas personales	Notas que posees en el espacio de trabajo activo Notas en el espacio de trabajo activo compartidas directamente contigo Notas en carpetas privadas del espacio de trabajo activo compartidas contigo
Notas públicas	Notas visibles para todos en el espacio de trabajo activo Notas en el espacio de equipo del espacio de trabajo activo

Tu plan y la configuración del espacio de trabajo determinan qué alcances usa MCP:

Plan	Acceso MCP
Básico (Gratuito)	Notas personales de los últimos 30 días. Algunas herramientas de carpetas, búsqueda y transcripciones solo están disponibles en planes de pago.
Business	Notas personales y notas públicas.
Enterprise	Los administradores del espacio de trabajo pueden configurar qué alcances están disponibles para los miembros. Si ningún alcance está habilitado, los miembros no pueden usar Granola MCP.

MCP sigue el espacio de trabajo activo seleccionado en la aplicación Granola. Si perteneces a más de un espacio de trabajo, cambia de espacio de trabajo en Granola antes de hacer otra pregunta a tu herramienta de IA. MCP no combina notas de múltiples espacios de trabajo.

Guía de configuración

Requisitos previos

Una cuenta de Granola con notas de reuniones existentes
Herramienta de IA que admita MCP, como Claude y ChatGPT

Cómo conectarse

1. Abre e inicia sesión en Claude

2. Ve a Configuración

3. Ve a Conectores, busca Granola

4. Conéctate, autentícate y asegúrate de estar activado al
   chatear

1. Abre e inicia sesión en ChatGPT 2. Ve a Configuración 3. Busca 'Granola' y conéctate 4. Ahora puedes usar @Granola o simplemente pedir que se haga referencia a tus reuniones en ChatGPT 1. Ejecuta `claude` en tu terminal 2. Ejecuta este comando:

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

3. Abre una nueva pestaña de terminal y ejecuta `claude` nuevamente
4. Ejecuta `/mcp`, selecciona el MCP de granola y elige 'Autenticar'
5. Pide a Claude que haga referencia a tus reuniones

Puedes conectarte manualmente al MCP de Granola usando la URL pública{" "} [https://mcp.granola.ai/mcp](https://mcp.granola.ai/mcp) como conexión personalizada.

Tu herramienta de IA debe admitir:

* **Protocolo de cliente MCP** usando [transporte HTTP Streamable](https://modelcontextprotocol.io/specification/2025-03-26/basic/transports#streamable-http)
* **Autenticación OAuth 2.0 y descubrimiento de metadatos** — para una conexión estándar, tu herramienta debe poder abrir una ventana del navegador para que el usuario inicie sesión en Granola. Después de iniciar sesión, la herramienta recibe un token de portador para incluir en solicitudes posteriores.

Los clientes empresariales pueden usar [Autorización Gestionada por la Empresa](#enterprise-managed-authorization) en lugar del flujo de inicio de sesión estándar de Granola. Cada conexión sigue actuando en nombre de un usuario individual de Granola; no hay clave de API ni método de acceso de cuenta de servicio para MCP.

<Info>
  Si necesitas acceso con clave de API para scripts, automatizaciones o integraciones personalizadas, consulta nuestra [API de Granola](./granola-api) en su lugar.
</Info>

Autorización Gestionada por la Empresa

La Autorización Gestionada por la Empresa (EMA) permite que tu empresa controle el acceso a Granola MCP a través de su proveedor de identidad (IdP). Los usuarios inician sesión en su cliente MCP con su cuenta de empresa, y el IdP decide si pueden conectarse a Granola.

Tu IdP controla quién puede conectarse. La configuración del espacio de trabajo de Granola controla a qué notas pueden acceder.

Antes de comenzar

Necesitas:

Un espacio de trabajo Enterprise de Granola con SSO configurado
Un IdP y un cliente MCP que admitan EMA (Granola ha probado con Claude y Okta)
Acceso de administrador a tu espacio de trabajo de Granola y al IdP, o ayuda de los administradores correspondientes

Cada usuario ya debería tener una cuenta de Granola asociada con su identidad de empresa. Si no han usado SSO de empresa con Granola antes, pídeles que inicien sesión en Granola con SSO una vez antes de usar EMA.

Configurar EMA

En Granola, haz clic en el nombre de tu espacio de trabajo en la esquina inferior izquierda y luego selecciona Configuración. Ve a Configuración → Espacio de trabajo → General → Aplicaciones y conectores → Acceso MCP y habilita el acceso a notas que tu empresa quiera permitir.
En tu IdP, agrega o selecciona Granola y habilita su capacidad de autorización gestionada o servidor de recursos.
Crea una conexión de recurso gestionado desde tu cliente MCP a Granola.
Ingresa los valores a continuación. Tu IdP puede usar nombres de campo diferentes o inferir algunos valores automáticamente.

Campo	Valor
URL del recurso	`https://mcp.granola.ai/mcp`
URL del emisor	`https://mcp-auth.granola.ai`
Audiencia ID-JAG	`https://mcp-auth.granola.ai`
Alcance	`mcp`
ID de cliente en el recurso	La URL del Documento de Metadatos del ID de Cliente del cliente MCP

Asigna los usuarios o grupos apropiados tanto a Granola como al cliente MCP, y luego activa la conexión de recurso gestionado.

Con EMA, los usuarios asignados no completan un flujo de consentimiento OAuth separado de Granola. Su acceso sigue sujeto tanto a la política de tu IdP como al acceso MCP configurado en Granola.

Si tu empresa crea su propio cliente MCP

Granola admite clientes confidenciales que se autentican con private_key_jwt a través de un Documento de Metadatos del ID de Cliente (CIMD). Esto permite que tu cliente se autentique con su propio par de claves en lugar de un secreto de cliente emitido por Granola.

Tu cliente debe implementar la extensión EMA de MCP, obtener un ID-JAG del IdP de la empresa y publicar un documento de metadatos HTTPS público que declare private_key_jwt y un jwks_uri. Usa los metadatos OAuth de Granola para descubrir las capacidades y endpoints admitidos, y usa el emisor anunciado exactamente como la audiencia de la aserción del cliente.

Consulta la especificación EMA de MCP para conocer los requisitos completos del protocolo.

Ejemplo: Claude y Okta

Granola ha probado EMA con Claude y Okta Cross App Access (XAA):

En Okta, agrega la integración de Granola.
Abre la pestaña Servidor de recursos y habilita Cross App Access (XAA).
Sigue las instrucciones de Okta para configurar un conector de servidor de recursos entre Claude y Granola.
Usa https://claude.ai/oauth/mcp-oauth-client-metadata como ID de cliente en el recurso.

Herramientas y descripciones

Herramienta	Descripción	Ejemplos de prompts
`query_granola_meetings`	Chatea con Granola	Ver ejemplos completos de chat aquí
`list_meeting_folders`	Solo planes de pago — Lista las carpetas a las que puedes acceder, incluidos ID de carpeta, título, descripción y número de notas.	¿A qué carpetas de reuniones tengo acceso?
`list_meetings`	Lista las notas de reuniones a las que puedes acceder, incluidos ID de reunión, título, fecha y asistentes. Se puede filtrar por carpeta en planes de pago.	¿Qué reuniones tuve con Sam la semana pasada?
`get_meetings`	Lee las notas de reuniones a las que puedes acceder, incluidos ID de reunión, título, fecha, asistentes, notas privadas y notas resumidas.	¿Cuáles son los elementos de acción pendientes para cada persona en este proyecto?
`get_meeting_attachment`	Ve capturas de pantalla de pantallas compartidas durante una reunión, como diapositivas, gráficos o código.	¿Qué había en la diapositiva de precios en la revisión de hoy?
`get_meeting_transcript`	Solo planes de pago — Acércate a tus transcripciones, incluye: ID de reunión, transcripción sin procesar	Da citas específicas de cómo el equipo describió el problema
`get_account_info`	Devuelve el correo electrónico, el espacio de trabajo activo y los espacios de trabajo a los que te has unido para la cuenta de Granola actualmente conectada a esta sesión MCP — útil para confirmar que conectaste la cuenta de Granola correcta cuando tienes varias (por ejemplo, personal + trabajo)	¿Con qué cuenta de Granola he iniciado sesión?
`switch_workspace`	Solo disponible si perteneces a más de un espacio de trabajo — Cambia tu espacio de trabajo activo de Granola. Esto también lo cambia en la aplicación Granola y en cualquier otra herramienta de IA conectada a tu cuenta.	Cambia mi espacio de trabajo de Granola a Acme
`sign_out`	Cierra la sesión de esta herramienta de IA en tu cuenta de Granola. Para usar una cuenta diferente, vuelve a conectar Granola después.	Ciérrame la sesión de Granola

Guía de solución de problemas

Los límites de velocidad variarán según tu plan de suscripción de Granola y la herramienta MCP que estés usando. Los límites de velocidad actualmente promedian alrededor de 100 solicitudes por minuto en todas las herramientas. Los límites de velocidad están sujetos a cambios.

<Info>
  Si estás en el plan Básico (Gratuito), solo puedes consultar notas de los últimos 30
  días.
</Info>

Si recibes un mensaje de que tu agente LLM no puede acceder a tus notas de reuniones o usar las herramientas MCP de Granola, intenta reautenticarte. Si Granola está conectado en Claude pero muestra **No hay herramientas disponibles**, vuelve a conectar el conector de Granola en Claude para restablecer la conexión:

1. Ve a [Configuración del conector de Claude](https://claude.ai/customize/connectors) en la web. Debes hacerlo en claude.ai incluso si usas la aplicación de escritorio de Claude.
2. Selecciona **Granola**.
3. Haz clic en el menú de tres puntos en la esquina superior derecha.
4. Elige **Desconectar**.
5. Sin actualizar la página ni navegar a otro lugar, elige **Conectar** nuevamente
   y completa la autenticación.

<Info>
  Si estás en un plan de Claude Team o Enterprise, es posible que necesites que un
  administrador del espacio de trabajo desconecte y vuelva a conectar Granola por ti.
</Info>

Si ves este error después de completar el flujo de inicio de sesión OAuth, es posible que te hayas autenticado con una dirección de correo electrónico diferente a la que está registrada tu cuenta de Granola.

Para verificar qué correo electrónico usa tu cuenta de Granola, abre la aplicación Granola y ve a **Configuración** (<kbd>⌘</kbd> + <kbd>,</kbd> en macOS, <kbd>Ctrl</kbd> + <kbd>,</kbd> en Windows). El correo electrónico de tu cuenta se muestra debajo de tu foto de perfil en la esquina superior izquierda.

Al volver a conectar MCP, asegúrate de iniciar sesión con esa misma dirección de correo electrónico durante el flujo OAuth.

Si tu herramienta de IA dice que no puede encontrar ninguna nota, o no devuelve resultados cuando sabes que tienes reuniones, MCP puede estar conectado a la cuenta de Granola incorrecta o al espacio de trabajo incorrecto dentro de la cuenta correcta.

Pregunta a tu herramienta de IA: **"¿Con qué cuenta de Granola he iniciado sesión?"** Usará la herramienta `get_account_info` para devolver el correo electrónico y el espacio de trabajo activo actualmente conectados a MCP. Luego:

Correo correcto, espacio de trabajo incorrecto: cambia de espacio de trabajo en la aplicación de escritorio de Granola (haz clic en el nombre de tu espacio de trabajo en la esquina inferior izquierda y elige el correcto). MCP sigue tu espacio de trabajo activo, por lo que la siguiente consulta lo usará. También puedes pedirle a tu herramienta de IA que cambie de espacio de trabajo por ti, por ejemplo: "Cambia mi espacio de trabajo de Granola a [nombre del espacio de trabajo]."
- Correo completamente incorrecto: sigue los pasos del acordeón Iniciaste sesión en Claude con la cuenta incorrecta a continuación (o el equivalente para tu herramienta de IA) para desconectarte y volver a conectarte con la cuenta correcta.
Así es como se reconecta Claude MCP con una cuenta de Granola diferente:
1. Pídele a Claude que cierre sesión en Granola.
2. Haz clic en el enlace mcp-auth.granola.ai/api/logout que te proporcione.
3. Pídele a Claude que se reconecte a Granola e inicia sesión con el correo de tu cuenta principal de Granola.
La razón por la que una desconexión/reconexión normal no soluciona esto es que tu sesión existente de Granola permanece activa, por lo que se omite el paso de inicio de sesión. Cerrar sesión a través del enlace elimina esa sesión, lo que te permite elegir la cuenta correcta.

Preguntas frecuentes generales

No, puedes usar cuentas diferentes para tu herramienta de IA y Granola. Autenticarás la cuenta de Granola a la que deseas que tu herramienta de IA tenga acceso. Para verificar qué correo usa tu cuenta de Granola, abre la aplicación de Granola y ve a **Configuración** (⌘ + , en macOS, Ctrl + , en Windows) — el correo de tu cuenta se muestra debajo de tu foto de perfil en la esquina superior izquierda. Primero, verifica qué alcances de acceso se aplican a ti:

* **Básico (Gratis):** Notas personales de los últimos 30 días.
* **Business:** Notas personales y notas públicas.
* **Enterprise:** Los administradores del espacio de trabajo configuran qué alcances están disponibles para los miembros.

El acceso a notas personales no incluye todas las notas privadas del espacio de trabajo. La nota debe ser tuya, compartida directamente contigo o estar en una carpeta privada compartida contigo. El acceso a notas públicas incluye notas visibles para todos en el espacio de trabajo, incluidas las notas en el espacio de Team.

MCP también solo devuelve notas que pertenecen al espacio de trabajo activo. Si una nota se creó en otro espacio de trabajo de Granola, MCP no la devolverá desde tu espacio de trabajo actual, incluso si puedes verla en Granola.

También confirma que MCP esté conectado a la cuenta y al espacio de trabajo activo correctos preguntándole a tu herramienta de IA: **"¿Con qué cuenta de Granola estoy conectado?"**

Esto debería suceder de inmediato, y tendrás acceso a herramientas adicionales y límites de velocidad mejorados en tu próxima consulta. Para una conexión OAuth estándar del navegador, no. Granola MCP utiliza Dynamic Client Registration (DCR), lo que significa que las credenciales se manejan automáticamente. No necesitas generar ni ingresar ningún ID de cliente o secreto de cliente.

Si estás usando una plataforma de terceros (como Composio) que muestra campos de ID de cliente y secreto de cliente, déjalos en blanco — la plataforma se registrará con Granola automáticamente cuando te conectes.

La configuración de EMA es diferente. Tu proveedor de identidad puede solicitar un **ID de cliente en el recurso** al crear la conexión administrada. Ingresa la URL del documento de metadatos del ID de cliente del cliente MCP. Si estás usando un cliente MCP existente como Claude, usa la URL proporcionada por ese cliente; no necesitas crear uno tú mismo ni ingresar un secreto de cliente.

Si estás creando tu propio cliente MCP confidencial, creas y alojas su documento de metadatos del ID de cliente. La URL del documento es el ID de cliente, y el cliente se autentica con su clave privada en lugar de un secreto de cliente emitido por Granola. Consulta [Si tu empresa crea su propio cliente MCP](#if-your-company-builds-its-own-mcp-client).

Sí — cualquier herramienta que implemente la [especificación del cliente MCP](https://modelcontextprotocol.io/) con transporte HTTP Streamable puede conectarse a Granola MCP. Tu herramienta puede usar OAuth del navegador, o EMA si admite la extensión y tu organización ha configurado un IdP compatible. Consulta las secciones "Otras herramientas de IA" y [Autorización administrada por la empresa](#enterprise-managed-authorization) arriba.

Si estás creando una integración personalizada y necesitas ayuda, comunícate con [hey@granola.so](mailto:hey@granola.so).

Preguntas frecuentes de Enterprise

Sí. Los administradores de Enterprise pueden configurar el acceso a notas disponible para los miembros del espacio de trabajo:

1. Ve a **Configuración → Espacio de trabajo → General**.
2. Encuentra **Acceso MCP** bajo **Aplicaciones y conectores**.
3. Haz clic en **Administrar**.
4. Habilita **Notas personales**, **Notas públicas**, ambas o ninguna.

Para evitar que las herramientas de IA lean transcripciones de reuniones, desactiva **Transcripciones de reuniones** en el mismo diálogo. Se aplica a cada reunión en tu espacio de trabajo, para todos los que pueden acceder a ella, incluidos administradores y personas con quienes se comparte una nota. Las notas y los resúmenes permanecen disponibles. Está activado por defecto.

El acceso depende de la configuración actual de MCP del espacio de trabajo. Si ningún alcance está habilitado, los miembros no tienen acceso a MCP hasta que un administrador habilite notas personales, notas públicas o ambas. Los controles están bajo **Configuración → Espacio de trabajo → General → Aplicaciones y conectores → Acceso MCP**. Todos los miembros del espacio de trabajo Enterprise pueden ver la configuración, pero solo los administradores pueden cambiarla. Si necesitas que se habilite otro alcance, pídele a tu administrador del espacio de trabajo. Los controles de acceso a notas no. Determinan a qué pueden acceder los miembros no administradores del espacio de trabajo a través de MCP. Los administradores de Enterprise pueden acceder tanto a notas personales como a notas públicas a través de MCP.

El interruptor de **Transcripciones de reuniones** se aplica a todos, incluidos los administradores.

Esta documentación está construida y alojada en Mintlify, una plataforma de documentación para desarrolladores.