samayly.com is live. Hosted plans open soon. Join the waitlist →
Guide 0110 min5 min read

1. Google Cloud Setup

Create the OAuth credentials the MCP server uses to access your sheets as you.

⏱️ 10 minutes · Done once · Output: credentials.json

Create project

Enable Sheets + Drive APIs

Configure OAuth consent
(Google Auth Platform)

Create OAuth client
type: Desktop app

Download JSON
→ credentials.json


Which Google account?

Use the account that owns or can edit the sheet.

  • Personal Gmail: always works.
  • School / work account: may work. Some admins block project or OAuth client creation. If you see an "organization policy" error at any step, switch to a personal Gmail and share the sheet with it.

1Create a project

  1. Open https://console.cloud.google.com
  2. Click the project picker at the top → New Project
  3. Name: sheets-mcp → Create
  4. Wait ~30 seconds, then select the new project in the picker

✅ The top bar shows sheets-mcp.

2Enable two APIs

  1. Search bar → Google Sheets API → Enable
  2. Search bar → Google Drive API → Enable

✅ Both show "API enabled".

Newer consoles call this Google Auth Platform.

  1. Menu → APIs & Services → OAuth consent screen (or Google Auth Platform → Get started)
  2. App name: Sheets MCP · Support email: your email → Next
  3. Audience: - Internal if available (Workspace accounts). Simplest. - External otherwise (personal Gmail).
  4. Contact email: your email → Next → accept the policy → Create

If you chose External, add yourself as a test user: - Audience → Test users → + Add users → your email → Save

4Create the OAuth client

  1. APIs & Services → Credentials (or Google Auth Platform → Clients)
  2. + Create → OAuth client ID
  3. Application type: Desktop app ⚠️ (not Web application)
  4. Name: sheets-mcp-client → Create
  5. Download JSON

The file downloads as client_secret_XXXX.apps.googleusercontent.com.json. Guide 2 moves and renames it.


What you have now

Item Where
Project sheets-mcp Google Cloud
Sheets + Drive APIs enabled Google Cloud
OAuth client (Desktop) Google Cloud
client_secret_*.json ~/Downloads

Treat the JSON as a secret. Never commit it. See Security.

➡️ Next: 2. Local MCP server

Questions or corrections: [email protected]