py-mcp-google-toolbox: Unleashing the Power of Google Services for AI Agents

In the rapidly evolving landscape of Artificial Intelligence, the ability for AI agents to seamlessly interact with real-world data and services is paramount. The py-mcp-google-toolbox emerges as a crucial tool, providing a robust and versatile interface between AI agents and the extensive suite of Google services. This MCP (Model Context Protocol) server empowers AI assistants with the capability to access, process, and utilize information from Gmail, Google Calendar, Google Drive, and Google Search, opening up a plethora of possibilities for automation, intelligent decision-making, and enhanced user experiences.

What is an MCP Server and Why is it Important?

Before diving deeper, let’s clarify the role of an MCP Server. MCP, or Model Context Protocol, is an open standard designed to streamline how applications provide context to Large Language Models (LLMs). An MCP server, like py-mcp-google-toolbox, acts as a bridge, enabling AI models to access and interact with external data sources and tools. This eliminates the need for AI models to be isolated within their own knowledge silos, fostering dynamic, context-aware interactions.

The importance of MCP servers stems from the fact that LLMs, while powerful, are only as good as the data they have access to. By connecting to external resources via MCP, AI agents can:

• Access Real-Time Information: Retrieve the latest data from various sources, ensuring informed decision-making.
• Perform Actions: Execute tasks in the real world, such as sending emails, scheduling appointments, or managing files.
• Personalize Interactions: Tailor responses and actions based on user context and preferences.
• Automate Complex Workflows: String together multiple actions across different services to achieve complex goals.

Use Cases: Transforming Industries with Google-Powered AI Agents

The py-mcp-google-toolbox unlocks a vast array of use cases across various industries. Here are just a few examples:

• Customer Service: An AI agent can analyze customer emails in Gmail to understand their needs, schedule follow-up calls in Google Calendar, and search Google Drive for relevant documentation to provide accurate and timely support.
• Sales & Marketing: AI agents can automate lead generation by searching Google for potential customers, sending personalized emails via Gmail, and scheduling product demos in Google Calendar.
• Project Management: AI agents can monitor project progress by analyzing emails and documents in Google Drive, scheduling team meetings in Google Calendar, and assigning tasks based on priorities.
• Personal Productivity: An AI assistant can manage your schedule by creating events, sending reminders, and automatically rescheduling appointments based on your availability.
• Research & Development: AI agents can conduct comprehensive research by searching Google for relevant information, analyzing research papers in Google Drive, and summarizing key findings.

Key Features: A Deep Dive into Google Service Integration

The py-mcp-google-toolbox offers a comprehensive set of tools for interacting with Google services, including:

• Gmail Tools:
  • list_emails: Retrieve a list of recent emails from your Gmail inbox, with options to filter by sender, subject, or date.
  • search_emails: Perform advanced searches across your Gmail archive, including the ability to retrieve the full content of matching emails.
  • send_email: Compose and send emails directly from your AI agent, with support for CC and BCC recipients.
  • modify_email: Change the state of emails, such as marking them as read/unread, archiving them, or moving them to the trash.
• Calendar Tools:
  • list_events: Retrieve a list of upcoming calendar events within a specified time range.
  • create_event: Create new calendar events with details like attendees, location, and description.
  • update_event: Modify existing calendar events, allowing you to change the time, location, attendees, or description.
  • delete_event: Remove calendar events from your Google Calendar.
• Drive Tools:
  • read_gdrive_file: Read and retrieve the content of files stored in your Google Drive.
  • search_gdrive: Search your Google Drive for files based on keywords, file types, or other criteria.
• Search Tools:
  • search_google: Perform Google searches and retrieve formatted results directly from your AI agent.

Seamless Integration with the UBOS Platform

The py-mcp-google-toolbox seamlessly integrates with the UBOS AI Agent Development Platform, providing a powerful foundation for building and deploying intelligent AI agents within your business. UBOS empowers you to:

• Orchestrate AI Agents: Design complex workflows that involve multiple AI agents working together to achieve specific goals.
• Connect to Enterprise Data: Integrate AI agents with your existing enterprise data sources, enabling them to access and utilize critical business information.
• Build Custom AI Agents: Tailor AI agents to your specific needs by leveraging your own LLMs and custom code.
• Develop Multi-Agent Systems: Create sophisticated AI systems that can collaborate and communicate with each other to solve complex problems.

By combining the capabilities of py-mcp-google-toolbox with the UBOS platform, you can unlock the full potential of AI and transform your business processes.

Getting Started: Installation and Configuration

Integrating py-mcp-google-toolbox into your AI agent development workflow is straightforward. The following steps outline the installation and configuration process:

1. Prerequisites:

   • Install Python 3.12 or higher.
   • Set up a Google Cloud Console project and enable the necessary APIs (Gmail API, Google Calendar API, Google Drive API, and Custom Search API).
   • Create OAuth 2.0 credentials and download the credentials.json file.
   • Generate an API key for the Custom Search Engine.

2. Installation:

   • Clone the repository:

   bash git clone https://github.com/jikime/py-mcp-google-toolbox.git cd py-mcp-google-toolbox

   • Install UV package manager: bash curl -LsSf https://astral.sh/uv/install.sh | sh

   • Create and activate a virtual environment:

   bash uv venv -p 3.12 source .venv/bin/activate # On MacOS/Linux

   or

   .venvScriptsactivate # On Windows

   • Install dependencies:

   bash uv pip install -r requirements.txt

   • Get a refresh token:

   bash uv run get_refresh_token.py

   This will open your browser for Google OAuth authentication and save the credentials to token.json.

3. Configuration:

   • Copy the env.example file to .env and update it with your Google API key, Custom Search Engine ID, client ID, client secret, and refresh token.
   • Copy credentials.json to the project root folder.

4. Run the Server:

   • Using Local:

   bash mcp run server.py

   • Using Docker:

   bash docker build -t py-mcp-google-toolbox . docker run py-mcp-google-toolbox

5. Configure MCP Settings:

   • Add the server configuration to your MCP settings file in your preferred development environment (Claude desktop app, Cursor IDE, or Docker).

Development and Testing

The py-mcp-google-toolbox includes a client script for local testing. You can use this script to experiment with the various tools and functionalities.

For example, to list recent emails:

bash uv run client.py list_emails max_results=5 query=“is:unread”

Refer to the documentation for more examples and detailed instructions.

Conclusion: Empowering AI Agents with Google’s Ecosystem

The py-mcp-google-toolbox is a powerful tool for empowering AI agents with access to the vast ecosystem of Google services. By providing a seamless and versatile interface, this MCP server unlocks a wide range of use cases and enables AI agents to perform complex tasks, automate workflows, and deliver enhanced user experiences. Whether you’re building AI-powered customer service solutions, automating sales and marketing processes, or creating personal productivity assistants, the py-mcp-google-toolbox is an essential component for success.

Furthermore, its seamless integration with the UBOS platform amplifies its potential, providing a comprehensive environment for developing, deploying, and managing AI agents at scale. Embrace the power of Google and UBOS to transform your business with intelligent AI solutions.