NotebookLM MCP Server

NotebookLM의 기능을 MCP (Model Context Protocol)로 제공하는 서버입니다. AI 클라이언트(Claude Desktop, Cursor, Gemini CLI 등)에서 NotebookLM의 노트북 관리, 소스 추가 기능을 직접 사용할 수 있습니다.

주요 기능

노트북 목록 조회: list_notebooks
노트북 생성: create_notebook
웹 소스 추가: add_url_source

설치 방법

1. Python 설치 필요

이 프로젝트를 실행하려면 Python 3.10 이상이 필요합니다. Python 공식 홈페이지에서 설치해 주세요. 설치 시 "Add Python to PATH" 옵션을 반드시 체크해야 합니다.

2. 패키지 설치

(권장) 가상환경을 생성하고 활성화한 후 설치하는 것이 좋습니다.

python -m venv .venv
.\.venv\Scripts\Activate.ps1  # Windows PowerShell

프로젝트 루트에서 다음 명령어를 실행합니다:

pip install .

실행 오류가 발생하면 python -m pip install . 또는 uv pip install .을 시도해 보세요.

실행 방법

설치가 완료되면 다음 명령어로 MCP 서버를 실행할 수 있습니다:

notebooklm-mcp
# 또는
python -m notebooklm_mcp

AI 도구 연결 (Claude Desktop 예시)

claude_desktop_config.json 파일에 다음 설정을 추가하세요:

{
  "mcpServers": {
    "notebooklm": {
      "command": "python",
      "args": ["-m", "notebooklm_mcp"]
    }
  }
}

상세 사용 가이드

더 자세한 실행 방법과 Claude/Cursor 연동 방법은 docs/usage.md 문서를 참고하세요.

주의사항

Chrome 로그인 필요: 이 서버는 로컬 Chrome 브라우저의 쿠키를 사용하여 인증합니다. Chrome에서 Google 계정에 로그인된 상태여야 합니다.
쿠키 권한: 브라우저 종료 후 사용하는 것을 권장하며, 쿠키 접근 권한 오류 시 관리자 권한으로 실행하거나 전체 디스크 접근 권한이 필요할 수 있습니다.