Log inSubmit server
Google MCP logo

Google MCP

by vakharwalad23

Connects AI clients to Gmail, Calendar, Drive, and Tasks with OAuth or service-account authentication.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install Google MCP

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "vakharwalad23-google-mcp": {
      "command": "bunx",
      "args": [
        "--no-cache",
        "google-mcp@latest"
      ],
      "env": {
        "GOOGLE_OAUTH_CLIENT_ID": "YOUR_VALUE_HERE",
        "GOOGLE_OAUTH_CLIENT_SECRET": "YOUR_VALUE_HERE",
        "GOOGLE_OAUTH_TOKEN_PATH": "YOUR_VALUE_HERE",
        "GOOGLE_CLIENT_EMAIL": "YOUR_VALUE_HERE",
        "GOOGLE_PRIVATE_KEY": "YOUR_VALUE_HERE",
        "GMAIL_USER_TO_IMPERSONATE": "YOUR_VALUE_HERE"
      }
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Values are written into the snippet above so you can paste it as is. They never leave your browser.

We couldn’t confirm it starts correctly

We ran the install command but it didn't respond within our test window — this can mean a slow first-time install rather than a real problem.

bunx --no-cache google-mcp@latest

Process exited before answering initialize.

This is an experimental automated check and can have false negatives — missing environment variables, a slow cold install, etc. It doesn’t necessarily mean something’s wrong. Last checked 13d ago.

Overview

vakharwalad23/google-mcp MCP server exposes Google Gmail, Calendar, Drive, and Tasks operations through MCP tools. It runs locally over stdio by default or through streamable HTTP, and supports OAuth credentials or a Google service account. Built-in token refresh and re-authentication help maintain access during longer sessions. Reach for it when an agent needs to read or modify Google data, manage email attachments, schedule events, or maintain task lists.

Use cases

  • Draft and send Gmail messages with Drive or local attachments
  • Schedule and update Google Calendar events
  • Search and modify Google Drive files
  • Create and complete Google Tasks

Key features

  • Gmail search, labels, drafts, sending, and attachments
  • Calendar event and free-time management
  • Drive file search, content access, sharing, and deletion
  • Google Tasks list and task management
  • Automatic OAuth token refresh and re-authentication
  • Stdio and streamable HTTP transports

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked 1d ago

Recent health check succeeded.

7/8 checks healthy over the last 79d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 11d ago via OSV.dev · google-mcp@latest (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars21Stargazers on the source repository.
npm downloads189Package downloads in the last 30 days.
Last commit7mo agoMost recent push to the default branch.
Install checkInconclusiveDidn't respond in our test window — often a slow first install.
Directory activity1 viewsConfig copies, upvotes, and views on AllMCPs.

How Google MCP works

What vakharwalad23/google-mcp does

The vakharwalad23/google-mcp MCP server gives MCP-compatible AI clients access to several Google services. Its Gmail tools can search messages, read email details, manage labels, create drafts, send messages, delete drafts, and handle attachments. Attachments can come from local paths or Google Drive file IDs, and downloaded files can be saved locally.

Calendar tools cover calendar discovery, default-calendar selection, event creation, event listing, event updates and deletion, and free-time searches. Drive tools support filtered and sorted searches, metadata inspection, reading content from supported text-based Google files, file creation and updates, deletion, and permission-based sharing. Tasks tools manage task lists and individual tasks, including titles, notes, due dates, completion state, updates, and deletion.

How it works

The server exposes these Google operations as MCP tools for an AI client. It supports stdio transport as the default and can also run with streamable HTTP. HTTP mode provides health, session information, MCP request, and session termination endpoints, with automatic session handling through the MCP SDK.

Authentication can use either OAuth credentials or a Google service account. OAuth uses a client ID, client secret, and a token-file path. Service-account operation uses the service-account email, private key, and an impersonated Gmail user. The README instructs operators not to configure both authentication methods at once.

OAuth access tokens are refreshed when needed, and refreshed credentials are written to the configured token file. If a refresh token is no longer valid, the server can remove the old tokens, start a browser-based authorization flow, save replacement credentials, and reinitialize Google services.

Setup and configuration

To run vakharwalad23/google-mcp locally, install Bun and create a Google Cloud project. Configure OAuth 2.0 credentials as a desktop application, add test users when using test mode, and enable API access for the Google services you intend to use.

A client can launch the package with bunx --no-cache google-mcp@latest. For OAuth, set GOOGLE_OAUTH_CLIENT_ID, GOOGLE_OAUTH_CLIENT_SECRET, and GOOGLE_OAUTH_TOKEN_PATH. For service-account authentication, set GOOGLE_CLIENT_EMAIL, GOOGLE_PRIVATE_KEY, and GMAIL_USER_TO_IMPERSONATE. On first OAuth use, a browser authorization flow saves tokens to the configured path.

Set MCP_TRANSPORT=http to use HTTP rather than stdio, and optionally set PORT to choose the listening port. The README also provides a one-click .mcpb package for Claude MCPB installation and identifies a hosted deployment through Fronteir AI.

Tools and capabilities

  • Search Gmail with queries, labels, and result limits.
  • Send or draft messages to multiple recipients, including CC and BCC, with local or Drive attachments.
  • Enforce Gmail’s 25 MB attachment limit and download attachments with conflict-safe filenames.
  • Create, list, update, delete, and search Calendar events, including free-time lookups.
  • Find, read, create, update, share, and delete Drive files.
  • Create and maintain Google task lists and tasks.
  • Refresh OAuth credentials or start a complete re-authentication flow.

Limitations and notes

Google API access must be enabled for the services that the client will use. Service-account usage requires an impersonated Gmail user, while OAuth requires an initial browser authorization and a writable token-file location. The repository describes Google Contacts and additional capabilities as future plans rather than current documented tools.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Google MCP

vakharwalad23/google-mcp is an MCP server that connects AI clients to Google services through Gmail, Calendar, Drive, and Tasks tools. It supports email, events, files, and task operations, plus OAuth token refresh and re-authentication. It runs over stdio or streamable HTTP for compatible MCP clients.

Install Bun, configure Google Cloud credentials, and add a client entry that runs `bunx --no-cache google-mcp@latest`. Set either the OAuth variables or the service-account variables, then authorize in a browser when using OAuth. A `.mcpb` package is also available for Claude MCPB.

Configure it as an MCP server using the provided command and environment variables. The server supports stdio by default and can also be configured to use streamable HTTP.

It refreshes expired access tokens using the stored refresh token and saves the updated credentials to the configured token file. You can ask the connected AI client to refresh Google OAuth tokens. If the refresh token is invalid, use the re-authentication flow to authorize again.

Yes, it can send Gmail messages with multiple attachments sourced from local files or Google Drive file IDs. It also supports drafts with attachments and downloading email attachments. The server checks Gmail’s documented 25 MB attachment limit and can use custom filenames.

Related MCP servers

All in Workplace & Productivity All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewGoogle MCP AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/vakharwalad23-google-mcp?style=directory)](https://allmcps.com/mcp/vakharwalad23-google-mcp)
HTML Embed
<a href="https://allmcps.com/mcp/vakharwalad23-google-mcp"><img src="https://allmcps.com/api/badge/vakharwalad23-google-mcp?style=directory" alt="Google MCP on AllMCPs" /></a>