google-drive-rag
Enables searching and reading documents from Google Drive folders, files, and shared drives. Supports Google Docs, Sheets, Slides, Word, Excel, PowerPoint, PDFs (including scanned OCR), images, RTF, Markdown, text, JSON, CSV, and HTML, while maintaining a periodically synced local index with read-only access.
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
Cách cài google-drive-rag trên VPS
google-drive-rag giúp Claude Code tìm và đọc tài liệu trong Google Drive của bạn. Sau khi cài, bạn chỉ cần hỏi Claude Code trên VPS, ví dụ "tìm hợp đồng thuê văn phòng năm 2025", và Claude trả lời kèm tên tệp, số trang và đường link Drive.
Dịch vụ chạy trong một Docker container trên chính VPS, chỉ nhận kết nối từ VPS đó (địa chỉ 127.0.0.1), không mở ra Internet.
Lưu ý: Với Docker cũ hơn bản 28.0, cổng mở trên
127.0.0.1vẫn có thể bị máy khác cùng mạng nội bộ truy cập; hãy dùng Docker 28.0 trở lên.
Mục lục
Dịch vụ làm gì
Chuẩn bị
Tạo quyền đọc Google Drive
Các bước cài đặt
Kết nối với Claude Code
Kiểm tra kết quả
Tìm trong một thư mục hoặc một tệp
Việc thường ngày
Xử lý sự cố
Related MCP server: MCP Google Drive Server
Dịch vụ làm gì
Đọc các thư mục, tệp hoặc bộ nhớ dùng chung (shared drive) mà bạn đưa link.
Hiểu Google Docs, Sheets, Slides, Word, Excel, PowerPoint (cả bản cũ
.doc,.xls,.ppt), PDF (cả bản scan, nhờ nhận dạng chữ trong ảnh, gọi là OCR), ảnh chụp tài liệu (.jpg,.png,.webp), RTF, Markdown, văn bản, JSON, CSV và trang HTML.Đọc được chữ tiếng Việt có dấu và tiếng Anh trong bản scan và ảnh chụp. Cách thêm ngôn ngữ khác ở phần "Việc thường ngày".
Cứ 15 phút kiểm tra Drive một lần: tệp mới được thêm, tệp sửa được đọc lại, tệp bị xóa hoặc thôi chia sẻ thì bị bỏ khỏi chỉ mục. Chỉ mục (index) là bản sao đã sắp xếp để tìm nhanh, nằm trên VPS.
Chỉ đọc. Dịch vụ không bao giờ sửa hay xóa gì trên Drive.
Chuẩn bị
Khi cài, dịch vụ chỉ hỏi bạn ba thứ:
Khóa API cho tìm kiếm theo ý nghĩa (không bắt buộc). Khóa API là một chuỗi bí mật để dịch vụ dùng tài khoản OpenRouter của bạn. Có khóa thì Claude tìm được cả câu hỏi diễn đạt khác chữ trong tài liệu. Không có khóa thì vẫn tìm theo từ, và bạn có thể thêm khóa sau. Tạo khóa tại trang Keys của OpenRouter (
openrouter.ai/settings/keys).Tệp quyền đọc Google Drive (tệp JSON). Cách tạo ở phần sau.
Link Google Drive của các thư mục hoặc tệp cần tìm. Mở thư mục trên Drive và chép địa chỉ trên thanh trình duyệt.
Bạn cũng cần:
Một VPS Linux, đăng nhập được bằng SSH (ví dụ
ssh ten-ban@dia-chi-vps).Claude Code đã cài trên VPS đó.
Thư mục mã nguồn
google-drive-ragtrên máy của bạn.
Tạo quyền đọc Google Drive
Có hai cách. Trên VPS nên dùng cách 1, vì nó không hết hạn và không cần đăng nhập lại.
Cách 1: tài khoản dịch vụ (khuyên dùng)
Tài khoản dịch vụ (service account) là một "người dùng máy" có địa chỉ email riêng. Bạn chia sẻ thư mục cho email đó giống như chia sẻ cho đồng nghiệp.
Mở
console.cloud.google.com, đăng nhập bằng Gmail của bạn và tạo một dự án mới, ví dụ têndrive-rag.Vào APIs & Services > Library, tìm Google Drive API và nhấn Enable.
Vào IAM & Admin > Service Accounts, nhấn Create service account, đặt tên
drive-reader, rồi nhấn Done. Không cần cấp vai trò nào.Mở tài khoản vừa tạo, chọn thẻ Keys > Add key > Create new key > JSON.
Kết quả: trình duyệt tải về một tệp
.json. Đây là chìa khóa bí mật, đừng gửi cho ai.Chép địa chỉ email của tài khoản dịch vụ (dạng
drive-reader@drive-rag-123.iam.gserviceaccount.com).Trên Google Drive, chia sẻ từng thư mục cần tìm cho email đó với quyền Người xem (Viewer).
Cách 2: đăng nhập Gmail (OAuth)
Dùng khi bạn không muốn chia sẻ thư mục cho tài khoản dịch vụ.
Trong cùng dự án Google Cloud, bật Google Drive API như bước 2 ở trên.
Vào Google Auth Platform, điền tên ứng dụng và email của bạn, chọn đối tượng External, rồi thêm Gmail của bạn vào danh sách Test users.
Vào Clients > Create client, chọn loại Desktop app, rồi tải tệp JSON về.
Quan trọng: Khi ứng dụng còn ở trạng thái Testing, Google cho quyền đăng nhập hết hạn sau 7 ngày. Khi đó dịch vụ báo lỗi đăng nhập và bạn phải chạy lại lệnh
auth google(xem phần "Việc thường ngày"). Muốn tránh, hãy dùng cách 1.
Các bước cài đặt
Chép thư mục mã nguồn lên VPS. Trên máy của bạn, chạy:
scp -r google-drive-rag ten-ban@dia-chi-vps:~/Kết quả: trên VPS có thư mục
~/google-drive-rag.Đăng nhập VPS và cài Docker (bỏ qua nếu đã có):
curl -fsSL https://get.docker.com | sudo shKết quả: lệnh
docker --versionin ra số phiên bản.Chép tệp JSON quyền Google lên VPS vào thư mục
secrets. Trên máy của bạn, chạy (thay tên tệp cho đúng):ssh ten-ban@dia-chi-vps 'mkdir -p ~/google-drive-rag/secrets' scp ten-tep-da-tai.json ten-ban@dia-chi-vps:~/google-drive-rag/secrets/google.jsonTrên VPS, giao tệp đó cho dịch vụ và khóa lại để người khác không đọc được:
cd ~/google-drive-rag sudo chown -R 10001:10001 secrets && sudo chmod 600 secrets/google.jsonDựng và chạy dịch vụ. Lần đầu mất khoảng 5 đến 15 phút vì phải tải LibreOffice và bộ nhận dạng chữ:
sudo docker compose up -d --buildKết quả: dòng cuối báo container
google-drive-rag-gdrive-rag-1đã Started.Trả lời ba câu hỏi cài đặt:
sudo docker compose exec gdrive-rag gdrive-rag setupCâu 1: dán khóa OpenRouter, hoặc nhấn Enter để bỏ qua. Ký tự gõ vào không hiện ra, đó là bình thường.
Câu 2: gõ
1nếu dùng tài khoản dịch vụ,2nếu dùng đăng nhập Gmail; đường dẫn tệp là/secrets/google.json.Câu 3: dán từng link Drive, mỗi link một dòng, rồi nhấn Enter ở dòng trống để kết thúc.
Nếu chọn
2, màn hình hiện một địa chỉ dài. Mở địa chỉ đó trên máy tính của bạn, đăng nhập và nhấn Allow. Trình duyệt sẽ báo không mở được tranglocalhost, đó là bình thường. Chép toàn bộ địa chỉ trên thanh trình duyệt và dán vào VPS.Kết quả: màn hình liệt kê các nguồn đã thêm với tên thư mục Drive.
Bắt đầu đọc Drive ngay, không chờ 15 phút:
sudo docker compose restart gdrive-rag
Lưu ý: Không muốn trả lời câu hỏi? Chép
.env.examplethành.env, điền ba giá trị vào đó (đường dẫn tệp là/secrets/google.json), rồi chạy lại bước 5. Cách này chỉ đủ với tài khoản dịch vụ; đăng nhập Gmail vẫn cần bước 6 một lần.
Kết nối với Claude Code
Chạy lệnh này trên VPS, bằng tài khoản bạn dùng Claude Code:
claude mcp add --transport http --scope user google-drive-rag http://127.0.0.1:8765/mcpMCP là cách Claude Code nói chuyện với công cụ bên ngoài. --scope user cho Claude dùng dịch vụ ở mọi thư mục dự án; bỏ phần này nếu chỉ muốn dùng trong thư mục hiện tại.
Kết quả: lệnh claude mcp list hiện dòng google-drive-rag với trạng thái đã kết nối.
Kiểm tra kết quả
Xem tiến độ đọc tài liệu:
sudo docker compose exec gdrive-rag gdrive-rag statusKết quả: mục
documentscóindexedlớn hơn 0. Thư mục lớn cần vài phút đến vài giờ cho lần đầu.Mở Claude Code và hỏi: "Dùng google-drive-rag tìm tài liệu về <chủ đề của bạn>".
Kết quả: Claude trả lời kèm tên tệp, vị trí (trang, trang chiếu hoặc trang tính) và link Drive.
Tìm trong một thư mục hoặc một tệp
Bạn có thể bảo Claude chỉ tìm trong một thư mục (gồm cả các thư mục con bên trong) hoặc chỉ trong vài tệp. Cách này giúp kết quả gọn và đúng chỗ hơn. Hãy dán link Drive của thư mục hoặc tệp vào câu hỏi, hoặc gọi đúng tên thư mục.
Ví dụ câu hỏi trong Claude Code:
"Dùng google-drive-rag tìm 'hạn thanh toán' chỉ trong thư mục https://drive.google.com/drive/folders/…"
"Trong thư mục Kế toán, tìm các báo cáo thuế năm 2025." Claude sẽ tự xem cây thư mục để biết thư mục Kế toán ở đâu.
"Chỉ tìm trong tệp https://docs.google.com/document/d/…/edit: điều khoản phạt hợp đồng là gì?"
"Thư mục Hợp đồng có những thư mục con nào?"
Kết quả: Claude chỉ trả lời bằng tài liệu nằm trong thư mục hoặc tệp đó. Nếu thư mục hoặc tệp chưa được đọc vào chỉ mục, Claude báo rõ là không tìm thấy nó, thay vì trả về kết quả rỗng.
Lưu ý: Thư mục mới thêm hoặc mới đổi tên trên Drive được cập nhật ở lần đọc Drive kế tiếp (tối đa 15 phút). Đổi tên hay chuyển thư mục không làm dịch vụ đọc lại nội dung tệp.
Muốn tự thử trên VPS, chạy lệnh tìm kèm --folder (link thư mục) hoặc --file (link tệp, dùng nhiều lần được):
sudo docker compose exec gdrive-rag gdrive-rag search "báo cáo thuế" --folder "<link thư mục>"Việc thường ngày
Việc | Lệnh (chạy trong |
Thêm thư mục Drive |
|
Xem danh sách nguồn |
|
Bỏ một nguồn |
|
Đọc lại Drive ngay |
|
Thử tìm một câu |
|
Đăng nhập Gmail lại |
|
Thêm hoặc đổi khóa OpenRouter | Chạy lại |
Xem nhật ký |
|
Cập nhật mã mới | Chép mã mới lên VPS, rồi |
Dữ liệu chỉ mục nằm trong ổ Docker tên gdrive-rag-data, nên vẫn còn khi bạn dựng lại container.
Đọc bản scan bằng ngôn ngữ khác
Mặc định dịch vụ đọc chữ trong bản scan bằng tiếng Việt và tiếng Anh. Muốn thêm một ngôn ngữ, ví dụ tiếng Pháp (mã fra):
Mở tệp
Dockerfile, tìm dòngtesseract-ocr tesseract-ocr-vie tesseract-ocr-engvà thêmtesseract-ocr-fravào cuối dòng đó.Thêm dòng sau vào tệp
.env(tạo tệp từ.env.examplenếu chưa có):GDRAG_OCR_LANGS=vie+eng+fraDựng lại dịch vụ:
sudo docker compose up -d --buildKết quả: các bản scan mới hoặc vừa sửa được đọc bằng cả ba ngôn ngữ. Mã của mỗi ngôn ngữ là phần cuối tên gói, ví dụ
tesseract-ocr-jpnlàjpn.
Lưu ý: Thêm nhiều ngôn ngữ làm việc đọc bản scan chậm hơn và đôi khi nhầm chữ hơn. Chỉ thêm ngôn ngữ mà tài liệu của bạn thật sự dùng.
Sau khi cập nhật lên bản này, các bản scan đã đọc bằng bộ nhận dạng cũ được đọc lại một lần ở lần đọc Drive kế tiếp. Các tệp khác không bị đọc lại.
Xử lý sự cố
Hiện tượng | Nguyên nhân | Cách xử lý |
Nguồn báo | Thư mục chưa chia sẻ cho email tài khoản dịch vụ, hoặc link sai | Chia sẻ thư mục với quyền Người xem, rồi chạy |
Báo | Đăng nhập Gmail hết hạn sau 7 ngày (ứng dụng ở chế độ Testing) | Chạy |
| Tệp chưa giao cho dịch vụ | Chạy lại bước 4 |
| Tệp hỏng, có mật khẩu hoặc quá 200 MB | Mở tệp trên Drive để kiểm tra; các tệp khác không bị ảnh hưởng |
| Thiếu chương trình Tesseract hoặc dữ liệu của một ngôn ngữ trong | Kiểm tra mục "Đọc bản scan bằng ngôn ngữ khác", rồi dựng lại container bằng bước 5. Tệp sẽ được đọc lại khi OCR chạy được |
Claude Code không thấy công cụ | Dịch vụ chưa chạy hoặc chưa đăng ký | Chạy |
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Give Claude only the Google Drive files you choose. Every action logged.
Personal CRM for Claude. Contacts live as plain-text files in your own Google Drive.
Swiss encrypted cloud drive for Claude, ChatGPT and AI agents: search, read and save files.
Read-only Google Ads, GA4 and Search Console data for Claude, with no Google Cloud setup.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceEnables Claude to manage Google Drive files and folders through natural language commands. Supports creating folders, moving/renaming files, retrieving file metadata, and listing folder contents with secure OAuth authentication.-
- FlicenseNot gradedqualityNot gradedmaintenanceConnects AI assistants like Claude to Google Drive, enabling them to browse, read, search, create, and edit files and folders using Google's official API with secure authentication.-
- FlicenseNot gradedqualityCmaintenanceEnables managing Google Drive files, Docs, and Sheets through natural language via Claude Code, with tools for listing, searching, editing, and formatting documents and spreadsheets.-
- AlicenseNot gradedqualityDmaintenanceEnables Claude to search, list, and read files in Google Drive, allowing natural language interaction with your documents and folders.154 npmMIT