mcp-granola

Granola 회의 노트에 AI 에이전트가 액세스할 수 있도록 지원하는 MCP (Model Context Protocol) 서버입니다. 노트를 검색하고, AI 요약 및 녹취록을 포함한 전체 내용을 가져오며, 회의 기록을 페이지 단위로 탐색할 수 있습니다.

주요 기능

• 노트 목록 조회: 날짜 필터링 및 커서 기반 페이지네이션 지원

• 전체 노트 내용 가져오기: AI 요약 및 회의 녹취록 포함

• 노트 검색: 제목 또는 요약 키워드로 검색

• 호환성: 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. Granola API 키 발급

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
  }
}

제한 사항

• Granola API는 베타 버전입니다 — 엔드포인트 및 응답 형식이 변경될 수 있습니다.

• 개인 API 키는 본인 소유이거나 직접 공유받은 노트에만 액세스할 수 있습니다.

• **search_notes**는 가장 최근 노트 200개를 대상으로 클라이언트 측에서 부분 문자열 일치 검색을 수행합니다. 전체 텍스트 검색 엔진이 아닙니다. 노트 양이 많을 경우 날짜 필터를 사용하여 list_notes를 사용하세요.

• API는 AI 요약 및 녹취록이 생성된 노트만 반환합니다. 처리 중인 노트는 나타나지 않습니다.

속도 제한

Granola는 워크스페이스별로 속도 제한을 적용합니다:

기여

이슈 및 풀 리퀘스트는 언제나 환영합니다! 중요한 변경 사항을 논의하려면 먼저 이슈를 열어주세요.

라이선스

MIT