mcp-gsuite MCP server

What is mcp-gsuite?

mcp-gsuite is an MCP server that enables AI assistants to interact with Google products, specifically Gmail and Google Calendar. It supports multiple Google accounts and provides tools for reading, searching, sending emails, and managing calendar events. It is designed for users who want to control their Gmail and Calendar through natural language prompts in MCP clients like Claude Desktop.

How to use mcp-gsuite?

Install via Smithery with npx -y @smithery/cli install mcp-gsuite --client claude, or run locally using uv after cloning the repository. Configure OAuth2 by creating a .gauth.json file and a .accounts.json file in your working directory. Then add the server to your Claude Desktop configuration (e.g., claude_desktop_config.json). Optionally pass custom paths for accounts file and credentials directory via --accounts-file and --credentials-dir flags.

Key features of mcp-gsuite

• Supports multiple Google accounts with one configuration.
• Search and retrieve Gmail messages with flexible criteria.
• Create, delete, and reply to email drafts.
• Save multiple email attachments to local system.
• Manage multiple Google Calendars.
• Create calendar events with attendees, location, and timezone.
• Delete calendar events.

Use cases of mcp-gsuite

• Ask your AI assistant to summarize unread emails or find messages from a specific sender.
• Draft and save replies to emails without leaving your AI chat.
• Check your daily or weekly agenda across multiple calendars.
• Schedule events with attendees and let the AI suggest time slots.
• Automate recurring email and calendar tasks with natural language commands.

FAQ from mcp-gsuite

How does authentication work?

Google Workspace APIs require OAuth2. You must create OAuth2 credentials in the Google Cloud Console, enable Gmail and Calendar APIs, and place the client JSON in a .gauth.json file. On first use for each account, a browser opens for authorization; the resulting token is stored locally.

What configuration files are needed?

You need .gauth.json (OAuth client config) and .accounts.json (list of emails with optional extra info for the AI). Custom paths can be specified via --gauth-file, --accounts-file, and --credentials-dir flags.

Where are OAuth tokens stored?

After successful login, credentials are saved as .oauth.{email}.json in the current working directory (or a custom directory set with --credentials-dir). Refresh tokens are used for future access.

Can I use multiple Google accounts?

Yes. The .accounts.json file can list several accounts, each with a label and optional extra information (e.g., “Contains Family Calendar”). The AI will use the account specified in the prompt.

Does it support both sending and drafts?

Yes. For Gmail, you can create replies that are sent immediately or saved as drafts. Draft emails can also be created, retrieved, and deleted.