Servidor de Google Workspace de MCP

código decodificador Versión de PyPI Licencia: MIT Estilo de código: negro

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.

Deploy Server

A

security – no known vulnerabilities

-

license - not tested

A

quality - confirmed to work

How are these scores calculated?

Related Resources

GitHub Repository

Need Help?

Report Issue

Reddit Discussion about this server

Tools

Related MCP Servers

Google Cloud MCP Server
krzko
A
security
-
license
A
quality
A Model Context Protocol server that connects to Google Cloud services, allowing users to query logs, interact with Spanner databases, and analyze Cloud Monitoring metrics through natural language interaction.
Last updated -
40
55
62
Apache 2.0
mcp-google-sheets
xing5
-
security
-
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 -
494
MIT License
MCP Google Workspace Server
josedu90
A
security
-
license
A
quality
A Model Context Protocol server that enables AI agents to interact with Google Workspace services including Drive, Docs, and Sheets through natural language commands.
Last updated -
8
MIT License
Google Docs MCP Server
penysho
A
security
-
license
A
quality
A Model Context Protocol server that provides an interface for AI models to interact with Google Docs, enabling reading, creating, updating, and searching Google Documents.
Last updated -
4
3

View all related MCP servers

MCP Google Suite