Quickstart
Connect your first AI agent to Google Sheets in under 5 minutes.
Prerequisites
- A Google account with at least one spreadsheet in Drive
- An interactive MCP client such as Claude, ChatGPT, or Cursor
Steps
-
Create your Sheetbase account. Go to sheetbase.flonest.app and choose Continue with Google. Google is the only Sheetbase sign-in method.
-
Connect Google Workspace. Signing in identifies your Sheetbase account. Spreadsheet access is a separate permission. If the dashboard says Google Workspace — Not connected, choose Connect Google Workspace and approve Sheets and Drive access. The status will change to Connected.
Note
Sheetbase requests
drive.readonly+drive.file— not full Drive access. It cannot read arbitrary Drive files outside the spreadsheets scope.
-
Add Sheetbase to Claude. Open Claude's custom connector form, name the connector
Sheetbase, and enter:https://sheetbase.flonest.app/api/mcpClaude opens Sheetbase's browser authorization flow. Sign in, review the request, and allow the connection.
See the full Claude Desktop guide for a step-by-step walkthrough.
-
Use another interactive client (alternative). In ChatGPT, Cursor, or another client that supports custom remote MCP servers, open its connector or MCP settings and add the same endpoint:
{ "mcpServers": { "sheetbase": { "url": "https://sheetbase.flonest.app/api/mcp" } } }The client should discover Sheetbase OAuth and open the browser authorization flow. See the full Cursor guide for Cursor-specific steps. Use a dashboard API key only for scripts, CI, or custom agents that cannot use OAuth.
-
Run your first command. In your connected client, try:
"List all my Google Sheets spreadsheets"
Sheetbase calls
list_spreadsheetsand returns your Drive file list. Then try:"Read the first 10 rows of Sheet1 in [paste a spreadsheetId]"
You now have a fully wired AI ↔ Google Sheets pipeline.
What's next?
- Authentication — OIDC vs API key — understand both paths.
- Tools Overview — Browse all 21 tools with AX selection guide.
- SQL in Sheets — Aggregate sheet data with Postgres SQL.