jacob-bd/gemini-notebook-mcp-cli

Gemini Notebook (구 Google NotebookLM) CLI 및 MCP 서버

무엇인가요 – Google의 Gemini Notebook (이전에 Notebook LM으로 알려졌던 서비스)를 명령줄 또는 Model Context Protocol (MCP) 서버를 통해 제어할 수 있는 Python 패키지입니다. 이 MCP 서버는 Claude, Cursor, Gemini-CLI, GitHub Copilot 등 AI 어시스턴트 도구와 연결할 수 있어, 이러한 에이전트가 Gemini Notebook에 자동으로 콘텐츠를 읽고 쓰고 생성할 수 있습니다.

주요 기능

영역	CLI 명령어 (예시)	MCP 도구 이름
노트북 목록 보기	nlm notebook list	notebook_list
노트북 생성	nlm notebook create "Research Project"	notebook_create
소스 추가 (URL, 텍스트, Drive 파일, 업로드)	nlm source add <nb> --url "https://…"	source_add
노트북 쿼리 (웹 UI에 채팅 항목 추가)	nlm notebook query "Summarize key points"	notebook_query
채팅 세션 관리	nlm chats list / nlm chats get <id>	chat_list, chat_get
스타디오 콘텐츠 생성 (오디오, 비디오, 슬라이드, 인포그래픽 등)	nlm studio create <nb> audio	studio_create
슬라이드 데크 수정	nlm slides revise <nb>	studio_revise
아티팩트 다운로드	nlm download audio <nb> <artifact-id>	download_artifact
모든 아티팩트 일괄 다운로드	nlm download all <nb> -d ./exports	download_all_artifacts
Drive 기반 소스 동기화	nlm source sync	source_sync_drive
배치 작업, 노트북 간 쿼리, 파이프라인, 태그 등	nlm batch …, nlm cross query …, nlm pipeline run …, nlm tag add …	batch, cross_notebook_query, pipeline, tag
노트북 공유 (공개 링크 또는 초대)	nlm share public <nb>	notebook_share_*
AI 도구 설정 (Claude, Cursor, Gemini-CLI 등)	nlm setup add claude-code	–
어시스턴트가 MCP를 사용하는 방법을 가르치는 "스킬" 설치	nlm skill install cline	–
문제 진단	nlm doctor	–

사용 방법

1. 설치 – pip install notebooklm-mcp-cli (권장: uv tool install notebooklm-mcp-cli).
2. 인증 – nlm login을 실행하면 브라우저가 열리고 Google 쿠키를 추출하여 로컬에 저장합니다. 프로필 기능을 통해 별도의 Google 계정을 관리할 수 있습니다.
3. CLI 실행 – nlm …을 사용해 노트북 생성, 소스 추가, 콘텐츠 생성, 다운로드, 공유 등을 스크립트로 처리할 수 있습니다.
4. MCP 서버 노출 – notebooklm-mcp를 실행하면 AI 어시스턴트가 호출할 수 있는 로컬 HTTP 서버가 시작됩니다. nlm setup add <tool>을 사용하면 Claude Desktop, Cursor, GitHub Copilot 등의 도구용 적절한 JSON 설정 파일이 자동 생성되어, 43개의 내장 MCP 도구를 호출할 수 있게 됩니다.
5. 어시스턴트와 대화 – MCP가 등록되면, "양자 컴퓨팅에 대한 노트북을 만들고 팟캐스트를 생성해줘" 와 같은 간단한 명령어로 어시스턴트가 뒤에서 적절한 MCP 엔드포인트를 호출합니다.

설치 및 업그레이드

• 권장: uv tool install notebooklm-mcp-cli (일회성 실행은 uvx 사용).
• pip / pipx를 통해도 사용 가능.
• 업그레이드는 동일한 명령어로 수행 (uv tool upgrade … 또는 pip install --upgrade …).
• 기존 패키지 (notebooklm-cli, notebooklm-mcp-server)는 통합 패키지 설치 전에 제거해야 합니다.

안전 주의사항 – 이 도구는 비공식 Google API에 접속하며, 브라우저에서 쿠키를 내보내야 합니다. 이러한 API는 예고 없이 변경될 수 있으므로, 본 패키지는 개인적/실험적 용도로만 사용하는 것을 목적으로 합니다.

대상 사용자 – 자동화된 연구 집약, 콘텐츠 생성(오디오, 비디오, 슬라이드, 인포그래픽), 대량 내보내기, 웹 UI를 수동으로 사용하지 않고 노트북을 공유하고 싶은 개발자, 연구자, 고급 사용자에게 적합합니다.

---

빠른 시작 예제

# 설치
uv tool install notebooklm-mcp-cli

# 로그인 (브라우저 열림, 쿠키 추출)
nlm login

# 노트북 생성 및 소스 추가
nlm notebook create "AI Strategy"
nlm source add "AI Strategy" --url "https://arxiv.org/abs/2302.12345"

# 노트북에 요약 요청
nlm notebook query "Summarize the main findings"

# 팟캐스트 생성 및 다운로드
nlm studio create "AI Strategy" audio
nlm download all "AI Strategy" -d ./exports

MCP 등록 예제 (Claude Desktop용)

nlm setup add claude-code   # 필요한 JSON을 Claude 설정에 작성

이제 Claude는 @gemini-notebook-mcp notebook_create "My Notebook"과 같은 명령어를 실행할 수 있습니다.

---

자료

• 전체 문서: docs/GETTING_STARTED.md, docs/CLI_GUIDE.md, docs/MCP_GUIDE.md
• README에 링크된 데모 영상에서 CLI 사용법과 다양한 어시스턴트와의 MCP 통합을 확인할 수 있습니다.
• 패키지는 PyPI에 공개되어 있으며, notebooklm-mcp-cli 로 제공됩니다.