google-workspace-mcp

Conjunto de cinco servidores MCP remotos independientes sobre Google Workspace: Gmail, Google Calendar, Google Drive, Google Sheets y Google Docs.

Estado: pre-alpha. El proyecto se encuentra en desarrollo activo; las interfaces públicas y la configuración pueden cambiar hasta la primera versión estable.

Los servidores están separados deliberadamente. El cliente o proyecto incluye únicamente el servicio que necesita y obtiene un token que funciona solo para ese servicio: el token de Gmail no abre Drive. Lo que se comparte son el repositorio, las bibliotecas de infraestructura, el marco de autorización y el procedimiento de despliegue.

Servicios

Cada servicio es un proceso independiente, un endpoint MCP independiente, un registro de herramientas independiente, un conjunto de permisos de Google independiente y un almacén de credenciales independiente.

Dos capas de autorización

Son independientes y no se mezclan.

Cliente → servicio. El cliente MCP realiza OAuth 2.1 con PKCE y registro dinámico. El token emitido está vinculado a un solo recurso y se renueva mediante un refresh token rotatorio con detección de reutilización.

Servicio → Google. El servicio accede a las API de productos de Google en nombre del propietario mediante un refresh token de larga duración y renueva el access token por sí mismo. El token de Google nunca se entrega al cliente, bajo ninguna circunstancia.

Las API oficiales de los endpoints MCP de Google se encuentran en Developer Preview y no se utilizan aquí: las llamadas van a las API de productos estables.

Requisitos

• Python 3.14, se instala con uv; no se modifica el intérprete del sistema

• uv

• Proyecto de Google Cloud con las API de los cinco servicios habilitadas y un cliente OAuth

Instalación

uv sync --dev

Verificaciones

uv run --no-sync pytest -q
uv run --no-sync ruff check .
uv run --no-sync ruff format --check .
uv run --no-sync mypy src

La marca --no-sync es obligatoria al verificar las versiones de las dependencias: sin ella, uv run resincroniza el entorno desde el archivo de bloqueo y devuelve la versión fijada en lugar de la real, por lo que una versión de paquete que claramente falla daría una verificación en verde.

Origen

El proyecto adapta el núcleo OAuth 2.1 de jimprosser/obsidian-web-mcp bajo MIT; la información completa está en NOTICE.

La base aguas abajo de OAuth 2.1 es la revisión 7e6a52d791a50e3bd533df1067970215ab3be1c8. Después de esa revisión, se incorporaron al núcleo correcciones propias sobre el ciclo de vida de clientes y tokens, rotación de refresh tokens, detección de reutilización y canonicalización de resource.

La parte de dominio del proyecto original —el trabajo con el almacén de Obsidian y la sincronización mediante Git— no se ha trasladado.

Aquí se utiliza mcp>=2,<3: no se requiere el paquete remoto mcp.server.fastmcp, sino que la composición propia se construye sobre mcp.server.mcpserver.

Licencia

MIT, ver LICENSE.