Google Workspace Integration Platform (MCP)

This repository furnishes a set of native Google productivity mechanisms (e.g., Inbox, Schedule) engineered for the Model Context Protocol (MCP). It is optimized for seamless integration with sophisticated AI clients such as Claude or Cursor.

Expedited Setup

Invoke the following link for immediate deployment using the .mcpb package format:

Configuration Manifest (JSON)

{ "mcpServers": { "google-mcp": { "command": "bunx", "args": ["--no-cache", "google-mcp@latest"], "env": { // Authentication Mode Selection (Use OAuth OR Service Account, not both) // OAuth Path "GOOGLE_OAUTH_CLIENT_ID": "", "GOOGLE_OAUTH_CLIENT_SECRET": "", "GOOGLE_OAUTH_TOKEN_PATH": " CAN_BE_ANYWHERE_ON_YOUR_SYSTEM", // Service Account Path "GOOGLE_CLIENT_EMAIL": "", "GOOGLE_PRIVATE_KEY": "", "GMAIL_USER_TO_IMPERSONATE": "" } } } }

Version 1.1.0 Updates

🆕 Critical Enhancements

Comprehensive File Attachment Handling:
✉️ Capability to transmit electronic correspondence including supplementary documents sourced locally or from Google Drive.
📥 Utility for extracting all email attachments and persisting them to local file system directories.
🔄 Support for dual data origins: local file system references or Google Drive identifiers.
📁 Intelligent file processing: automatic determination of MIME type and sanitization of resulting filenames.

🔧 Refined Mail Operations

Versatile Attachment Sourcing: Attach documents from both local storage and Drive within a single outgoing message.
Filename Override: Option to specify custom names for attached resources.
Size Constraint Enforcement: Automatic checking against Gmail's 25MB transmission limit.
System-Agnostic Downloads: Automatic location detection for the Downloads directory across Windows, macOS, and Linux environments.
Overwrite Prevention: Automated renaming sequences implemented to avoid data loss during file saving.

📁 New & Improved Utilities

google_gmail_send_email: Now fully accommodates attachments originating from the local disk or Google Drive.
google_gmail_draft_email: Functionality extended to include attachments in saved draft messages.
google_gmail_download_attachments: Enhanced download utility capable of saving all attached files to a user-defined location.

Core Capabilities

Authorization Protocol (OAuth) Maintenance:
Seamless, background refreshing of invalidated access tokens.
In-place modification of tokens within the credential file, avoiding full re-login.
Support for full credential renewal with automated cleanup of obsolete tokens.
Guaranteed session persistence across prolonged operational periods.
Gmail Services:
Dispatch messages supporting multiple recipients (To, Cc, Bcc fields) and attached payloads from local storage or Drive.
Retrieve all message attachments to the local machine, optimized for cross-OS compatibility.
Query mailboxes using granular filters, labels, and result capping.
Access individual message content and metadata by unique identifier.
Management tools for applying, removing, or listing message labels.
Facilities for composing and purging draft messages.
Calendar Synchronization:
Retrieval of all associated calendars and assignment of a primary calendar.
Event creation specifying comprehensive details (subject, start/end timestamps, invitees, etc.).
Fetching of forward-looking appointments based on customized time parameters.
Modification or removal of existing schedule entries.
Availability checking to identify open time slots for meetings.
Drive File Management:
Filtering operations utilizing sophisticated search parameters.
Sorting capabilities based on last modification time or alternate metadata.
Control over the number of records returned.
Inspection of detailed file attributes and metadata.
Reading file content (supporting text, document formats, and spreadsheets).
Creation of new files populated with specified content.
Overwriting or updating extant file content.
Removal actions (move to trash or permanent erasure).
Sharing files with precise access permissions granted to specific users.
Tasks Management:
Display all existing task lists.
Provision for generating new task lists.
Removal of existing task lists.
Designation of a default task list.
Listing of tasks adhering to specified criteria.
Retrieval of individual task item specifics.
Task creation specifying title, auxiliary notes, and deadline.
Updating properties of existing tasks.
Marking tasks as accomplished.
Deleting specific tasks.
Future Capabilities (TODO):
Google Contacts: Comprehensive search and management of user contacts.
And numerous other functionalities...

You are empowered to sequence commands for complex automation sequences, for instance:

"Scan my unread correspondence, formulate a response to the most recent item, and propose a follow-up appointment for the subsequent day at 14:00 hours."

OAuth Credential Lifecycle Management

The server integrates internal mechanisms to gracefully handle expired authorization credentials:

Automatic Token Renewal: Ability to fetch new access tokens when the current ones expire, bypassing the complete authorization sequence.
Full Re-validation: Automated handling for scenarios where refresh tokens become invalid or have passed their expiry date.
Durable Storage: Renewed credentials are automatically written back to the designated token file path.
Session Resumption: All Google APIs are automatically re-initialized using the refreshed authentication material.

Token Refresh Procedure

Should you encounter authorization failures or wish to refresh credentials proactively, issue the following directive:

Refresh my Google OAuth tokens

This action initiates the following steps:

Utilizes the stored refresh token to acquire contemporary access tokens.
Persists the newly acquired credentials into the token file.
Re-initializes all integrated Google services with the updated authentication.
Reports the expiration timeframe of the newly obtained token.

Complete Credential Reset

In cases of invalid_grant errors or refresh token expiration, a complete fresh authentication can be triggered:

Re-authenticate my Google account

This automated routine executes:

Destruction of all existing tokens stored in the configuration file.
Initiation of an OAuth listener to capture the authorization callback.
Automatic browser launch for the user to grant fresh permissions.
Seamless saving of the newly generated token set.
Rebooting all services using the fresh credentials.

You will simply need to click 'Allow' in the browser interface; the remaining steps are fully autonomous!

Important Caveat: If a valid refresh token is absent, the system must revert to the initial, full OAuth authorization procedure.

Local Deployment Guide

Prerequisites:
Installation of the Bun runtime environment:

bash brew install oven-sh/bun/bun # For macOS/Linux users via Homebrew

Authorization Configuration:
Establish a new project within the Google Cloud Console.
Define OAuth 2.0 credentials (Client ID and Secret).
Select the 'Desktop application' type for credential creation.
If utilizing testing modes, ensure your user email is listed among permitted test users.
Verify that necessary APIs (Gmail, Calendar, Drive, etc.) are explicitly enabled for project use.
Client Configuration File Update: Modify your AI client's configuration file (e.g., claude_desktop_config.json):

{ "mcpServers": { "google-mcp": { "command": "bunx", "args": ["--no-cache", "google-mcp@latest"], "env": { // Use OAuth OR Service Account "GOOGLE_OAUTH_CLIENT_ID": "", "GOOGLE_OAUTH_CLIENT_SECRET": "", "GOOGLE_OAUTH_TOKEN_PATH": "", // Or Use Service Account "GOOGLE_CLIENT_EMAIL": "", "GOOGLE_PRIVATE_KEY": "", "GMAIL_USER_TO_IMPERSONATE": "" } } } }

Initial Authentication:
The first execution of the server component will automatically trigger a browser session for OAuth consent. Complete the authorization sequence; credentials will be securely stored at the location specified by GOOGLE_OAUTH_TOKEN_PATH.

Operational Examples

Instruct your AI assistant to invoke the google-mcp toolset:

Dispatch an email to jane.doe@example.com with the header "Meeting Notes" and body "These are the minutes from our discussion today."

Generate a list of my scheduled calendar appointments for the forthcoming 72 hours.

Schedule a new calendar entry named "Team Sync" for tomorrow at 10:00 AM, duration one hour.

Initiate the Google OAuth token refresh sequence.

Perform a complete re-authentication of my Google credentials.

Communication Transport Methods

This MCP server is equipped to utilize either standard input/output streams or HTTP endpoints, configured via environment variables:

Stdio Transport (Default Configuration)

bash

Default execution path using stdio

bun run dev

Explicit stdio invocation

MCP_TRANSPORT=stdio bun run index.ts

HTTP Transport (Streamable Web Interface)

bash

HTTP mode enabling Streamable HTTP communication

MCP_TRANSPORT=http bun run index.ts

HTTP mode on a custom port

MCP_TRANSPORT=http PORT=3000 bun run index.ts

When operating in HTTP mode, the server exposes the following endpoints:

GET /health - Status check, reporting active session count.
GET /mcp - Displays current session metadata and server operational status.
POST /mcp - Primary gateway for receiving MCP JSON-RPC requests.
DELETE /mcp - Endpoint for terminating an active session.

Session Handling for HTTP

The Streamable HTTP mode leverages the official MCP SDK for robust session control:

Automated Session Initiation: Secure, unique session identifiers are generated dynamically.
Real-time SSE Streaming: Full support for Server-Sent Events for instant data transmission.
JSON Fallback: Graceful reversion to traditional JSON responses if SSE capabilities are unavailable.
Security Measures: Integrated protective features suitable for production deployments.

HTTP Transport Configuration

Clients must be configured to point to the server URL for HTTP operation:

{ "mcpServers": { "google-mcp-http": { "url": "http://localhost:3000/mcp" } } }

Local Development Workflow

bash git clone https://github.com/vakharwalad23/google-mcp.git cd google-mcp bun install

Execute in stdio mode (default)

bun run dev:stdio

Execute in HTTP mode

bun run dev:http

We appreciate your utilization of the Google MCP Tooling! Should you encounter any issues or possess suggestions for improvement, please submit an issue or contribute directly to the repository.

Experiment freely with these utilities and enjoy the enhanced productivity!

WIKIPEDIA: Business management tools encapsulate all systems, applications, analytical solutions, and procedural frameworks utilized by organizations to navigate evolving markets, maintain competitive advantage, and elevate overall operational efficacy.

== General Survey == Tools are departmentalized across an enterprise, classifiable by functional aspect, such as those for planning, process governance, record-keeping, personnel management, decision support, and performance monitoring. A functional breakdown typically includes:

Tools for initial data ingestion and integrity verification across all units. Tools dedicated to oversight and refinement of organizational workflows. Tools focused on data aggregation and evidence-based strategic decision-making. Modern management tooling has undergone a profound metamorphosis in the last decade, driven by rapid technological progress, making the selection of optimal business instruments complex. This complexity stems from the constant pressure to reduce overhead, maximize revenue, deeply understand client requirements, and deliver products precisely as demanded. In this climate, leadership must adopt a strategic perspective on these tools, rather than merely adopting the newest available option. Over-reliance on unadapted tools often creates instability; thus, business management instruments must be meticulously chosen and then tailored to the specific organizational context.

== Prominent Instruments (2013 Survey) == A 2013 survey by Bain & Company mapped the global usage of business tools, reflecting regional needs against market conditions. The top ten instruments identified were:

Strategic planning frameworks Client relationship management systems (CRM) Personnel satisfaction measurement tools Comparative performance analysis (Benchmarking) Balanced scorecard methodology Core competency identification Outsourcing strategy management Organizational change programs Supply chain operational oversight Mission/Vision statement articulation Market segmentation analysis Total quality management (TQM)

== Business Software Applications == Software—a suite of computer programs—used by personnel to execute diverse corporate functions is termed business software (or enterprise application). These applications are designed to augment output, quantify performance metrics, and execute various company tasks with precision. The evolution proceeded from rudimentary Management Information Systems (MIS) to comprehensive Enterprise Resource Planning (ERP) solutions, later incorporating Customer Relationship Management (CRM), culminating in the current landscape of cloud-based business management platforms. While IT investment correlates with organizational success, value realization is critically dependent on two factors: the efficacy of system deployment and the judicious selection and adaptation of the chosen tools.

== Solutions for Small and Medium Enterprises (SMEs) == Tools tailored for SMEs are vital as they offer scalable methods to reduce operational friction...