Google Tools Server

🚀 Business Value & Use Cases

This MCP (Model Context Protocol) server is designed for businesses that already have existing authentication systems and want to seamlessly integrate Google Workspace capabilities into their AI agents and applications.

🎯 Perfect For:

• Enterprise AI Assistants - Add Google Workspace functionality to existing AI chatbots
• Business Automation - Integrate Gmail, Drive, Docs, Tasks, and Calendar into workflow automation
• Customer Support Systems - Enable AI agents to manage emails, documents, and tasks
• Productivity Applications - Add Google Workspace tools to existing business applications
• CRM Integration - Connect Google services to existing customer relationship management systems

💼 Business Benefits:

• Zero Integration Overhead - Works with existing OAuth systems
• Unified Google Workspace Access - Single interface for 5 Google services
• AI-Ready Architecture - Designed specifically for AI agent integration
• Enterprise Security - OAuth 2.0 with granular permission scopes
• Rapid Deployment - Get Google Workspace tools in your AI agent within hours

🔧 Technical Advantages:

• 25+ Google Workspace Operations - Complete coverage of Gmail, Drive, Docs, Tasks, Calendar
• MCP Protocol Compliance - Standard interface for AI agent integration
• Modular Architecture - Easy to extend and customize for business needs
• Error Handling - Robust error management for production environments
• Documentation - Comprehensive API documentation and examples

---

OAuth Scopes

You can get the required scopes from the Google OAuth 2.0 Playground:

Essential Scopes (Minimum Required):

https://www.googleapis.com/auth/gmail.modify
https://www.googleapis.com/auth/drive.readonly
https://www.googleapis.com/auth/calendar

Complete Scope List:

📧 Gmail API Scopes:

• https://www.googleapis.com/auth/gmail.modify - Read, compose, send, and permanently delete messages
• https://www.googleapis.com/auth/gmail.readonly - Read-only access to Gmail messages and settings
• https://www.googleapis.com/auth/gmail.send - Send messages on behalf of the user
• https://www.googleapis.com/auth/gmail.compose - Compose and send messages

📁 Google Drive API Scopes:

• https://www.googleapis.com/auth/drive - Full access to Google Drive files
• https://www.googleapis.com/auth/drive.readonly - Read-only access to Google Drive files
• https://www.googleapis.com/auth/drive.metadata - Access to file metadata

📅 Google Calendar API Scopes:

• https://www.googleapis.com/auth/calendar - Full access to Google Calendar
• https://www.googleapis.com/auth/calendar.readonly - Read-only access to Google Calendar
• https://www.googleapis.com/auth/calendar.events - Access to calendar events

📄 Google Docs API Scopes:

• https://www.googleapis.com/auth/documents - Full access to Google Docs
• https://www.googleapis.com/auth/documents.readonly - Read-only access to Google Docs

✅ Google Tasks API Scopes:

• https://www.googleapis.com/auth/tasks - Full access to Google Tasks
• https://www.googleapis.com/auth/tasks.readonly - Read-only access to Google Tasks

OAuth 2.0 Playground Configuration:

Copy this scope list for testing:

https://www.googleapis.com/auth/gmail.modify,https://www.googleapis.com/auth/drive.readonly,https://www.googleapis.com/auth/calendar,https://www.googleapis.com/auth/documents,https://www.googleapis.com/auth/tasks

Available Tools

📧 Gmail Tools (gmail.py)

• search_gmail_messages - Search messages with query syntax
• list_gmail_messages - List messages with filtering
• list_gmail_labels - List all Gmail labels
• create_gmail_label - Create new labels with colors
• get_gmail_message_content - Get full message content
• send_gmail_message - Send new messages
• draft_gmail_message - Create message drafts

📁 Google Drive Tools (gdrive.py)

• search_drive_files - Search files with query syntax
• get_drive_file_content - Read file content (Office formats)
• list_drive_items - List folder contents
• create_drive_file - Create files or fetch from URLs

📅 Google Calendar Tools (gcalender.py)

• list_calendar_events - List upcoming events
• create_calendar_event - Create new calendar events

📄 Google Docs Tools (docs_tools.py)

Core Functions:

• get_doc_content - Extract document text
• create_doc - Create new documents
• modify_doc_text - Modify document text

Extended Functions:

• search_docs - Find documents by name
• find_and_replace_doc - Find and replace text
• list_docs_in_folder - List docs in folder
• insert_doc_elements - Add tables, lists, page breaks
• export_doc_to_pdf - Export document to PDF

Complete Functions:

• insert_doc_image - Insert images from Drive/URLs
• update_doc_headers_footers - Modify headers and footers
• batch_update_doc - Execute multiple operations
• inspect_doc_structure - Analyze document structure
• create_table_with_data - Create data tables
• debug_table_structure - Debug table issues

Document Comments:

• read_document_comments - Read document comments
• reply_document_comments - Reply to document comments
• create_document_comments - Create document comments
• resolve_document_comments - Resolve document comments

✅ Google Tasks Tools (tasks_tools.py)

Core Functions:

• list_tasks - List tasks with filtering
• get_task - Retrieve task details
• create_task - Create tasks with hierarchy
• update_task - Modify task properties

Extended Functions:

• delete_task - Remove tasks

Complete Functions:

• move_task - Reposition tasks
• clear_completed_tasks - Hide completed tasks

Task List Management:

• list_task_lists - List task lists
• get_task_list - Get task list details
• create_task_list - Create task list
• update_task_list - Update task list
• delete_task_list - Delete task list

🔗 Integration with Existing Business Systems

For Businesses with Existing Authentication:

This MCP server is designed to work seamlessly with your existing OAuth infrastructure:

• Leverage Existing OAuth Tokens - No need to rebuild authentication
• Minimal Code Changes - Drop-in integration with existing AI agents
• Standard MCP Protocol - Works with any MCP-compatible AI system
• Scalable Architecture - Handles multiple users and concurrent requests

Integration Examples:

Customer Support AI Agent:

# Your existing AI agent can now:
- Search customer emails in Gmail
- Create support tickets in Google Tasks
- Generate documentation in Google Docs
- Schedule follow-up meetings in Google Calendar

Business Automation:

# Automate workflows with:
- Email processing and response
- Document generation and sharing
- Task assignment and tracking
- Calendar management and scheduling

CRM Integration:

# Connect Google Workspace to your CRM:
- Sync customer communications
- Generate reports from Google Docs
- Track customer interactions
- Manage sales pipeline tasks

Quick Integration Steps:

1. Deploy the MCP Server - Run on your infrastructure
2. Configure OAuth - Use your existing Google OAuth setup
3. Connect AI Agent - Point your AI agent to the MCP server
4. Start Using - Your AI agent now has Google Workspace capabilities