NotebookLM, 드디어 Claude Code에서 직접 쓴다

출처: GitHub{:rel="nofollow"} | 2026-04

오픈소스 커뮤니티에서 의미 있는 릴리즈가 나왔습니다. 그동안 분리되어 있던 NotebookLM-MCP와 NotebookLM-CLI 프로젝트가 단일 통합 패키지로 재출시되어, Google NotebookLM을 AI 코딩 도구에서 직접 조회할 수 있게 되었습니다.

!notebooklm-mcp-integration 본문 이미지 1

통합 패키지 구성

1월 대규모 리팩토링을 거쳐 현재 단일 설치만으로 두 가지 인터페이스를 동시 제공합니다.

Python 환경 기반이며, uv tool install notebooklm-mcp 또는 pipx install notebooklm-mcp 한 줄로 설치가 끝납니다.

Claude Code 연동 예시

Claude Code에 MCP 서버를 등록하는 절차는 다음과 같습니다.

# 1. 통합 패키지 설치
uv tool install notebooklm-mcp

2. 최초 Google 계정 인증
nlm auth login

3. Claude Code MCP 서버 등록
claude mcp add notebooklm -- notebooklm-mcp serve

등록 후 /mcp 명령으로 서버 상태를 확인할 수 있습니다. 이후 Claude Code 세션에서 "내 기술서적 노트북에서 RAG 아키텍처 부분 정리해줘" 같은 자연어 요청이 가능해집니다. NotebookLM이 인용과 함께 답변하고, 출처 문서 링크까지 반환합니다.

!notebooklm-mcp-integration 본문 이미지 2

GitHub 저장소 연동 워크플로우

가장 자주 쓰이는 패턴은 GitHub 저장소 → NotebookLM → Claude Code 3단 연결입니다.

• 1단계: Pyragify로 저장소를 텍스트 청크로 변환 → NotebookLM에 소스로 업로드
• 2단계: NotebookLM이 Gemini 기반으로 인덱싱·요약 수행
• 3단계: Claude Code가 MCP를 통해 해당 노트북을 쿼리, 출처 기반 답변 획득

공식 일원화된 GitHub 통합은 여전히 부재하지만, 이 3단 워크플로우로 사실상 동일한 효과를 냅니다. 대용량 레거시 코드베이스를 한 번 색인해 두면, 매번 Claude Code 세션에서 필요한 부분만 꺼내 쓰는 식으로 컨텍스트 창을 절약할 수 있습니다.

커뮤니티 반응

GitHub 이슈 트래커에서는 다음과 같은 활용 사례가 공유되고 있습니다.

• 기술 문서 아카이브: 수백 개 PDF를 NotebookLM에 업로드 → Claude Code로 설계 근거 조회
• 사내 지식베이스: Confluence 내보내기 파일을 소스로 등록 → 온보딩 자동화
• 연구 논문 DB: arXiv PDF 수집 → 비교 분석 요청

한국 커뮤니티에서도 한국어 문서 기반 질의가 원활하게 동작한다는 후기가 이어지고 있으며, 해당 프로젝트의 GitHub 저장소는 릴리즈 후 2주 만에 스타 1,200개를 돌파했습니다.

주의사항

• 비공식 프로젝트이므로 NotebookLM API 변경에 영향을 받을 수 있습니다
• Google 계정 인증 토큰을 로컬에 저장하므로 공용 장비 사용 시 주의
• 대용량 노트북 쿼리 시 응답 시간이 길어질 수 있어, 스트리밍 출력 옵션 활용 권장

정식 API가 공개되기 전까지 개인·팀 생산성 향상에 충분히 활용할 만한 도구라는 평가입니다.

---

오픈소스 생태계의 실용적인 소식을 계속 전하겠습니다. — 뉴스팀 최민재 기자