jacob-bd/notebooklm-mcp-cli

Google NotebookLM에 대한 프로그래밍 방식의 접근 — 커맨드 라인 인터페이스 (CLI) 또는 모델 컨텍스트 프로토콜 (MCP) 서버를 통해 제공됩니다.

참고: Pro/free 및 Google AI Ultra (월 $249) 티어 계정으로 테스트되었습니다. NotebookLM Enterprise 계정에서도 작동할 수 있으나 테스트되지는 않았습니다.

📺 데모 시청하기

Codex 설정 + 시네마틱 비디오 및 슬라이드

일반 개요 |
Claude Desktop |
Perplexity Desktop |
MCP Super Assistant |
|---|---|---|---|

CLI 개요 |
CLI, MCP 및 기술 (Skills) |
설정 (Setup), Doctor 및 mcpb |
인포그래픽 지원 |
|---|---|---|---|

nlm 사용하기

스크립팅, 자동화 또는 대화형 사용을 위해 터미널에서 직접 사용하세요:

nlm notebook list # 모든 노트북 목록 표시
nlm notebook create "Research Project" # 노트북 생성
nlm source add <notebook> --url "https://..." # 소스 추가
...

포괄적인 AI 어시스턴트 문서를 보려면 nlm --ai를 실행하세요.

AI 어시스턴트 (Claude, Gemini, Cursor 등)를 NotebookLM에 연결하세요:

# 자동 설정 — 각 도구에 맞는 올바른 구성을 선택합니다
nlm setup add claude-code
nlm setup add gemini
...

그 다음 자연어를 사용하세요: "양자 컴퓨팅에 관한 노트북을 만들고 팟캐스트를 생성해줘"

기능 (Capability)	CLI 명령어 (CLI Command)	MCP 도구 (MCP Tool)
노트북 목록 조회 (List notebooks)	nlm notebook list	notebook_list
노트북 생성 (Create notebook)	nlm notebook create	notebook_create
소스 추가 (URL, 텍스트, Drive, 파일) (Add Sources (URL, Text, Drive, File))	nlm source add	source_add
노트북 질의 (웹 UI에 저장됨) (Query notebook (persists to web UI))	nlm notebook query	notebook_query
스튜디오 콘텐츠 생성 (오디오, 비디오 등) (Create Studio Content (Audio, Video, etc.))	nlm studio create	studio_create
슬라이드 덱 수정 (Revise slide decks)	nlm slides revise	studio_revise
결과물 다운로드 (Download artifacts)	nlm download <type>	download_artifact
웹/Drive 리서치 (Web/Drive research)	nlm research start	research_start
노트북 공유 (Share notebook)	nlm share public/invite	notebook_share_*
Drive 소스 동기화 (Sync Drive sources)	nlm source sync	source_sync_drive
일괄 작업 (Batch operations)	nlm batch query/create/delete	batch
노트북 간 질의 (Cross-notebook query)	nlm cross query	cross_notebook_query
파이프라인 (다단계 워크플로우) (Pipelines (multi-step workflows))	nlm pipeline run/list	pipeline
태그 및 스마트 선택 (Tag & smart select)	nlm tag add/list/select	tag
AI 도구 설정 (Configure AI tools)	nlm setup add/remove/list	—
AI 스킬 설치 (Install AI Skills)	nlm skill install/update	—
문제 진단 (Diagnose issues)	nlm doctor	—

📚 추가 문서 (More Documentation):

시작하기 (Getting Started)— 설치, 로그인, 에이전트 설정 및 다른 NotebookLM MCP로부터의 마이그레이션
CLI 가이드 (CLI Guide)— 전체 명령어 참조
MCP 가이드 (MCP Guide)— 예시가 포함된 35개의 모든 MCP 도구
인증 (Authentication)— 설정 및 문제 해결
API 참조 (API Reference)— 기여자를 위한 내부 API 문서

이 MCP 및 CLI는 다음과 같은 **내부 API (internal APIs)**를 사용합니다:

• 문서화되지 않았으며 예고 없이 변경될 수 있습니다.
• 브라우저에서 쿠키 추출이 필요합니다 (이를 위한 도구를 가지고 있습니다!)

개인적/실험적 목적으로 사용하며, 발생하는 위험은 본인이 부담하십시오.

🆕

Claude Desktop 사용자: 확장 프로그램(.mcpb 파일)을 다운로드 → 더블 클릭 → 완료! 설정이 필요 없는 원클릭 설치입니다.

PyPI에서 설치하십시오. 이 단일 패키지에는 CLI와 MCP 서버가 모두 포함되어 있습니다:

uv tool install notebooklm-mcp-cli

uvx --from notebooklm-mcp-cli nlm --help
uvx --from notebooklm-mcp-cli notebooklm-mcp

pip install notebooklm-mcp-cli

pipx install notebooklm-mcp-cli

설치 후 제공되는 기능:

nlm

— 명령줄 인터페이스 (Command-line interface)

notebooklm-mcp

— AI 어시스턴트를 위한 MCP 서버

대안: 소스에서 설치하기

# 저장소 클론 (Clone)
git clone https://github.com/jacob-bd/notebooklm-mcp-cli.git
cd notebooklm-mcp
...

# uv 사용 시
uv tool upgrade notebooklm-mcp-cli
# pip 사용 시
...

업그레이드 후에는 업데이트된 MCP 서버에 다시 연결하기 위해 사용 중인 AI 도구를 재시작하세요:

Claude Code: 애플리케이션을 재시작하거나, 다시 연결하려면 /mcp를 사용하세요
Cursor: 애플리케이션을 재시작하세요
Gemini CLI: CLI 세션을 재시작하세요

만약 이전에 CLI와 MCP 패키지를 각각 별도로 설치했다면, 통합 패키지로 마이그레이션해야 합니다.

uv tool list | grep notebooklm

삭제해야 할 레거시 (Legacy) 패키지:

패키지	역할
notebooklm-cli	기존 CLI 전용 패키지
notebooklm-mcp-server	기존 MCP 전용 패키지

# 기존 CLI 패키지 삭제 (설치된 경우)
uv tool uninstall notebooklm-cli
# 기존 MCP 패키지 삭제 (설치된 경우)
...

레거시 패키지를 삭제한 후에는 심볼릭 링크 (symlinks)를 수정하기 위해 재설치하세요:

uv tool install --force notebooklm-mcp-cli

왜 --force를 사용하나요?
여러 패키지가 동일한 실행 파일을 제공할 때, uv는 삭제 후 깨진 심볼릭 링크를 남길 수 있습니다. --force 플래그를 사용하면 깨끗한 심볼릭 링크를 보장할 수 있습니다.

uv tool list | grep notebooklm

다음 항목만 보여야 합니다:

notebooklm-mcp-cli v0.2.0
- nlm
- notebooklm-mcp

기존에 사용하던 쿠키 (cookies)는 그대로 작동해야 하지만, 인증 문제가 발생할 경우 다음 명령어를 사용하세요:

nlm login

참고: MCP 서버 설정 (Claude Code, Cursor 등에서의 설정)은 변경할 필요가 없습니다. 실행 파일 이름인 notebooklm-mcp가 동일하기 때문입니다.

도구를 처음 설정하거나 브라우저 기반의 NotebookLM MCP에서 마이그레이션하는 경우 — '시작 가이드 (Getting Started Guide)'를 참조하세요. 설치, 로그인, 에이전트 등록, 그리고 "두 개의 NotebookLM 서버가 등록됨" 함정을 피할 수 있는 단계별 마이그레이션 경로를 다룹니다.

MCP를 완전히 제거하려면:

# uv 사용 시
uv tool uninstall notebooklm-mcp-cli
# pip 사용 시
...

또한 사용 중인 AI 도구에서도 제거해야 합니다:

nlm setup remove claude-code
nlm setup remove cursor
# ... 또는 설정된 다른 도구

CLI 또는 MCP를 사용하기 전에 NotebookLM 인증을 완료해야 합니다:

# 자동 모드 (Auto mode): 브라우저를 실행하며, 로그인하면 쿠키가 자동으로 추출됩니다
nlm login
# 이미 인증되었는지 확인
...

프로필 관리 (Profile management):

nlm login --check # 현재 인증 상태 표시
nlm login switch <profile> # 기본 프로필 전환
nlm login profile list # 이메일 주소와 함께 모든 프로필 목록 표시
...

각 프로필은 독립된 브라우저 세션을 가지므로, 여러 Google 계정에 동시에 로그인할 수 있습니다.

CLI가 아닌 MCP 서버만 필요한 경우:

nlm login # 자동 모드 (브라우저 실행)
nlm login --manual # 수동 파일 모드 (Manual file mode)

작동 방식: 자동 모드 (Auto mode)는 전용 브라우저 프로필(Chrome, Arc, Brave, Edge, Chromium 등을 지원)을 실행하며, 사용자가 Google에 로그인하면 쿠키가 자동으로 추출됩니다. 로그인 상태는 향후 인증 갱신을 위해 유지됩니다.

특정 브라우저를 선호하시나요? nlm config set auth.browser chromium 명령어로 설정할 수 있습니다.

(또는 brave, arc, edge, chrome 등). 선호하는 브라우저를 찾을 수 없는 경우 자동 감지 (auto-detection) 방식으로 전환됩니다.

상세한 지침과 문제 해결 방법은 docs/AUTHENTICATION.md를 참조하세요.

이 MCP는 ⚠️ 컨텍스트 윈도우 경고 (Context Window Warning): 35개의 도구를 제공합니다. 컨텍스트를 보존하기 위해 NotebookLM을 사용하지 않을 때는 이를 비활성화하세요. Claude Code에서는 @notebooklm-mcp를 사용하여 토글할 수 있습니다.

nlm setup을 사용하면 AI 도구에 대해 MCP 서버를 자동으로 구성할 수 있으며, 수동으로 JSON을 편집할 필요가 없습니다:

# 지원되는 모든 도구에 추가
nlm setup add claude-code
nlm setup add claude-desktop
...

AI 어시스턴트가 도구를 효과적으로 사용할 수 있도록 NotebookLM 전문가 가이드를 설치하세요. Cline, Antigravity, OpenClaw, Codex, OpenCode, Claude Code, 그리고 Gemini CLI를 지원합니다.

# 스킬 파일 설치
nlm skill install cline
nlm skill install openclaw
...

nlm setup remove claude-code

패키지를 설치하고 싶지 않다면, uvx를 사용하여 즉석에서 실행할 수 있습니다:

# CLI 명령어를 직접 실행
uvx --from notebooklm-mcp-cli nlm setup add cursor
uvx --from notebooklm-mcp-cli nlm login

JSON 설정을 사용하는 도구의 경우, uvx를 가리키도록 설정하세요:

{
"mcpServers": {
"notebooklm-mcp": {
...

수동 설정 (선택 사항)

팁: nlm setup add json을 실행하면 도구에 맞는 올바른 JSON 스니펫(snippet)을 생성해 주는 대화형 마법사가 실행됩니다.

Claude Code / Gemini CLI는 자체 CLI를 통해 MCP 서버를 추가하는 기능을 지원합니다:

claude mcp add --scope user notebooklm-mcp notebooklm-mcp
gemini mcp add --scope user notebooklm-mcp notebooklm-mcp

Cursor / Windsurf는 PATH에서 명령어를 찾아 해결하므로, 명령어 이름만으로 충분합니다:

{
"mcpServers": {
"notebooklm-mcp": {
...

도구	설정 위치
Cursor	~/.cursor/mcp.json
Windsurf	~/.codeium/windsurf/mcp_config.json

**GitHub Copilot (VS Code 워크스페이스)**는 최상위 servers 키를 가진 .vscode/mcp.json을 사용합니다:

{
"servers": {
"notebooklm-mcp": {
...

Claude Desktop은 PATH를 찾지 못할 수 있습니다. 바이너리의 전체 경로를 사용하세요:

{
"mcpServers": {
"notebooklm-mcp": {
...

경로는 which notebooklm-mcp 명령어로 확인할 수 있습니다.

도구	설정 위치
Claude Desktop	~/Library/Application Support/Claude/claude_desktop_config.json
GitHub Copilot	.vscode/mcp.json

📚 전체 설정 상세 정보: MCP 가이드 — 서버 옵션, 환경 변수, HTTP 전송 (HTTP transport), 다중 사용자 설정, 그리고 컨텍스트 창 (context window) 관리.

자연어를 사용하여 AI 도구(Claude Code, Cursor, Gemini CLI)와 간단히 채팅하세요. 다음은 몇 가지 예시입니다:

• "내 모든 NotebookLM 노트북 목록을 보여줘"

• "'AI 전략 연구'라는 이름의 새 노트북을 생성해줘"

• "'기업용 AI ROI 지표'에 대해 웹 조사를 시작하고 찾은 소스들을 보여줘"

• "'클라우드 마켓플레이스 트렌드'에 대해 심층 연구(deep research)를 수행하고 상위 10개 소스를 가져와줘"

• "내 Google Drive에서 '제품 로드맵'에 관한 문서를 검색해서 노트북을 만들어줘"

• "이 URL을 내 노트북에 추가해줘: https://example.com/article"

• "Kubernetes에 관한 이 YouTube 영상을 노트북에 추가해줘"

• "내 회의록을 이 노트북의 텍스트 소스로 추가해줘"

• "이 Google Doc을 내 연구 노트북으로 가져와줘"

• "이 노트북의 주요 발견 사항(key findings)은 무엇인가요?"

• "이 모든 소스들에 걸친 주요 논거들을 요약해줘"

• "이 소스는 보안 모범 사례(security best practices)에 대해 무엇이라고 말하나요?"

• "이 노트북이 무엇에 관한 것인지 AI 요약을 해줘"

• "채팅 설정을 더 긴 응답을 사용하는 학습 가이드 스타일로 구성해줘"

(CLI 또는 MCP에서 전송된 모든 쿼리는 NotebookLM 웹 UI 채팅 기록에 자동으로 저장됩니다!)

• "이 노트북을 딥 다이브(deep dive) 형식의 오디오 팟캐스트 개요로 만들어줘"

• "클래식 비주얼 스타일의 영상 설명(video explainer)을 생성해줘"

• "이 소스들로 브리핑 문서를 만들어줘"

• "학습을 위한 플래시카드를 만들어줘, 난이도는 중간으로"

• "전문적인 스타일의 가로 방향 인포그래픽을 생성해줘"

• "내 연구 소스들로부터 마인드맵을 구축해줘"

• "이 노트북으로 슬라이드 덱 발표 자료를 만들어줘"

• "어떤 Google Drive 소스가 최신 상태가 아닌지 확인하고 동기화해줘"

• "이 노트북의 모든 소스를 최신 상태(freshness status)와 함께 보여줘"

• "노트북에서 이 소스를 삭제해줘"

• "내 오디오 개요 생성 상태를 확인해줘"

• "이 노트북의 공유 설정을 보여줘"

• "링크가 있는 누구나 볼 수 있도록 이 노트북을 공개로 설정해줘"

• "이 노트북에 대한 공개 액세스를 비활성화해줘"

• "user@example.com을 이 노트북의 편집자로 초대해줘"

• "내 연구 노트북에 뷰어를 추가해줘"

Pro tip (전문가 팁): 스튜디오 콘텐츠(오디오, 비디오, 보고서 등)를 생성한 후에는 상태를 폴링(poll)하여 생성이 완료되었을 때 다운로드 URL을 받으세요.

구성 요소	기간	새로고침
쿠키 (Cookies)	약 2-4주	헤드리스 브라우저(headless browser)를 통한 자동 새로고침 (프로필이 저장된 경우)
...

v0.1.9+: 이제 서버가 토큰 만료를 자동으로 처리합니다:

• CSRF 토큰이 만료되면 즉시 새로고침합니다.
• 외부에서 업데이트된 경우 디스크에서 쿠키를 다시 로드합니다.
• 프로필에 로그인 정보가 저장되어 있다면 헤드리스 브라우저 인증(headless browser auth)을 실행합니다.

토큰을 명시적으로 다시 로드하려면 refresh_auth()를 호출할 수도 있습니다.

자동 새로고침에 실패하면(Google 로그인이 완전히 만료된 경우), nlm login을 다시 실행하세요.

증상:

• uv tool upgrade notebooklm-mcp-cli를 실행하면 이전 버전(예: 0.1.9 대신 0.1.5)이 설치됩니다.
• uv cache clean으로도 문제가 해결되지 않습니다.

원인: uv tool upgrade는 최초 설치 시의 버전 제약 조건(version constraints)을 준수합니다. 처음에 이전 버전을 설치했거나 제약 조건을 설정하여 설치했다면, upgrade는 설계상 해당 범위 내에 머물게 됩니다.

해결 방법 — 강제 재설치:

uv tool install --force notebooklm-mcp-cli

이 명령은 캐시된 제약 조건을 우회하여 PyPI에서 최신 버전을 직접 설치합니다.

확인:

uv tool list | grep notebooklm
# 결과 예시: notebooklm-mcp-cli v0.1.9 (또는 최신 버전)

Rate limits (요청 제한): 무료 티어는 하루 약 50개의 쿼리(queries)를 제공합니다.
No official support (공식 지원 없음): API는 예고 없이 변경될 수 있습니다.
Cookie expiration (쿠키 만료): 몇 주마다 쿠키를 다시 추출해야 합니다.

상세한 API 문서와 새로운 기능을 추가하는 방법은 CLAUDE.md를 참조하세요.