mcp-granola

Un servidor MCP (Model Context Protocol) que otorga a los agentes de IA acceso a tus notas de reuniones de Granola. Busca notas, recupera el contenido completo con transcripciones y pagina a través de tu historial de reuniones.

Características

• Listar notas con filtrado por fecha y paginación basada en cursor

• Obtener el contenido completo de la nota incluyendo resúmenes de IA y transcripciones de reuniones

• Buscar notas por título o palabras clave del resumen

• Funciona con Claude Code, Gemini CLI y cualquier cliente compatible con MCP

• Cero dependencias externas más allá del SDK de MCP

Inicio rápido

1. Instalar

npm install @devli13/mcp-granola

O clona e instala localmente:

git clone https://github.com/devli13/mcp-granola.git
cd mcp-granola
npm install

2. Obtener una clave de API de Granola

1. Abre la aplicación de escritorio de Granola

2. Ve a Settings > API

3. Haz clic en Create new key

4. Copia la clave (comienza con grn_)

3. Configurar

Añádelo a tu .mcp.json (Claude Code) o .gemini/settings.json (Gemini CLI):

{
  "mcpServers": {
    "granola": {
      "command": "npx",
      "args": ["-y", "@devli13/mcp-granola"],
      "env": {
        "GRANOLA_API_KEY": "grn_your_api_key_here"
      }
    }
  }
}

O ejecútalo directamente:

GRANOLA_API_KEY=grn_your_key node server.js

Configuración

Herramientas

Ejemplo: listar notas recientes

{
  "name": "list_notes",
  "arguments": {
    "limit": 5,
    "created_after": "2025-01-01T00:00:00Z"
  }
}

Ejemplo: obtener una nota con transcripción

{
  "name": "get_note",
  "arguments": {
    "id": "not_abc123def456",
    "include_transcript": true
  }
}

Limitaciones

• La API de Granola está en fase beta: los endpoints y las formas de respuesta pueden cambiar.

• Las claves de API personales solo acceden a las notas que posees o que se comparten contigo directamente.

• search_notes realiza una coincidencia de subcadenas del lado del cliente sobre las 200 notas más recientes. No es un motor de búsqueda de texto completo. Para grandes volúmenes de notas, utiliza list_notes con filtros de fecha en su lugar.

• La API solo devuelve notas con resúmenes y transcripciones generados por IA. Las notas que aún se están procesando no aparecerán.

Límites de tasa

Granola aplica límites de tasa por espacio de trabajo:

Contribución

¡Los problemas y las solicitudes de extracción son bienvenidos! Por favor, abre un problema primero para discutir cualquier cambio significativo.

Licencia

MIT