jacob-bd/gemini-notebook-mcp-cli

Programmatic access to Gemini Notebook - via command-line interface (CLI), Model Context Protocol (MCP) server, and AI agent skills.

gemini‑notebook‑mcp‑cli

무엇인가요 – Python 패키지로, 명령줄 도구(nlm)와 Model-Context-Protocol(MCP) 서버(notebooklm-mcp)를 제공합니다. 이는 Google Gemini Notebook(이전 이름: Google NotebookLM)을 프로그래밍 방식으로 제어하고, Claude, Cursor, Gemini-CLI와 같은 AI 에이전트에게 동일한 기능을 공개할 수 있게 해줍니다.

왜 중요한가요 – Gemini Notebook은 Google의 개인 지식 기반 서비스로, 노트북, 소스, 오디오/비디오 '스튜디오' 아티팩트, 인터랙티브 리포트를 저장할 수 있습니다. 안정적인 CLI와 MCP 엔드포인트를 제공함으로써, 이 프로젝트는 스크립트, CI 파이프라인, 또는 MCP 프로토콜을 사용하는 다른 AI 어시스턴트에서도 노트북을 사용할 수 있게 합니다.

빠른 시작 (3개의 명령어)

설치 – uv tool install notebooklm-mcp-cli (또는 pip install notebooklm-mcp-cli).
로그인 – nlm login (브라우저를 열어 Google 쿠키를 추출하고 저장합니다. OS 키체인에 암호화하여 저장할 수도 있습니다).
도구 연결 – nlm setup은 인터랙티브 워즈드를 실행하여 로컬 AI 도구(Claude, Cursor, Gemini-CLI, Copilot 등)를 탐지하고 MCP 서버를 등록합니다.

핵심 기능

기능	CLI 명령어	MCP 액션 (에이전트에 공개됨)
노트북 목록	`nlm notebook list`	`notebook_list`
노트북 생성	`nlm notebook create "My Project"`	`notebook_create`
소스 추가 (URL, 텍스트, 드라이브 파일)	`nlm source add <nb> --url …`	`source_add`
노트북 쿼리 (웹 UI에 추가)	`nlm notebook query "…"`	`notebook_query`
채팅 세션 관리	`nlm chats list/get/export`	`chat_list`, `chat_get`, `chat_export`
스튜디오 콘텐츠 생성 (오디오, 비디오, 슬라이드)	`nlm studio create …`	`studio_create`
아티팩트 다운로드	`nlm download <type> …`	`download_artifact`
배치/파이프라인 워크플로우	`nlm batch …`, `nlm pipeline run`	`batch`, `pipeline`
태그 및 스마트 선택	`nlm tag add/list/select`	`tag`
사용량/할당량 정보	`nlm usage`	`usage_get`
인증 정보 보호	`nlm auth storage set protected`	–

에이전트 사용 방법

MCP 서버 실행 – notebooklm-mcp로 로컬 HTTP 엔드포인트를 시작합니다.
에이전트 등록 – 워즈드(nlm setup add <tool>)가 대상 AI 도구(Claude 데스크톱, Cursor 등)에 JSON 설정을 기록합니다.
자연어 호출 – 등록 후, 에이전트에게 "양자 컴퓨팅에 관한 노트북을 만들고 팟캐스트를 생성해줘"라고 요청할 수 있습니다. 에이전트는 이 요청을 MCP 호출(notebook_create, studio_create 등)로 변환하고, 서버가 당신 대신 Gemini Notebook과 소통합니다.

설치 옵션

방법	명령어
uv (권장)	`uv tool install notebooklm-mcp-cli`
uvx (설치 없이 실행)	`uvx --from notebooklm-mcp-cli nlm --help`
pip	`pip install notebooklm-mcp-cli`
pipx	`pipx install notebooklm-mcp-cli`
소스에서	리포지토리 복제 후 `uv tool install .`

nlm(CLI)와 notebooklm-mcp(MCP 서버)가 모두 $PATH에 추가됩니다.

인증 및 보안

브라우저 세션에서 추출한 Google 쿠키 사용 (자동 모드 또는 수동 파일 임포트).
선택적 보호 저장소는 OS 키체인으로 저장된 쿠키를 암호화합니다. 헤드리스 또는 Docker 환경에서는 일반 파일 저장도 지원됩니다.
여러 프로필 지원 (--profile work, --profile personal 등).
크론 기반 토큰 갱신을 위한 헤드리스 리프레시 명령어 (nlm auth refresh) 제공.
면책 조항 – 이 도구는 비공식 내부 Google API에 접속합니다. 개인/실험용 목적을 전제로 하며, Google 이용 약관을 위반할 수 있습니다.

유지보수 및 업그레이드

동일한 설치 도구로 업그레이드 가능 (uv tool upgrade notebooklm-mcp-cli, pip install --upgrade … 등).
구형 패키지(notebooklm-cli, notebooklm-mcp-server)는 폐기됨. README에 마이그레이션 가이드 포함.
모든 설정 및 캐시 데이터는 ~/.notebooklm-mcp-cli에 저장되며, 변경 전 자동 백업이 생성됩니다.

라이선스 및 커뮤니티

라이선스: MIT (LICENSE 참조).
PyPI에 게시됨 (배지로 현재 버전 및 다운로드 수 표시).
저자는 지속적인 테스트를 지원하기 위해 Buy-Me-A-Coffee를 통한 기부를 환영합니다.

요약

gemini-notebook-mcp-cli는 Google의 Gemini Notebook을 프로그래밍 가능한 서비스로 만들고, AI 어시스턴트의 성장하는 생태계에서 접근 가능하게 만드는 실용적인 브리지입니다. 이미 Claude, Cursor, Gemini-CLI 또는 유사한 에이전트를 사용 중이고, 노트북 읽기/쓰기, 오디오/비디오 생성, 아티팩트 자동 공유를 원한다면, 최소한의 설정으로 사용 가능한 CLI + MCP 서버를 제공합니다.