What is Mcp Google Suite

mcp-google-suite is a Model Context Protocol (MCP) server that enables AI agents to interact with Google Workspace services, including Google Drive, Docs, and Sheets.

Use cases

Use cases include automating document generation, managing spreadsheets for data analysis, and building applications that require file management within Google Drive.

How to use

To use mcp-google-suite, you can install it via pip or uv. After installation, configure your MCP clients (like Cursor) with the necessary Google credentials and server settings.

Key features

Key features include file searching and folder creation in Google Drive, document creation and editing in Google Docs, and spreadsheet management in Google Sheets. It supports multiple transport modes such as stdio, SSE, and WebSocket.

Where to use

mcp-google-suite can be used in various fields such as software development, data analysis, and automation tasks that require integration with Google Workspace services.

MCP Google Workspace Server

A Model Context Protocol (MCP) server enabling AI agents to interact with Google Workspace (Drive, Docs, and Sheets) services.

🌟 Features

• Google Drive: Search files, create folders
• Google Docs: Create, read, update documents
• Google Sheets: Create spreadsheets, read/write cell values
• Multiple transport modes: stdio (default), SSE, WebSocket
• MCP-compatible client support (Cursor, etc.)

📋 Installation

Using uv (recommended)

uvx mcp-google-suite

Using pip

pip install mcp-google-suite

Development setup

# Clone and install
git clone [email protected]:adexltd/mcp-google-suite.git && cd mcp-google-suite
uv venv && source .venv/bin/activate  # or .venv\Scripts\activate on Windows
uv pip install -e .

🔧 Configuration

Configure for MCP Clients

Add to your client settings (e.g. Cursor, Claude):

Using uvx (recommended):

{
  "mcpServers": {
    "mcp-google-suite": {
      "command": "uvx",
      "args": [
        "mcp-google-suite"
      ],
      "env": {
        "GOOGLE_APPLICATION_CREDENTIALS": "~/.google/server-creds.json",
        "GOOGLE_OAUTH_CREDENTIALS": "~/.google/oauth.keys.json"
      }
    }
  }
}

Using pip installation:

{
  "mcpServers": {
    "mcp-google-suite": {
      "command": "python",
      "args": [
        "-m",
        "mcp_google_suite"
      ],
      "env": {
        "GOOGLE_APPLICATION_CREDENTIALS": "~/.google/server-creds.json",
        "GOOGLE_OAUTH_CREDENTIALS": "~/.google/oauth.keys.json"
      }
    }
  }
}

Google OAuth Setup

1. Visit Google Cloud Console
2. Enable Drive, Docs, and Sheets APIs
3. Create OAuth 2.0 credentials
4. Save as ~/.google/oauth.keys.json
5. Run mcp-google auth to authenticate

Available Tools

Drive Operations

• drive_search_files: Search files in Google Drive
  • query (string, required): Search query
  • page_size (integer, optional): Number of results to return
• drive_create_folder: Create a new folder
  • name (string, required): Folder name
  • parent_id (string, optional): Parent folder ID

Docs Operations

• docs_create: Create a new document
  • title (string, required): Document title
  • content (string, optional): Initial content
• docs_get_content: Get document content
  • document_id (string, required): Document ID
• docs_update_content: Update document content
  • document_id (string, required): Document ID
  • content (string, required): New content

Sheets Operations

• sheets_create: Create a new spreadsheet
  • title (string, required): Spreadsheet title
  • sheets (array, optional): Sheet names
• sheets_get_values: Get cell values
  • spreadsheet_id (string, required): Spreadsheet ID
  • range (string, required): A1 notation range
• sheets_update_values: Update cell values
  • spreadsheet_id (string, required): Spreadsheet ID
  • range (string, required): A1 notation range
  • values (array, required): 2D array of values

🛠️ Development

# Install dev dependencies
uv pip install -e ".[dev]"

# Setup pre-commit hooks
pre-commit install

# Run tests
pytest

# Format code
black . && ruff check --fix .

🔍 Debugging

Use the MCP Inspector for interactive testing:

# Using uvx
npx @modelcontextprotocol/inspector uvx mcp-google

# For development
cd path/to/mcp-google-suite
npx @modelcontextprotocol/inspector uv run mcp-google

📚 Resources

• Documentation
• MCP Inspector
• Pre-commit Hooks
• Google Cloud Console

🤝 Contributing

Please read CONTRIBUTING.md for details on our code of conduct and the process for submitting pull requests.

🔒 Security

See SECURITY.md for reporting vulnerabilities and best practices.

📄 License

MIT License - See LICENSE file for details.