notebooklm-mcp

Claude Code에서 Google NotebookLM을 제어하는 MCP 서버.

Playwright 브라우저 자동화로 NotebookLM 웹 UI를 조작합니다 (공식 API 없음).

지원 플랫폼: macOS

최초 설정 (1회)

1. Playwright Chromium 설치

uvx --from notebooklm-mcp playwright install chromium

2. 전용 Chrome 프로필 생성 및 로그인

/Applications/Google\ Chrome.app/Contents/MacOS/Google\ Chrome \
  --user-data-dir="$HOME/Library/Application Support/Google/Chrome/NotebookLM"

Chrome이 열리면 https://notebooklm.google.com 에서 Google 로그인.

⚠️ 기존 Chrome Default 프로필 사용 금지. 프로필 손상 위험이 있습니다.

Claude settings.json 설정

{
  "mcpServers": {
    "notebooklm": {
      "command": "uvx",
      "args": ["notebooklm-mcp"],
      "env": {
        "CHROME_PROFILE_PATH": "/Users/<your-username>/Library/Application Support/Google/Chrome/NotebookLM"
      }
    }
  }
}

사용 예시

# 노트북 목록 조회
"NotebookLM 노트북 목록 보여줘"

# 논문 처리 요청
"notebooklm-test 노트북에 /Users/eddy/Documents/Obsidian Vault/papers/attention.pdf 올려줘"

# 가이드 조회
"attention 노트북 가이드 보여줘"

# Q&A
"이 논문에서 Transformer가 RNN보다 나은 이유가 뭐야?"

도구 목록

| 도구 | 설명 | |------|------| | list_notebooks | 노트북 목록 조회 | | create_notebook | 새 노트북 생성 | | upload_pdf | PDF 업로드 (최대 200MB) | | get_notebook_guide | 노트북 가이드 조회 | | ask_question | Q&A 질문 |

주의사항

• NotebookLM 공식 API가 없어 웹 UI 자동화를 사용합니다. NotebookLM UI 업데이트로 동작이 중단될 수 있습니다.
• 브라우저 창이 실행 중 열려 있어야 합니다 (headless 모드 불가).
• Google 로그인 세션이 만료되면 전용 Chrome 프로필에서 재로그인이 필요합니다.