google_workspace_mcp

Control Gmail, Google Calendar, Docs, Sheets, Slides, Chat, Forms, Tasks, Search & Drive with AI - Comprehensive Google Workspace / G Suite MCP Server

GitHub Stars

629

User Rating

Not Rated

Favorites

0

Views

8

Forks

159

Issues

28

Installation
Difficulty
Intermediate
Estimated Time
10-20 minutes
Requirements
Python 3.11以上
FastMCP 最新版

Installation

Installation

Prerequisites

Python: 3.11 or higher
FastMCP: Latest version

Installation Steps

1. Clone Repository

bash
git clone https://github.com/taylorwilsdon/google_workspace_mcp.git
cd google_workspace_mcp

2. Install Dependencies

bash
pip install -r requirements.txt

3. Start Server

bash
python main.py

Troubleshooting

Common Issues

Issue: Server won't start Solution: Check Python version and reinstall dependencies.

Configuration

Configuration

Basic Configuration

OAuth 2.0 Setup

Edit config.json to set your OAuth 2.0 client ID and secret:
json
{
  "client_id": "your-client-id",
  "client_secret": "your-client-secret",
  "redirect_uris": ["http://localhost:3000/callback"]
}

Advanced Configuration

Security Settings

Store API keys in environment variables or secure configuration files.

Performance Tuning

Configure caching settings.

Configuration Example

json
{
  "oauth": {
    "client_id": "your-client-id",
    "client_secret": "your-client-secret"
  }
}

Examples

Examples

Basic Usage

Programmatic Usage

python
import requests

def call_google_workspace_tool(tool_name, params):
    response = requests.post(
        'http://localhost:3000/mcp/call',
        json={
            'tool': tool_name,
            'parameters': params
        }
    )
    return response.json()

Usage example

result = call_google_workspace_tool('create_event', { 'title': 'Meeting', 'date': '2023-10-01' })

Use Cases

Use an AI assistant to create calendar events using natural language.
Search and send emails through Gmail based on specific criteria.
Upload files to Google Drive and share them with other users.
Aggregate data in Google Sheets and generate graphs.
Collaborate in Google Docs for real-time feedback and editing.