0.5.3

Google Documents MCP

Servidor Model Context Protocol para Google Docs — asistente documental académico.

Beta cerrada: el OAuth de Google está en modo Testing. Solo pueden autenticarse los usuarios añadidos manualmente como test users por el maintainer.

npx @0pvalencia/google-documents-mcp login

Características

• Un solo login en el navegador — sin crear proyectos en Google Cloud.
• Sesión persistente por usuario en el directorio estándar del sistema.
• Herramientas MCP para gestión, edición, formato y flujos académicos.
• Resources de guía (google-documents://guides/…) y prompts reutilizables para informes largos.
• Comando doctor con diagnóstico claro.
• Compatible con Cursor, VS Code, Claude Desktop y OpenCode (stdio).

Herramientas disponibles

Documentos / Archivo (Drive)

Edición

Formato

Académicas

Resources (guías para agentes)

Prompts MCP

Nota: pages en generate_academic_document no rellena el cuerpo; solo crea el andamiaje. Los prompts enseñan a escribir capítulo a capítulo.

Instalación y primer uso

1. Autentica:

npx @0pvalencia/google-documents-mcp login

Si ya tenías sesión con el scope anterior (drive.metadata.readonly), vuelve a ejecutar login para conceder drive (necesario para duplicar/eliminar).

2. Autoriza Google en el navegador (debes estar en la lista de test users).

3. Conecta el MCP en tu cliente:

   • Cursor
   • VS Code
   • Claude Desktop
   • Claude Code
   • OpenCode
   • Índice de clientes

Solo necesitas autenticarte una vez. Comprueba el estado:

npx @0pvalencia/google-documents-mcp doctor

Beta cerrada / test users

Actualmente Google OAuth está en modo testing. Solo usuarios agregados manualmente como test users pueden autenticarse.

Si el login falla:

1. Pide al maintainer que te añada como test user.
2. Vuelve a ejecutar login.

Error 400 / el navegador no abre en Windows

Desde 0.6.3 el login abre el navegador directamente y nunca imprime la URL OAuth en la terminal. En Windows usa rundll32 para no romper los & de la query.

Comandos CLI

google-documents-mcp                 Inicia el servidor MCP (stdio)
google-documents-mcp login           Inicia sesión con Google
google-documents-mcp logout          Cierra la sesión local
google-documents-mcp doctor          Verifica la sesión y el acceso a las APIs
google-documents-mcp version         Muestra la versión
google-documents-mcp help            Lista los comandos

Doctor

Comprueba: sesión, refresh token, usuario autenticado, Docs API, Drive API y permisos.

Dónde se guarda la sesión

npx @0pvalencia/google-documents-mcp logout

Arquitectura

src/
├── auth/                 # OAuth, PKCE, sesión
├── cli/                  # login, logout, doctor, help
├── config/               # storage y rutas del SO
├── server/
│   ├── mcp.ts            # tools + services
│   └── stdio.ts          # transporte local
├── transports/
│   └── stdio.ts
├── services/
│   └── docs/             # Docs API (documents, content, formatting, academic)
├── tools/docs/
│   ├── documents/
│   ├── content/
│   ├── formatting/
│   └── academic/
├── prompts/              # prompts MCP (informes largos, repair, safe edit)
├── resources/            # resources google-documents://guides/*
├── schemas/
├── types/
└── utils/

Las tools solo validan parámetros y delegan en services/.

Desarrollo (maintainers)

npm install
cp .env.example .env
npm run dev login
npm run check
npm test

Contribuir

1. Fork + rama descriptiva.
2. Tipado estricto, sin any.
3. Nuevas herramientas solo vía services/ + tools/.
4. npm run check y npm test antes del PR.

Licencia

MIT

---

Gracias por leer