Google Toolbox

py-mcp-google-toolbox

An MCP server that provides AI assistants with powerful tools to interact with Google services, including Gmail, Google Calendar, Google Drive, and Google Search.

Overview

py-mcp-google-toolbox provides the following Google-related functionalities:

• Gmail operations (read, search, send, modify)
• Google Calendar management (events creation, listing, updating, deletion)
• Google Drive interactions (search, read files)
• Google Search integration (search web)

Table of Contents

• Prerequisites
• Installation
• Configure MCP Settings
• Tools Documentation
  • Gmail Tools
  • Calendar Tools
  • Drive Tools
  • Search Tools
• Development
• License

Prerequisites

1. Python: Install Python 3.12 or higher
2. Google Cloud Console Setup:
   • Go to Google Cloud Console
   • Create a new project or select an existing one
   • Enable the Service API:
     1. Go to "APIs & Services" > "Library"
     2. Search for and enable "Gmail API"
     3. Search for and enable "Google Calendar API"
     4. Search for and enable "Google Drive API"
     5. Search formand enable "Custom Search API"
   • Set up OAuth 2.0 credentials from GCP:
     1. Go to "APIs & Services" > "Credentials"
     2. Click "Create Credentials" > "OAuth client ID"
     3. Choose "Web application"
     4. Note down the Client ID and Client Secret
        • Client ID
        • Client Secret
     5. download secret json and rename to credentials.json
   • Generate an API key
3. Go to Custom Search Engine and get its ID

Installation

Git Clone

Configuration

1. Install UV package manager:

2. Create and activate virtual environment:

3. Install dependencies:

4. Get refresh token (if token is expired, you can run this)

This will:

• Open your browser for Google OAuth authentication
• Request the following permissions:
  • https://www.googleapis.com/auth/gmail.modify
  • https://www.googleapis.com/auth/calendar
  • https://www.googleapis.com/auth/gmail.send
  • https://www.googleapis.com/auth/gmail.readonly
  • https://www.googleapis.com/auth/drive
  • https://www.googleapis.com/auth/drive.file
  • https://www.googleapis.com/auth/drive.readonly
• Save the credentials to token.json
• Display the refresh token in the console

5. Environment variables:

6. copy credentials.json to project root folder (py-mcp-google-toolbox)

Using Docker

1. Build the Docker image:

2. Run the container:

Using Local

1. Run the server:

2. Run the MCP Inspector

Configure MCP Settings

Add the server configuration to your MCP settings file:

Claude desktop app

1. To install automatically via Smithery:

2. To install manually open ~/Library/Application Support/Claude/claude_desktop_config.json

Add this to the mcpServers object:

Cursor IDE

open ~/.cursor/mcp.json

Add this to the mcpServers object:

for Docker

Tools Documentation

Gmail Tools

• list_emails: Lists recent emails from Gmail inbox with filtering options
• search_emails: Performs advanced Gmail searches with detailed email content retrieval
• send_email: Composes and sends emails with support for CC, BCC recipients
• modify_email: Changes email states (read/unread, archived, trashed) by modifying labels

Calendar Tools

• list_events: Retrieves upcoming calendar events within specified time ranges
• create_event: Creates new calendar events with attendees, location, and description
• update_event: Modifies existing calendar events with flexible parameter updating
• delete_event: Removes calendar events by event ID

Drive Tools

• read_gdrive_file: Reads and retrieves content from Google Drive files
• search_gdrive: Searches Google Drive for files with customizable queries

Search Tools

• search_google: Performs Google searches and returns formatted results

Development

For local testing, you can use the included client script:

License

MIT License