Gemini Notebook CLI & MCP

노트북 서비스를 명령과 도구로 다루는 접근 경로

pip install notebooklm-mcp-cli

구글의 노트북 서비스를 화면이 아니라 명령줄과 MCP 도구로 다루게 해 주는 프로젝트입니다. 노트를 만들고 자료를 넣고 결과물을 뽑는 작업을 스크립트로 엮거나 에이전트에게 맡깁니다. CLI 와 MCP 서버, 에이전트 스킬 세 가지 형태로 제공되고 여러 데스크톱 클라이언트에서 붙여 쓰는 사례가 정리돼 있습니다. 개인 계정은 정기적으로 시험하고 기업용 지원은 실험 단계라고 밝히고 있습니다. 최근 판은 산출물 내려받기 경로를 허용된 폴더 안으로 제한하는 보안 수정이 들어갔습니다.

판단

이럴 때 씁니다

  • 노트북 서비스 작업을 스크립트로 반복해야 할 때
  • 에이전트가 자료를 넣고 결과물을 뽑게 하고 싶을 때
  • 여러 노트를 일괄로 정리해야 할 때

이럴 땐 쓰지 마세요

  • 기업용 계정 지원은 실험 단계입니다
  • 공식 API 가 아니라 서비스 변경에 영향을 받습니다
  • 가끔 쓰는 작업이면 화면에서 하는 편이 빠릅니다

차별점

  • CLI 와 MCP 서버, 에이전트 스킬 세 가지 형태를 함께 제공합니다.
  • 여러 데스크톱 클라이언트에서 붙이는 사례가 정리돼 있습니다.
  • 보안 권고를 발행하고 그에 맞춰 경로 검증을 고쳤습니다.

워크플로

  1. 01패키지를 설치합니다.
  2. 02계정 인증을 설정합니다.
  3. 03진단 명령으로 연결을 확인합니다.
  4. 04CLI 로 노트와 자료를 다룹니다.
  5. 05에이전트에서 쓰려면 MCP 서버로 등록합니다.

주요 명령

명령설명
pip install notebooklm-mcp-cli설치합니다.

함정

설치 전에 확인하세요

  • 산출물 내려받기 경로 검증이 금지 목록 방식이라 우회가 가능했습니다. 최신 판에서 허용된 폴더 안으로 제한하는 방식으로 바뀌었으니 서버를 돌리고 있다면 올려야 합니다.
  • 개인 계정만 정기적으로 시험합니다. 기업용 호스트는 조합에 따라 추가 확인이 필요하다고 문서가 밝히고 있습니다.
  • 서비스 이름이 바뀌었습니다. 예전 이름으로 된 문서와 현재 저장소 이름이 다릅니다.
  • 공식 API 가 아닙니다. 서비스 쪽이 바뀌면 동작이 멈출 수 있습니다.

비교

이 서비스는 화면으로 쓰도록 만들어져 있어 반복 작업이 손에 남습니다. 이쪽은 그 작업을 명령과 도구로 바꿔서 자동화 대상으로 만듭니다. 대신 공식 경로가 아니므로 서비스 변경에 취약합니다.

최근 변경

산출물 내려받기 경로를 허용된 폴더 안으로 제한하는 보안 수정이 들어갔습니다. 이전에는 민감 경로 금지 목록에 기대고 있었습니다.

공식 변경 내역