vakharwalad23/google-mcp

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:
JSON configs
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 all task lists
- Create new task lists
- Delete existing task lists
- Set default task list
- List tasks with filters
- View task details
- Create tasks with title, notes, and due dates
- Update task properties
- Mark tasks as complete
- Delete tasks
- **TODO Plans**:
- Google Contacts: Search and manage contacts.
- And Many More...
You can chain commands for workflows, e.g.:
"List my unread emails, draft a reply to the latest one, and schedule a follow-up meeting tomorrow at 2 PM."
Hosted deployment
A hosted deployment is available on Fronteir AI.
OAuth Token Management
The server includes built-in OAuth token management to handle expired access tokens gracefully:
- **Automatic Token Refresh**: When access tokens expire, you can refresh them without going through the full OAuth flow again