Google Workspace’s remote MCP servers are part of its Workspace Developer Preview Program. You can configure Claude Code to connect to a selected service over HTTP and authenticate interactively, but Google’s published Claude-specific steps cover Claude.ai and Claude Desktop—not Claude Code as a tested client. Treat the CLI setup below as a practical integration path, and confirm that OAuth completes for your account and endpoint.
What you need before configuring the connection
- Access to the Google Workspace Developer Preview Program.
- A Google Cloud project where you can enable APIs and MCP services.
- Claude Code installed and available in an interactive terminal.
- The Google Cloud CLI (
gcloud) if you are following Google’s command-line setup steps.
Google documents its Workspace MCP servers for general MCP clients using OAuth 2.0 and Streamable HTTP. Claude Code supports remote HTTP MCP servers and interactive OAuth, but Google’s page does not explicitly list Claude Code as a tested client. Google’s instructions for Claude.ai and Claude Desktop include a Claude callback URI; do not copy that URI into Claude Code’s CLI configuration unless the applicable client flow specifically calls for it. See Google’s Workspace MCP setup guide and Claude Code’s MCP documentation.
As an Amazon Associate I earn from qualifying purchases.
Choose the Workspace services you actually need
Google provides a separate remote endpoint for each Workspace product. Add only the services required for your workflow, and enable the matching APIs and MCP services in the Google Cloud project.
| Workspace service | Remote MCP endpoint |
|---|---|
| Gmail | https://gmailmcp.googleapis.com/mcp/v1 |
| Google Drive | https://drivemcp.googleapis.com/mcp/v1 |
| Google Docs | https://docsmcp.googleapis.com/mcp/v1 |
| Google Sheets | https://sheetsmcp.googleapis.com/mcp/v1 |
| Google Slides | https://slidesmcp.googleapis.com/mcp/v1 |
| Google Calendar | https://calendarmcp.googleapis.com/mcp/v1 |
| Google Chat | https://chatmcp.googleapis.com/mcp/v1 |
| People API | https://people.googleapis.com/mcp/v1 |
For the selected products, enable the corresponding standard API and MCP API in Google Cloud: Gmail, Drive, Docs, Sheets, Slides, Calendar, Chat, or People. Google also calls for a Chat app configuration when using the Chat MCP server.
Configure Google OAuth for the selected tasks
- In Google Cloud, open the project you will use for the integration and configure its consent screen in Google Auth Platform.
- Enable only the Workspace APIs and MCP services corresponding to the endpoints you selected.
- Choose the OAuth scopes needed for the operations you plan to perform. Examples in Google’s guide include Gmail read access (
gmail.readonly) or draft creation (gmail.compose); Drive read access (drive.readonly) or file access (drive.file); Docs and Sheets read or edit scopes; Calendar list, free/busy, and event-read scopes; Chat read or message-creation scopes; and People directory, profile, or contacts read scopes. - Create and configure the OAuth client as directed by Google’s setup instructions. The scopes you request define what the integration can access or do; avoid requesting broader access than the task requires.
Google’s exact scope choices are product- and task-specific. Use its official setup guide for the scope list and applicable client setup. Do not assume a callback URI documented for Claude.ai or Claude Desktop is correct for Claude Code.
Add an endpoint in Claude Code
Claude Code recommends HTTP transport for remote MCP servers. To add Gmail for the current user, run:
Rank #2
- Ultra-Compact FIDO2 Security Key - Plug-and-stay or carry on a keychain. This USB-A hardware security key offers portable, always-on protection for desktop and mobile use. (Item Size: 0.75 X 0.74 IN x 0.25 IN)
- USB-A Hardware Key for All Devices - Works with USB-A ports on PC, Mac, Android, and other laptop/notebook device. Enables secure, cross-platform login with FIDO2.0 passkey support.
- FIDO Certified Security Key - Meets FIDO and FIDO2 standards. Works with Google, Microsoft, GitHub, Dropbox, and more. Please check service compatibility before purchase.
- Passwordless Login with Passkey - Supports passkey login via WebAuthn and CTAP2. Enjoy password-free sign-ins where supported. Not all websites or services currently support passkeys.
- Advanced Multi-Factor Authentication - Offers 200 FIDO2 passkey slots and 50 OATH-TOTP slots. Strong, flexible 2FA/MFA support across various apps and authentication platforms.
claude mcp add --transport http --scope user gmail https://gmailmcp.googleapis.com/mcp/v1For another product, replace gmail with a server name of your choice and substitute that product’s endpoint from the table. The user scope makes the server available across projects for that user.
What’s actually slowing this PC down?
Pick the symptom - the matching free tool is one click away.
If the configuration should be shared with a project, use Claude Code’s project scope instead and follow its approval prompt in an interactive session. Project-scoped server configuration is stored in the project’s .mcp.json. Choose scope deliberately: user scope is personal and reusable across projects; project scope is appropriate when a team needs a shared configuration.
Rank #3
- Security Key : Protect your online accounts against unauthorized access by using FIDO2 and U2F authentication with T110. It's the world's most protective security key that works with windows, Mac OS, Linux as well as Chrome, Firefox, Edge and many other major browsers.
- Certified with the new FIDO2 standard, T110 provides the benefit of fast login and strong protection against phishing, account takeover as well as many other online attactks.
- Works with : Bank of America, Github, Google, Microsoft, DUO, Twitter, Facebook, Dropbox, Apple, ebay, BINANCE, mor and more.
- Fits USB-A port : Insert the T110 security key into the USB-A port of each service and log in conveniently with one touch
- For the driver download and user guide, please visit TrustKey Solutions Home support page.
Authenticate and verify the server
- Start Claude Code in an interactive terminal and enter
/mcpto view configured servers and start the OAuth flow, or runclaude mcp login gmailfrom an interactive terminal. - Complete the browser-based sign-in and consent flow if the endpoint supports the client’s OAuth flow. Claude Code documents secure credential storage and automatic token refresh.
- Check the connection with
/mcp,claude mcp list, orclaude mcp get gmail. - Try a read-only operation first, such as searching Drive files, listing Calendar events, or reading a document.
- When testing a write capability, choose a reversible or reviewable action. For Gmail, creating a draft is safer than sending a message.
If authentication fails because the endpoint requires preconfigured OAuth client credentials or rejects dynamic client registration, use the endpoint’s applicable registration requirements. Do not substitute the callback URI for Claude.ai or Claude Desktop without confirmation. Google’s documentation describes OAuth 2.0 for its servers, while the exact completion of the Claude Code flow should be verified in the account and deployment being configured.
Independent reader supportYour contribution helps us test, update, and keep practical guides available for everyone.Match server access to the work you intend to do
The services expose different capabilities; access is not necessarily read-only. Google’s examples include:
Rank #4
- Tamper Resistant Star Key Set Crafted with premium chrome vanadium steel, and each star tool folds neatly into the handle for quick, easy access.
- Details - The handle is engraved with size for quick identification with drilled tips to allow use.
- Portable - Keys fold compact for easy storage, Drilled tips allow use on tamper resistant security screws.
- Size:Full Size T-6, T-7, T-8, T-9, T-10, T-15 T-20, T-25, T-27 and T-30.
- And with 10 total star sizes able to match nearly all standard tamper resistant security screws on the market.
- Gmail: search threads and create drafts.
- Drive: search and read files, and create files.
- Docs: read and update documents.
- Sheets: read and update values or formulas.
- Slides: read and update presentations.
- Calendar: list and search events, and create, update, or delete events.
- Chat: search and send messages.
- People API: search profiles or contacts.
Before enabling a service, identify the needed product, whether the intended action only reads data or changes it, and the corresponding OAuth scopes. A server connection should not be treated as proof that every tool or operation is appropriate for every user.
The Tool Desk
Outbyte Driver Updater FREEFix the driver behind crashes, sound loss and screen glitchesFind Drivers →Outbyte PC Repair FREERepair Windows errors before they cause bigger problemsFix Now →Reduce risk when Claude Code can access Workspace data
Google warns that Workspace MCP clients can read, modify, and delete data. It also cautions that untrusted emails, documents, and other external content may contain hidden instructions intended to manipulate an AI session. Claude Code likewise advises users to trust the MCP servers they connect and notes prompt-injection risk from retrieved content.
Quick Recap
- Use only trusted MCP servers and enable only the Workspace products needed.
- Request the narrowest scopes suitable for the task.
- Review proposed actions before they change or send Workspace data, particularly deletion, updates, and messages.
- Be cautious when asking Claude Code to act on content from unknown senders or documents.
- For a project-scoped server, review the project’s
.mcp.jsonand approve the server only if you trust its configuration.
Product prices and availability are accurate as of the date/time indicated and are subject to change. Any price and availability information displayed on Amazon at the time of purchase will apply.
