Gemini Notebook (구 Google NotebookLM) CLI & MCP Server
Gemini Notebook MCP Header
PyPI version
PyPI downloads
Total downloads
Python
License
Gemini Notebook에 대한 프로그래밍 방식 접근 — 명령줄 인터페이스(CLI) 또는 Model Context Protocol(MCP) 서버를 통해 가능합니다.
🚨 새 기능: 보호된 로그인 저장소 (권장)
저장된 Google 로그인을 이제 평문 파일 대신 컴퓨터의 키체인에 키를 보관하여 암호화할 수 있습니다. 개인용 컴퓨터 사용자는 다음 명령어를 사용하여 반드시 전환하는 것을 강력히 권장합니다:
nlm auth storage set protected
💡 또한 'nlm setup' 마법사를 사용하여 '자격 증명 보호(Credentials Protection)' 옵션을 선택할 수도 있습니다.
선택 사항: 이 기능을 켜지 않으면 아무것도 변경되지 않습니다. 서버, cron, Docker 및 SSH 설정은 평문 파일을 유지할 수 있습니다.
📖 작동 방식 · 📺 짧은 비디오 시청하기
🤖 재미있는 사실: 이 비디오는 gemini-notebook-mcp를 사용하는 에이전트에 의해 제작되었습니다.
참고: 개인/소비자 계정은 정기적으로 테스트됩니다. Gemini Notebook Enterprise 지원은 실험적입니다. 문서화된 notebook.cloud.google.com 호스트는 프로젝트 인증을 거친 global 배포로 라이브 검증되었으며, 다른 Enterprise 호스트 변형은 추가적인 유효성 검사가 필요할 수 있습니다.
☕ 만약 notebooklm-mcp-cli가 유용하다고 생각되신다면, 커피 한 잔 사주세요.
무료이며 제 여가 시간에 만들어진 것이지만, 모든 Gemini Notebook 기능을 테스트하는 데는 실제 시간과 자원이 소요됩니다. 커피 한 잔은 제가 이를 충당하고 계속 배포할 수 있도록 도와줍니다. 감사합니다! 🙏
[Buy Me A Coffee 버튼 이미지]
📺 데모 영상 시청하기
최신
MCP 데모
CLI 데모
⚡ 빠른 시작
세 가지 명령만으로 아무것도 없는 상태에서 연결된 AI 비서로 전환할 수 있습니다:
- 설치(Install) (사용 가능한
nlm과 MCP 서버를 제공합니다):
uv tool install notebooklm-mcp-cli
- Google 계정에 로그인(Sign in)합니다:
- AI 도구를 연결(Connect)합니다:
설정 마법사 (nlm setup)
nlm setup은 사용자의 장치에 설치된 AI 도구를 찾아 Gemini Notebook에 연결해 줍니다. 설정 파일을 편집할 필요가 없습니다. 화살표 키를 사용하여 옵션을 선택하세요.
| 메뉴 옵션 | 기능 설명 |
|---|
| 내 도구 상태 보기 | 감지된 모든 도구에 대한 표: MCP 연결 (✓ 설정됨 · ✗ 아직 아님 · ⚠ 이름 변경) 및 스킬 버전 (⬆ 업그레이드 가능 시). |
| ... | |
- Esc: 모든 화면에서 뒤로 가기(및 메인 메뉴 종료)를 수행합니다.
- 모든 파일은 변경되기 전에
~/.notebooklm-mcp-cli/backups/에 백업됩니다.
- 연결되는 도구: Claude Code, Claude Desktop (일반 및 Relay AI / 3P), Codex CLI / ChatGPT 데스크톱 앱, Gemini CLI, Cursor, Windsurf, Cline, Antigravity, GitHub Copilot (VS Code), OpenCode와 연결됩니다. 이 스킬은 Hermes와 OpenClaw에도 설치됩니다.
- Claude Desktop Chat & Cowork, 및 claude.ai: 이들은 사용자의 Claude 계정에 업로드된 스킬만 사용합니다. 스킬 추가에서 Claude Desktop / claude.ai를 체크하면 마법사가
~/Downloads/nlm-skill.zip을 저장하고 업로드할 위치를 보여줍니다(사용자 정의 → 스킬 → 추가). 또는 nlm skill package를 실행하세요.
- Claude Desktop: 연결하기 전에 완전히 종료해야 합니다(Cmd+Q). 열려 있는 상태에서는 설정을 덮어쓸 수 있으므로, 마법사는 닫힐 때까지 쓰기를 거부합니다.
- 스크립트 및 CI: 모든 옵션에는 직접적인 명령어가 있습니다 —
nlm setup add <도구>, nlm setup remove <도구>, nlm setup list, nlm skill install <도구>. MCP 구성을 참조하세요.
사용 방법 두 가지
🖥️ 명령줄 인터페이스 (CLI)
스크립팅, 자동화 또는 대화형 사용을 위해 터미널에서 nlm을 직접 사용합니다:
nlm notebook list
nlm notebook create "Research Project"
nlm source add <notebook> --url "https://..."
...
종합적인 AI 어시스턴트 문서화를 위해 nlm --ai를 실행하세요.
🤖 MCP 서버 (AI 에이전트를 위한 기능)
AI 어시스턴트(Claude, Gemini, Cursor 등)를 Gemini Notebook에 연결합니다:
nlm setup
nlm setup add codex
다음으로 자연어를 사용합니다: "양자 컴퓨팅에 대한 노트북을 생성하고 팟캐스트를 만드세요"
기능(Features)
| 기능(Capability) | CLI 명령어 | MCP 도구 |
|---|
| 노트북 목록 보기 (List notebooks) | nlm notebook list | notebook_list |
| ... | | |
📚 추가 문서:
중요 면책 조항 (Important Disclaimer)
이 MCP와 CLI는 다음을 사용하는 **내부 API(internal APIs)**를 사용합니다:
- 문서화되어 있지 않으며 예고 없이 변경될 수 있음
- 브라우저에서 쿠키 추출이 필요함 (제가 이를 위한 도구를 가지고 있습니다!)
- Google의 서비스 약관(Terms of Service)과 일치하지 않을 수 있음
개인적/실험적 목적으로 사용자의 책임 하에 사용하십시오.
설치 (Installation)
🆕 Claude Desktop 사용자: 확장 프로그램 다운로드 (.mcpb 파일) → 더블 클릭 → 완료! 설정이 필요 없는 원클릭 설치입니다.
PyPI에서 설치합니다. 이 단일 패키지에는 CLI와 MCP 서버 모두가 포함되어 있습니다:
uv 사용 (권장)
uv tool install notebooklm-mcp-cli
uvx 사용 (설치 없이 실행)
uvx --from notebooklm-mcp-cli nlm --help
uvx --from notebooklm-mcp-cli notebooklm-mcp
pip 사용
pip install notebooklm-mcp-cli
pipx 사용
pipx install notebooklm-mcp-cli
설치 후 얻게 되는 것:
nlm — 커맨드라인 인터페이스(CLI)notebooklm-mcp — AI 어시스턴트를 위한 Gemini Notebook MCP 서버
<details>
<summary>대안: 소스에서 설치</summary>
git clone https://github.com/jacob-bd/gemini-notebook-mcp-cli.git
cd notebooklm-mcp
...
</details>
업그레이드하기
uv tool upgrade notebooklm-mcp-cli
...
업그레이드 후에는 업데이트된 MCP 서버에 다시 연결하려면 사용 중인 AI 도구를 재시작해야 합니다:
- Claude Code: 애플리케이션을 재시작하거나
/mcp를 사용하여 다시 연결합니다.
- Cursor: 애플리케이션을 재시작합니다.
- Gemini CLI: CLI 세션을 재시작합니다.
레거시 버전에서 업그레이드하기
이전에 별도의 CLI 및 MCP 패키지를 설치했다면, 통합된 패키지로 마이그레이션해야 합니다.
1단계: 설치된 내용 확인
uv tool list | grep notebooklm
제거할 레거시 패키지:
| 패키지 | 이전 명칭 |
|---|
notebooklm-cli | 구 CLI 전용 패키지 |
notebooklm-mcp-server | 구 MCP 전용 패키지 |
2단계: 레거시 패키지 제거
uv tool uninstall notebooklm-cli
...
3단계: 통합 패키지 재설치
레거시 패키지를 제거한 후, 심볼릭 링크(symlinks)를 수정하기 위해 다시 설치합니다:
uv tool install --force notebooklm-mcp-cli
--force의 이유? 여러 패키지가 동일한 실행 파일(executable)을 제공할 경우, uv는 제거 후 손상된 심볼릭 링크를 남길 수 있습니다. --force 플래그는 깨끗한 심볼릭 링크가 유지되도록 보장합니다.
4단계: 설치 확인
uv tool list | grep notebooklm
다음 내용만 보여야 합니다:
notebooklm-mcp-cli v0.2.0
- nlm
- notebooklm-mcp
5단계: 재인증
기존 쿠키가 작동해야 하지만, 인증 문제가 발생하면 다음 명령을 실행합니다:
참고: 설정된 MCP 서버 이름은 이제 gemini-notebook-mcp입니다. 기존 설치와의 호환성을 위해 실행 파일명은 여전히 notebooklm-mcp를 유지합니다.
시작하기
도구를 처음 설정하거나 — 또는 브라우저 기반 Gemini Notebook MCP에서 마이그레이션하는 경우 — Getting Started Guide를 참조하세요. 여기에는 설치(install), 로그인(login), 에이전트 등록(agent registration) 및 "두 개의 Gemini Notebook 서버가 등록됨"이라는 문제 상황을 피할 수 있는 단계별 마이그레이션 경로가 포함되어 있습니다.
제거하기 (Uninstalling)
MCP를 완전히 제거하려면:
