Suite de Google MCP

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.

This server cannot be installed

security - not tested

license - permissive license

quality - not tested

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.

Un servidor de protocolo de contexto de modelo que proporciona una integración perfecta con Google Workspace, lo que permite operaciones con Google Drive, Docs y Sheets a través de la autenticación segura OAuth2.

Related MCP Servers

Nash MCP Server
nash-app
-
security
A
license
-
quality
A Model Context Protocol server that enables seamless execution of commands, Python code, web content fetching, and reusable task management with secure credentials handling.
Last updated -
2
Python
MIT License
Google Cloud MCP Server
krzko
-
security
F
license
-
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 -
16
2
TypeScript
MCP Google Map Server
cablate
A
security
A
license
A
quality
A Model Context Protocol server that provides Google Maps API integration, allowing users to search locations, get place details, geocode addresses, calculate distances, obtain directions, and retrieve elevation data through LLM processing capabilities.
Last updated -
7
163
25
TypeScript
MIT License
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 -
134
Python
MIT License

View all related MCP servers

MCP Google Suite