MCP Google Workspace Server

MCP Google Workspace Server

Un servidor de Model Context Protocol (MCP) que permite a los agentes de IA interactuar 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
• Google Sheets: Crear hojas de cálculo, leer/escribir valores de celdas
• Múltiples modos de transporte: stdio (predeterminado), SSE, WebSocket
• Compatibilidad con clientes compatibles con MCP (Cursor, etc.)

📋 Instalación

Usando 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

Configuración para clientes MCP

Añade a la configuración de tu cliente (p. ej., 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 con 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 OAuth de Google

1. Visita Google Cloud Console
2. Habilita las API de Drive, Docs y Sheets
3. Crea credenciales OAuth 2.0
4. Guárdalo como ~/.google/oauth.keys.json
5. Ejecuta mcp-google auth para autenticarte

Herramientas disponibles

Operaciones de Drive

• drive_search_files: Buscar archivos en Google Drive
  • query (string, obligatorio): Consulta de búsqueda
  • page_size (integer, opcional): Número de resultados a devolver
• drive_create_folder: Crear una nueva carpeta
  • name (string, obligatorio): Nombre de la carpeta
  • parent_id (string, opcional): ID de la carpeta principal

Operaciones de Docs

• docs_create: Crear un nuevo documento
  • title (string, obligatorio): Título del documento
  • content (string, opcional): Contenido inicial
• docs_get_content: Obtener el contenido del documento
  • document_id (string, obligatorio): ID del documento
• docs_update_content: Actualizar el contenido del documento
  • document_id (string, obligatorio): ID del documento
  • content (string, obligatorio): Nuevo contenido

Operaciones de Sheets

• sheets_create: Crear una nueva hoja de cálculo
  • title (string, obligatorio): Título de la hoja de cálculo
  • sheets (array, opcional): Nombres de las hojas
• sheets_get_values: Obtener valores de celdas
  • spreadsheet_id (string, obligatorio): ID de la hoja de cálculo
  • range (string, obligatorio): Rango en notación A1
• sheets_update_values: Actualizar valores de celdas
  • spreadsheet_id (string, obligatorio): ID de la hoja de cálculo
  • range (string, obligatorio): Rango en notación A1
  • values (array, 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

Usa el MCP Inspector para 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

• Documentación
• MCP Inspector
• Pre-commit Hooks
• Google Cloud Console

🤝 Contribuciones

Por favor, lee CONTRIBUTING.md para conocer los detalles sobre nuestro código de conducta y el proceso para enviar pull requests.

🔒 Seguridad

Consulta SECURITY.md para reportar vulnerabilidades y conocer las mejores prácticas.

📄 Licencia

Licencia MIT: consulta el archivo LICENSE para más detalles.