Servidor de Google Workspace de MCP

Un servidor de Protocolo de contexto de modelo (MCP) que permite que los agentes de IA interactúen con los servicios de Google Workspace (Drive, Docs y Sheets).

🌟 Características

Google Drive: buscar archivos, crear carpetas
Google Docs: crear, leer y actualizar documentos
Hojas de cálculo de Google: crear hojas de cálculo, leer y escribir valores de celdas
Múltiples modos de transporte: stdio (predeterminado), SSE, WebSocket
Soporte de cliente compatible con MCP (Cursor, etc.)

📋 Instalación

Uso de uv (recomendado)

uvx mcp-google-suite

Usando pip

pip install mcp-google-suite

Configuración de desarrollo

# Clone and install
git clone git@github.com: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 .

🔧 Configuración

Configurar para clientes MCP

Agregue a la configuración de su cliente (por ejemplo, Cursor, Claude):

Usando uvx (recomendado):

{
  "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"
      }
    }
  }
}

Usando la instalación de pip:

{
  "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"
      }
    }
  }
}

Configuración de Google OAuth

Visita la consola de Google Cloud
Habilitar las API de Drive, Docs y Sheets
Crear credenciales OAuth 2.0
Guardar como ~/.google/oauth.keys.json
Ejecute mcp-google auth para autenticarse

Herramientas disponibles

Operaciones de conducción

drive_search_files : Buscar archivos en Google Drive
- query (cadena, obligatoria): Consulta de búsqueda
- page_size (entero, opcional): Número de resultados a devolver
drive_create_folder : Crea una nueva carpeta
- name (cadena, obligatorio): nombre de la carpeta
- parent_id (cadena, opcional): ID de la carpeta principal

Operaciones de documentos

docs_create : Crea un nuevo documento
- title (cadena, obligatorio): Título del documento
- content (cadena, opcional): contenido inicial
docs_get_content : Obtener el contenido del documento
- document_id (cadena, obligatoria): ID del documento
docs_update_content : Actualizar el contenido del documento
- document_id (cadena, obligatoria): ID del documento
- content (cadena, obligatorio): Nuevo contenido

Operaciones con hojas de cálculo

sheets_create : Crea una nueva hoja de cálculo
- title (cadena, obligatorio): título de la hoja de cálculo
- sheets (matriz, opcional): nombres de hojas
sheets_get_values : Obtener valores de celda
- spreadsheet_id (cadena, obligatoria): ID de la hoja de cálculo
- range (cadena, obligatorio): rango de notación A1
sheets_update_values : Actualizar valores de celda
- spreadsheet_id (cadena, obligatoria): ID de la hoja de cálculo
- range (cadena, obligatorio): rango de notación A1
- values (matriz, obligatorio): matriz 2D de valores

🛠️ Desarrollo

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

# Setup pre-commit hooks
pre-commit install

# Run tests
pytest

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

🔍 Depuración

Utilice el Inspector MCP para realizar pruebas interactivas:

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

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

📚 Recursos

🤝 Contribuyendo

Lea CONTRIBUTING.md para obtener detalles sobre nuestro código de conducta y el proceso para enviar solicitudes de extracción.

🔒 Seguridad

Consulte SECURITY.md para informar vulnerabilidades y mejores prácticas.

📄 Licencia

Licencia MIT: consulte el archivo LICENCIA para obtener más detalles.

Install Server

HTTP connection URL

security – no known vulnerabilities

license - permissive license

quality - confirmed to work

How are these scores calculated?

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Tools

Un servidor de protocolo de contexto de modelo que permite a los agentes de IA interactuar con los servicios de Google Workspace, incluidos Drive, Docs y Sheets, a través de comandos de lenguaje natural.

Related Resources

Reddit Discussion about this server

Related MCP Servers

Gmail MCP Server
zacco16
-
security
F
license
-
quality
A Model Context Protocol server that enables AI assistants to interact with Gmail services, supporting email operations, draft management, and calendar functionality through Google API integration.
Last updated -
49
1
TypeScript
mcp-google-sheets
xing5
-
security
A
license
-
quality
A Model Context Protocol server that integrates with Google Drive and Google Sheets, enabling users to create, read, update, and manage spreadsheets through natural language commands.
Last updated -
307
Python
MIT License
MCP Google Suite
adexltd
A
security
A
license
A
quality
A Model Context Protocol server that provides seamless integration with Google Workspace, allowing operations with Google Drive, Docs, and Sheets through secure OAuth2 authentication.
Last updated -
8
3
Python
MIT License
Claude MCP x Google Docs
a-bonus
-
security
A
license
-
quality
A Model Context Protocol server that enables AI assistants like Claude to read from, append to, and format text in Google Documents programmatically.
Last updated -
74
TypeScript
MIT License

View all related MCP servers

MCP Google Workspace Server