{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_kfypfwjnx2sn","handle":"g-sheet-mcp","url":"https://wellknown.network/agents/g-sheet-mcp","links":{"self":"https://wellknown.network/agents/g-sheet-mcp/record.json","html":"https://wellknown.network/agents/g-sheet-mcp","markdown":"https://wellknown.network/agents/g-sheet-mcp/record.md","api":"https://wellknown.network/api/v1/agents/g-sheet-mcp","status":"https://wellknown.network/api/v1/agents/g-sheet-mcp/status","claim":"https://wellknown.network/agents/g-sheet-mcp/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/g-sheet-mcp/claim.json","badge":"https://wellknown.network/agents/g-sheet-mcp/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/g-sheet-mcp/history","tools":"https://wellknown.network/api/v1/agents/g-sheet-mcp/tools"},"ard":{"identifier":"urn:air::server:g-sheet-mcp","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"g-sheet-mcp","summary":"Read-only Google Sheets MCP server with ADC auth for Cascade, Cursor, Copilot, Claude, and other MCP clients","description":"# 📄 Google Sheets MCP\n\n`g-sheet-mcp` is a **read-only** [Model Context Protocol (MCP)](https://modelcontextprotocol.io)\nserver that gives AI assistants (Claude, Cursor, Copilot, Cascade, and other MCP clients)\ndirect access to Google Sheets data — authenticated via\n[Application Default Credentials (ADC)](https://cloud.google.com/docs/authentication/application-default-credentials).\n\nNo service account JSON.  No hardcoded secrets.  One command to authenticate, works everywhere.\n\nRepo: `google-sheets-mcp`  ·  [PyPI](https://pypi.org/project/g-sheet-mcp/)  ·  CLI/package: `g-sheet-mcp`  ·  Python import: `g_sheet_mcp`\n\nAll examples in this repo are generic and sanitized for public release.\n\n---\n\n## ✨ Features\n\n| MCP Tool | Description |\n|---|---|\n| `get_spreadsheet_info` | Title, locale, timezone, and all sheet tab metadata |\n| `list_sheets` | List every worksheet tab with row/column dimensions |\n| `read_range` | Read an A1-notation range (e.g. `'Sheet1'!A1:D10`) |\n| `read_sheet` | Read an entire worksheet by tab name (spaces in name handled automatically) |\n| `read_sheet_as_records` | **Best for LLMs** — returns rows as `[{\"col\": val, ...}]` dicts |\n| `get_cell` | Read a single cell by 1-based row/column index |\n| `find_in_spreadsheet` | Substring search across all cells (with optional sheet filter) |\n| `batch_read_ranges` | Read multiple ranges in one API call |\n\nBoth **full Google Sheets URLs** and **bare spreadsheet IDs** are accepted by all tools.  \nSheet names with **spaces** (e.g. `Example Sheet 1`) are quoted automatically.\n\n---\n\n## 🚀 Installation\n\n### Prerequisites\n\n```bash\n# Python 3.11+ and uv\nbrew install uv                  # macOS\n# or: curl -LsSf https://astral.sh/uv/install.sh | sh\n\n# Google Cloud SDK\nbrew install google-cloud-sdk\n# or: https://cloud.google.com/sdk/docs/install\n```\n\n### Step 1 — ✨ Recommended: Install from PyPI (`uvx g-sheet-mcp`)\n\nThis is the recommended setup for most users now that the package is published on PyPI.\n\n```bash\nuvx g-…","publisher":null,"homepage":"https://github.com/mariadb-RupeshBiswas/google-sheets-mcp#readme","repository":"https://github.com/mariadb-RupeshBiswas/google-sheets-mcp#readme","version":"0.1.3","license":null,"protocols":["mcp"],"tags":["ai","anthropic","claude","google-sheets","llm","mcp"],"pricing":null,"endpoints":[{"url":"pypi:g-sheet-mcp","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","repoUrl":"pypi","summary":"pypi","version":"pypi","description":"pypi","homepageUrl":"pypi"}},"derived":{"capabilities":[{"slug":"documents.spreadsheets","name":"Spreadsheets","confidence":1,"provenance":"derived"},{"slug":"security.secrets","name":"Secrets Management","confidence":0.848,"provenance":"derived"},{"slug":"security.identity","name":"Identity & Access","confidence":0.825,"provenance":"derived"},{"slug":"dev.package-management","name":"Packages & Dependencies","confidence":0.768,"provenance":"derived"}],"categories":["dev","documents","security"],"language":"en"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"g-sheet-mcp","registry":"pypi","observedAt":"2026-10-28T02:26:47.535Z","publishedAt":"2026-07-29T12:05:10.533324Z","latestVersion":"0.1.3"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"g-sheet-mcp","url":"https://pypi.org/project/g-sheet-mcp/","firstSeenAt":"2026-09-09T16:25:09.337Z","fetchedAt":"2026-10-28T02:25:17.522Z","normalizedAt":"2026-10-28T02:25:17.522Z"}]},"firstSeenAt":"2026-09-09T16:25:09.337Z","updatedAt":"2026-10-28T02:26:47.535Z"}