Google MCP Tools

This is a collection of Google-native tools (e.g., Gmail, Calendar) for the MCP protocol, designed to integrate seamlessly with AI clients like Claude or Cursor.

Quick Install

Click below for one-click install with .mcpb:

{
  "mcpServers": {
    "google-mcp": {
      "command": "bunx",
      "args": ["--no-cache", "google-mcp@latest"],
      "env": {
        // Either can be used, but not both
        // Use OAuth
        "GOOGLE_OAUTH_CLIENT_ID": "<YOUR_CLIENT_ID>",
        "GOOGLE_OAUTH_CLIENT_SECRET": "<YOUR_CLIENT_SECRET>",
        "GOOGLE_OAUTH_TOKEN_PATH": "<PATH_TO_STORE_TOKENS> CAN_BE_ANYWHERE_ON_YOUR_SYSTEM",
        // Use Service Account
        "GOOGLE_CLIENT_EMAIL": "<YOUR_SERVICE_ACCOUNT_EMAIL>",
        "GOOGLE_PRIVATE_KEY": "<YOUR_SERVICE_ACCOUNT_PRIVATE_KEY>",
        "GMAIL_USER_TO_IMPERSONATE": "<USER_TO_IMPERSONATE>"
      }
    }
  }
}

What's New in v1.1.0

🆕 Major Features

• Complete Email Attachment Support:
  • ✉️ Send emails with attachments from local files or Google Drive
  • 📥 Download all email attachments to local storage
  • 🔄 Dual attachment sources: Local file paths or Google Drive file IDs
  • 📁 Smart file handling: Automatic MIME type detection and filename sanitization

🔧 Enhanced Email Capabilities

• Multi-source attachments: Attach files from local storage or Google Drive in the same email
• Custom filenames: Override original filenames for attachments
• File size validation: Automatic 25MB Gmail limit enforcement
• Cross-platform downloads: Auto-detection of Downloads folder on Windows, macOS, and Linux
• Conflict resolution: Automatic file renaming to prevent overwrites

📁 New & Enhanced Tools

• google_gmail_send_email: Now supports attachments from local files and Google Drive
• google_gmail_draft_email: Create drafts with attachments
• google_gmail_download_attachments: Download all email attachments with customizable path

Features

• OAuth Management:

  • Refresh expired access tokens automatically
  • Update tokens in the token file without re-authentication
  • Complete re-authentication with automated token cleanup
  • Maintain session continuity across long-running operations

• Gmail:

  • Send emails with multiple recipients (to, cc, bcc) and attachments from local files or Google Drive.
  • Download all email attachments to local storage with cross-platform support.
  • List emails with custom queries, labels, and result limits.
  • Read specific emails by ID with attachment information.
  • Manage labels (add, remove, list).
  • Draft and delete emails.

• Calendar:

  • List calendars and set a default calendar.
  • Create events with details (summary, start/end time, attendees, etc.).
  • List upcoming events with customizable filters.
  • Update or delete existing events.
  • Find free time slots for scheduling.

• Drive:

  • Filter with search queries
  • Sort by modification date or other criteria
  • Customize display count
  • View detailed file metadata
  • Read file content (text, docs, spreadsheets)
  • Create new files with specified content
  • Update existing files
  • Delete files (trash or permanent)
  • Share files with specific permissions

• Tasks:

... View full README on GitHub