vakharwalad23/google-mcp

Overview

A TypeScript-based collection of Google-native tools (Gmail, Calendar, etc.) exposed through the Model Context Protocol (MCP). It allows AI agents to interact with Google services via standardized MCP interfaces.

Best for

Best for
Developers building MCP-based AI agents that need direct access to Google Workspace tools

Use cases

• Automating email management and calendar scheduling through AI agents
• Integrating Google Workspace data into MCP-compatible workflows
• Building custom AI assistants that can read and send Gmail messages

How to use

Install

bun run dev

Tested with

Cursor, Claude Desktop

Example client config

{\n  "mcpServers": {\n    "google-mcp": {\n      "command": "bunx",\n      "args": ["--no-cache", "google-mcp@latest"],\n      "env": {\n        "GOOGLE_OAUTH_CLIENT_ID": "<YOUR_CLIENT_ID>",\n        "GOOGLE_OAUTH_CLIENT_SECRET": "<YOUR_CLIENT_SECRET>",\n        "GOOGLE_OAUTH_TOKEN_PATH": "<PATH_TO_STORE_TOKENS> CAN_BE_ANYWHERE_ON_YOUR_SYSTEM",\n        "GOOGLE_CLIENT_EMAIL": "<YOUR_SERVICE_ACCOUNT_EMAIL>",\n        "GOOGLE_PRIVATE_KEY": "<YOUR_SERVICE_ACCOUNT_PRIVATE_KEY>",\n        "GMAIL_USER_TO_IMPERSONATE": "<USER_TO_IMPERSONATE>"\n      }\n    }\n  }\n}

Notes

A TypeScript-based collection of Google-native tools (Gmail, Calendar, etc.) exposed through the Model Context Protocol (MCP). It allows AI agents to interact with Google services via standardized MCP interfaces.

18 stars on GitHub. Last updated 2026-03-30. Licensed MIT.

Use cases

• Automating email management and calendar scheduling through AI agents
• Integrating Google Workspace data into MCP-compatible workflows
• Building custom AI assistants that can read and send Gmail messages

Pros

• Leverages MCP for standardized agent-to-service communication
• Covers multiple Google services in a single package
• Lightweight TypeScript implementation

Cons

• Low community adoption (18 stars) suggests limited testing or support
• Requires Google API credentials and OAuth setup
• Narrowly focused on Google services only

Indexed from awesome-mcp-servers-punkpeye and enriched against its public facts.