gsuite-mcp-lane
Search Gmail messages by query, returning message IDs, thread IDs, and snippets.
Append rows of data to a specified Google Sheets spreadsheet and sheet.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@gsuite-mcp-lane Search Gmail for recent seller orders and append them to my sales sheet."
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
GSuite MCP Lane — Gmail search + Sheets append as MCP tools
Two scoped MCP tools that move seller-inbox rows from Gmail into Google Sheets without Zapier: gold_gmail_search + gold_sheets_append. BYOK Google OAuth, no hosted sync, no stored credentials.
Portfolio showcase extracted from private studio work. Derivative of MarkusPfundstein/mcp-gsuite (MIT, 489★) — original license preserved in THIRD_PARTY_NOTICES.md.
Scope: the tools return honest
config_neededstubs and wiring plans until Google OAuth is connected — no data is ever invented. Wiregoogleapiscalls to go fully live.
Tools
Tool | What it does |
| Search Gmail by query ( |
| Append |
All tools are gold_* prefixed — no collision with upstream mcp-gsuite. A guided 2-step (search then append) lives in src/moat.ts; the 2 granular tools are the primary contract.
Example (without auth — preview):
// gold_gmail_search { "query": "newer_than:7d", "max_results": 20 }
// → { "tool":"gold_gmail_search", "query":"newer_than:7d", "status":"config_needed", "hint":"Set GOOGLE_OAUTH_..." }
// gold_sheets_append { "spreadsheet_id":"1Bxi...","values":[["2026-08-22","order #123","$19"]]}Related MCP server: charity-gmail-mcp
Quickstart
npm install
npm run build
node dist/index.jsClaude Desktop (claude_desktop_config.json):
{
"mcpServers": {
"gsuite-mcp-lane": {
"command": "node",
"args": ["/absolute/path/to/gsuite-mcp-lane/dist/index.js"],
"env": {
"GOOGLE_OAUTH_CLIENT_ID": "xxx.apps.googleusercontent.com",
"GOOGLE_OAUTH_CLIENT_SECRET": "xxx",
"GOOGLE_OAUTH_REFRESH_TOKEN": "xxx"
}
}
}
}BYOK setup (Google OAuth — no hosted sync)
Google Cloud project → enable Gmail API + Google Sheets API.
Create OAuth 2.0 Client ID →
CLIENT_ID+CLIENT_SECRET.Generate a refresh token (offline access) →
REFRESH_TOKEN(or short-livedACCESS_TOKEN).
Var | Purpose |
| OAuth client ID |
| OAuth client secret |
| Long-lived refresh token (preferred) |
| Short-lived access token (alt) |
| Service-account JSON path (alt) |
Upstream attribution
MarkusPfundstein/mcp-gsuite— MIT — https://github.com/MarkusPfundstein/mcp-gsuite
Derivative code in src/ is original work. Upstream MIT preserved in THIRD_PARTY_NOTICES.md.
Stack
TypeScript · MCP SDK (stdio) · zod schemas · BYOK OAuth
Next steps
Drive/Calendar tools from the same upstream, write-path confirmations, Smithery registry listing.
License
MIT, Copyright 2026 Maxim Konovalov. See LICENSE.
Author
Maxim Konovalov — Haifa · MCP servers + AI pipelines. More lanes + private demos on call.
Available Tools
3 toolsgold_gmail_searchA
Gmail search (BYOK Google OAuth). Query like newer_than:7d seller/order/refund. Returns honest config_needed stub without auth — no data invented.
Inputs: query, max_results, include_body.
gold_setup_checkA
SETUP CHECK for GSuite MCP Lane — run this FIRST. Shows license tier, which API keys are set vs missing (names only, never values), and the exact next step.
Inputs: no named parameters.
gold_sheets_appendB
Google Sheets append rows (BYOK Google OAuth). Append [[col1,col2]] to spreadsheetId. No hosted sync.
Inputs: values (required), spreadsheet_id (required), range, sheet_name.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 3 tools
Each tool has a clearly distinct purpose: setup check, Gmail search, and Sheets append. There is no overlap or ambiguity between them.
All tools share a consistent gold_ prefix and use verb_noun naming (setup_check, gmail_search, sheets_append). Minor inconsistency: gmail_search and sheets_append are resource_action while setup_check is action_noun, but the pattern is still predictable.
Three tools is on the low end but reasonable for a narrowly scoped GSuite lane focused on setup, Gmail search, and Sheets append. It feels slightly thin but not inappropriate.
The server covers only a small slice of GSuite: setup check, Gmail search, and Sheets append. Obvious gaps include Gmail read/send, Sheets read/update, and any Drive or Calendar operations, so agents would hit dead ends for common workflows.
Related MCP Connectors
Permissioned access to Gmail, Drive and Calendar via the user's own Google account
Google Docs MCP Pack — read, create, and edit Google Docs via OAuth. Reuses the google_sheets…
Read and edit GA4, Search Console and Google Tag Manager from any MCP client. 29 tools.
Hosted MCP server with managed OAuth for 15+ toolkits: Google Workspace, Fitbit, Oura, Kalshi, etc.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceEnables interaction with Google Workspace (Drive, Docs, Sheets, Gmail) via MCP tools, using OAuth credentials stored locally or inline.-
- FlicenseNot gradedqualityDmaintenanceEnables accessing Gmail tools (search, read, draft) for a specific Google account via MCP, designed as a custom connector for Claude/Cowork to use alongside a different Google account.-
- FlicenseNot gradedqualityCmaintenanceIntegrates with the Gmail API to send and read emails through MCP tools using Google OAuth authentication.-
- AlicenseNot gradedqualityCmaintenanceEnables Gmail operations like listing, searching, sending emails, and managing labels via MCP tools.127 npmMIT