{
  "markdown": "# Google Sheets MCP Server\n\nA hosted **Google Sheets MCP server**. Connect any Google Sheet to Claude, ChatGPT, Cursor, or Claude Code — and query it in plain English.\n\nNo Google Cloud project. No service account. No server to run. Paste a share URL and you get an MCP endpoint.\n\n> **Read-only by design.** The server can list, inspect, and query your sheet. It cannot modify it. Safe to hand to an agent.\n\nPowered by [PasteSheet](https://pastesheet.com). Published to the official MCP Registry as `com.pastesheet/google-sheets`.\n\n---\n\n## Quick start\n\n### Claude Code\n\n```bash\nclaude mcp add --transport http pastesheet https://pastesheet.com/mcp\n```\n\n### Claude Desktop / Claude web\n\nSettings → **Connectors** → **Add custom connector** → paste:\n\n```\nhttps://pastesheet.com/mcp\n```\n\nYou'll be sent through OAuth once, then Claude can query every sheet in your workspace.\n\n### Cursor\n\n`~/.cursor/mcp.json` — see [`examples/cursor-mcp.json`](examples/cursor-mcp.json):\n\n```json\n{\n  \"mcpServers\": {\n    \"pastesheet\": {\n      \"url\": \"https://pastesheet.com/mcp\"\n    }\n  }\n}\n```\n\n### ChatGPT\n\nSettings → **Connectors** → **Add custom connector** → `https://pastesheet.com/mcp`, then authorize with OAuth.\n\n---\n\n## Two servers, two URLs\n\n| Server | URL | Use it when |\n|---|---|---|\n| **Workspace** | `https://pastesheet.com/mcp` | You want one connector that exposes **every** sheet in your account. Authenticates with OAuth. **Start here.** |\n| **Single sheet** | `https://pastesheet.com/mcp/sheets/{endpoint-id}` | You want to expose exactly one sheet. Public sheets are keyless; private ones take `Authorization: Bearer ps_...`. |\n\nThe workspace URL is the same for everyone — OAuth resolves which account you are, and you only ever see your own sheets.\n\n---\n\n## Tools\n\n| Tool | What it does |\n|---|---|\n| `list_sheets` | Discover the sheets in your workspace and their ids. *(workspace server only)* |\n| `list_tabs` | List a sheet's tabs and the default one. |\n| `get_schema` | Read each column's name, alias, and type before querying. |\n| `query_rows` | Read rows with filters, partial matches, full-text search, sorting, and pagination. |\n\n---\n\n## Example prompts\n\nOnce connected, just ask:\n\n- *\"What's in my Products sheet?\"*\n- *\"Which rows in the Q3 tab have status = shipped?\"*\n- *\"Total revenue by region from my Sales sheet.\"*\n- *\"Find every customer whose company starts with 'Acme'.\"*\n\nThe agent calls `list_sheets` → `get_schema` → `query_rows` on its own. You don't name the tools.\n\n---\n\n## Why not talk to the Google Sheets API directly?\n\nYou can — it's free. But it's built for a different job:\n\n- It reads **cells and ranges**, not records. You reassemble rows yourself.\n- It needs a Google Cloud project plus OAuth or a service account.\n- It meters you: **300 read requests per minute per project, 60 per minute per user**, then returns `429` ([Google's published limits](https://developers.google.com/workspace/sheets/api/limits)).\n\nThat last one bites with agents, because agents are chatty — one question becomes a schema read plus several filtered queries. PasteSheet reads the sheet once, caches it, and serves the rest from cache, so the tenth query costs Google nothing.\n\n---\n\n## Pricing\n\nThe free tier runs **3 endpoints, 2,000 requests/month, 500 rows, 1 tab per sheet** — no credit card. Paid plans raise the caps and add private endpoints, custom cache TTL, and full-text search.\n\nSee [pastesheet.com/pricing](https://pastesheet.com/pricing).\n\n---\n\n## Links\n\n- [PasteSheet](https://pastesheet.com)\n- [Connect Google Sheets to Claude](https://pastesheet.com/guides/google-sheets-mcp-claude)\n- [Connect Google Sheets to ChatGPT](https://pastesheet.com/guides/google-sheets-mcp-chatgpt)\n- [Connect Google Sheets to Cursor](https://pastesheet.com/guides/google-sheets-mcp-cursor)\n- [Google Sheets MCP for Claude Code](https://pastesheet.com/guides/google-sheets-mcp-claude-code)\n- [All guides](https://pastesheet.com/guides)\n\nIssues and questions: open an issue here, or [get in touch](https://pastesheet.com/about).\n",
  "bytes": 4039,
  "sha": "44ccb1129f841ac57146527209b22a679edb12fafa380e7740640d97de46aca4",
  "repo_slug": "199ocero/google-sheets-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_com_pastesheet_google_sheets_50aa3795/readme"
}