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)

Using pip

Development setup

🔧 Configuration

Configure for MCP Clients

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

Using uvx (recommended):

Using pip installation:

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

🔍 Debugging

Use the MCP Inspector for interactive testing:

📚 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.