google-workspace-mcp

MCP server kết nối Claude với Google Sheets, Google Docs và Google Drive.

Khác với connector Google Drive mặc định (chỉ đọc/ghi file), server này đọc & ghi được từng ô trong Google Sheets: viết công thức, định dạng, chèn/xoá hàng cột, tạo dropdown, biểu đồ, conditional format…

Chạy hoàn toàn trên máy bạn, bằng tài khoản Google Cloud của chính bạn. Không có máy chủ trung gian, dữ liệu không đi qua bên thứ ba.

Cài đặt

Cách 1 — Claude Desktop (dễ nhất)

Tải file .mcpb ở mục Releases → double-click → Install. Rồi mở chat gõ "Hướng dẫn mình kết nối Google", Claude sẽ dẫn từng bước.

Cách 2 — Chạy từ mã nguồn

git clone https://github.com/<user>/google-workspace-mcp.git
cd google-workspace-mcp
npm install

Tạo OAuth client của riêng bạn (miễn phí, ~10 phút, làm 1 lần):

1. Vào Google Cloud Console → tạo project mới.

2. APIs & Services → Library → Enable 3 API: Google Sheets API, Google Docs API, Google Drive API.

3. APIs & Services → OAuth consent screen → chọn External → điền tên app → ở mục Audience, thêm email của bạn vào Test users.

4. APIs & Services → Credentials → Create Credentials → OAuth client ID → chọn Desktop app → Create → Download JSON.

5. Đổi tên file vừa tải thành credentials.json, đặt vào thư mục gốc của project (xem mẫu ở credentials.example.json).

Đăng nhập:

npm run auth

Trình duyệt mở ra → đăng nhập tài khoản Google → token lưu vào token.json (tự refresh, không cần làm lại).

Google hiện "Google hasn't verified this app"? Bình thường — app này do chính bạn vừa tạo. Bấm Advanced → Go to … (unsafe) → Continue.

Khai báo server trong file cấu hình MCP của Claude:

{
  "mcpServers": {
    "google-workspace": {
      "command": "node",
      "args": ["/đường/dẫn/tới/google-workspace-mcp/index.js"]
    }
  }
}

Related MCP server: google-mcp

Bảo mật

• credentials.json và token.json chứa bí mật của bạn — đã được .gitignore, đừng bao giờ commit hay chia sẻ.

• token.json cho phép truy cập Google account của bạn mà không cần mật khẩu. Coi nó như mật khẩu.

• Mỗi người dùng nên tạo OAuth client riêng, không dùng chung.

Tools

Drive (10)

Sheets (18)

Docs (8)

Cấu hình (env, tuỳ chọn)

• GOOGLE_OAUTH_CREDENTIALS — đường dẫn file client secret (mặc định: ./credentials.json, copy từ vivian/credentials.json)

• GOOGLE_OAUTH_TOKEN — đường dẫn file token (mặc định: ./token.json)