mcp-granola

Сервер MCP (Model Context Protocol), который предоставляет ИИ-агентам доступ к вашим заметкам о встречах в Granola. Ищите заметки, получайте полное содержимое с расшифровками и просматривайте историю встреч с помощью пагинации.

Возможности

• Список заметок с фильтрацией по дате и пагинацией на основе курсора

• Получение полного содержимого заметки, включая ИИ-резюме и расшифровки встреч

• Поиск заметок по ключевым словам в заголовке или резюме

• Работает с Claude Code, Gemini CLI и любым MCP-совместимым клиентом

• Отсутствие внешних зависимостей, кроме MCP SDK

Быстрый старт

1. Установка

npm install @devli13/mcp-granola

Или клонируйте и установите локально:

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

2. Получение API-ключа Granola

1. Откройте настольное приложение Granola

2. Перейдите в Settings > API

3. Нажмите Create new key

4. Скопируйте ключ (начинается с grn_)

3. Настройка

Добавьте в ваш .mcp.json (для Claude Code) или .gemini/settings.json (для Gemini CLI):

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

Или запустите напрямую:

GRANOLA_API_KEY=grn_your_key node server.js

Конфигурация

Инструменты

Пример: список недавних заметок

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

Пример: получение заметки с расшифровкой

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

Ограничения

• API Granola находится в бета-версии — конечные точки и форматы ответов могут измениться.

• Персональные API-ключи предоставляют доступ только к заметкам, которыми вы владеете или которые были предоставлены вам напрямую.

• search_notes выполняет поиск подстроки на стороне клиента по 200 последним заметкам. Это не полнотекстовая поисковая система. Для больших объемов заметок используйте list_notes с фильтрами по дате.

• API возвращает только те заметки, для которых уже созданы ИИ-резюме и расшифровки. Заметки, которые все еще обрабатываются, не будут отображаться.

Ограничения частоты запросов (Rate Limits)

Granola устанавливает ограничения частоты запросов для каждого рабочего пространства:

Участие в разработке

Приветствуются сообщения об ошибках и пулл-реквесты! Пожалуйста, сначала откройте issue для обсуждения любых значительных изменений.

Лицензия

MIT