MarkusPfundstein/mcp-gsuite

Free

Gmail 和 Google Calendar 集成。

FreeFree tier

Type

Open Source

Visit Website GitHub (40 stars)

About MarkusPfundstein/mcp-gsuite

mcp-gsuite is an open-source MCP (Model Context Protocol) server that enables AI assistants like Claude to interact directly with Google Gmail and Google Calendar. It provides a comprehensive set of tools for email management—including searching messages with flexible filters (unread, sender, date range, attachments), retrieving full email content, creating and deleting drafts, replying to emails (send or save as draft), fetching multiple emails by ID, and saving attachments locally. For calendar integration, it supports managing multiple calendars, querying events within time ranges, creating events with title, start/end times, location, description, attendees, custom timezone, and notification preferences, as well as deleting events. Authentication is handled via OAuth 2.0, and the server supports multiple Google accounts, making it suitable for personal and professional use.

Key Features

Multiple Google accounts support

Gmail: get user info, query emails with flexible search (unread, sender, date range, attachments), retrieve full email content, create/delete drafts, reply to emails, fetch multiple emails by IDs, save attachments locally

Calendar: manage multiple calendars, get events within time ranges, create events with title, start/end times, location, description, attendees, timezone, notification preferences, delete events

OAuth 2.0 authentication for Google Workspace APIs

Example prompts for common use cases like summarizing emails, replying, planning events

Pros & Cons

Pros

Seamless integration with MCP-compatible AI assistants (e.g., Claude)
Comprehensive email and calendar operations covering common workflows
Supports multiple Google accounts with separate calendar views
Open source and free to use
Easy installation via Smithery or manual setup

Cons

Requires manual OAuth 2.0 setup via Google Cloud Console (client ID/secret)
Limited to Gmail and Google Calendar; no other Google Workspace apps
No built-in contact management or Google Drive integration
Setup may be complex for non-technical users

Best For

Summarizing unread emails or emails from specific sendersDrafting replies to existing email threadsChecking daily or weekly agendas across multiple calendarsScheduling events with attendees and time suggestionsSaving email attachments to local systemSearching emails by date range, sender, or attachment presence

FAQ

Does mcp-gsuite support multiple Google accounts?

Yes, the server supports multiple Google accounts. You can configure them in the .accounts.json file and the AI assistant can interact with each account separately.

How do I set up authentication?

You need to create OAuth 2.0 credentials in Google Cloud Console, enable Gmail API and Calendar API, then create a .gauth.json file with your client ID, secret, and redirect URIs (e.g., http://localhost:4100/code).

Can I use mcp-gsuite with Claude Desktop?

Yes, you can install it easily via Smithery using the command: npx -y @smithery/cli install mcp-gsuite --client claude.

What calendars can I manage?

You can manage any Google Calendar associated with the configured accounts, including personal and family calendars, as long as the access token has the required scopes.