@lmdat/google-sheets-oauth-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| MCP_GSHEETS_TOKEN_DIR | No | Directory to store token file (optional) | ~/.mcp-google-sheets |
| GOOGLE_OAUTH_CLIENT_ID | Yes | OAuth client ID from Google Cloud Console | |
| GOOGLE_OAUTH_CLIENT_SECRET | Yes | OAuth client secret from Google Cloud Console | |
| GOOGLE_OAUTH_REDIRECT_PORT | No | Port for OAuth redirect (optional) | 53682 |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| drive_list_spreadsheetsB | List các Google Sheet trong Drive của chính user đang login (không cần share thủ công, vì OAuth đại diện chính user đó). Dùng để tìm spreadsheet_id theo tên thay vì copy URL. Trả về JSON array, mỗi item: {name, id, url, modifiedTime, owner}. |
| sheets_createA | Tạo 1 spreadsheet mới (rỗng). Mặc định nằm ở root My Drive của account đang login. Truyền folder_id nếu muốn đặt luôn vào 1 folder cụ thể. |
| sheets_readA | Đọc giá trị 1 vùng (range) trong Google Sheet, trả về dạng mảng 2 chiều (hàng x cột). |
| sheets_writeA | Ghi đè giá trị vào 1 range cụ thể. Dữ liệu cũ trong range sẽ bị thay thế hoàn toàn. |
| sheets_appendA | Thêm hàng mới vào cuối bảng dữ liệu hiện có (không đè dữ liệu cũ). |
| sheets_clearA | Xóa nội dung (giá trị) trong 1 range, không xóa format/border. |
| sheets_list_tabsA | Liệt kê tên + ID các tab (sheet con) trong 1 Google Sheet file. |
| sheets_create_chartA | Tạo 1 chart COLUMN/BAR/LINE/AREA/SCATTER/PIE từ data có sẵn, chart được embed thẳng vào tab. Mọi range PHẢI ghi đủ tên sheet, dạng "TenSheet!A2:A10" — không hỗ trợ range thiếu tên sheet. |
| sheets_create_candlestick_chartA | Tạo chart nến cho dữ liệu giá (OHLC). data_range PHẢI có ĐÚNG 5 cột liên tiếp theo thứ tự cố định: Date, Open, High, Low, Close — đúng convention chuẩn của Google Sheets (giống khi tự chọn data trên Insert > Chart bằng tay). Ví dụ: "Data!A2:E50" (không gồm dòng header). |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 9 tools
Each tool has a clearly distinct purpose: listing, appending, clearing, creating, charting, reading, writing, and managing tabs. No two tools overlap in functionality.
Most tools follow the 'sheets_<action>' pattern consistently. The only deviation is 'drive_list_spreadsheets' with a different prefix, which is acceptable given the different domain (Drive vs Sheets).
With 9 tools, the server covers essential Google Sheets operations without being overwhelming. Each tool serves a distinct and necessary function.
The tool set covers core CRUD operations (create, read, write, clear) and includes chart creation and tab management. Minor gaps like lacking a delete spreadsheet tool are acceptable for the scope.