使用说明
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 프로필에서 재로그인이 필요합니다.
