Servidor MCP de Google Docs

Este es un servidor de Protocolo de Contexto de Modelo (MCP) que te permite conectarte a Google Docs a través de Claude. Con este servidor, puedes:

Lista todos los documentos de Google Docs en tu Drive
Leer el contenido de documentos específicos
Crear nuevos documentos
Actualizar documentos existentes
Buscar documentos
Eliminar documentos

Prerrequisitos

Node.js v16.0.0 o posterior
Proyecto de Google Cloud con la API de Google Docs y la API de Google Drive habilitadas
Credenciales de OAuth 2.0 para su proyecto de Google Cloud

Configuración

Clone este repositorio y navegue hasta el directorio del proyecto:

git clone https://github.com/yourusername/MCP-Google-Doc.git
cd MCP-Google-Doc

Instalar dependencias:

npm install

Cree un ID de cliente OAuth 2.0 en Google Cloud Console:
- Vaya a la consola de Google Cloud
- Crea un nuevo proyecto o selecciona uno existente
- Habilitar la API de Google Docs y la API de Google Drive
- Vaya a "API y servicios" > "Credenciales".
- Haga clic en "Crear credenciales" > "ID de cliente OAuth".
- Seleccione "Aplicación de escritorio" como tipo de aplicación.
- Descargue el archivo JSON y guárdelo como credentials.json en el directorio de su proyecto
Importante : Los archivos credentials.json y token.json contienen información confidencial y están excluidos del control de versiones mediante .gitignore . Nunca los envíe a su repositorio.
Construir el proyecto:

npm run build

Ejecutar el servidor:

npm start

La primera vez que ejecute el servidor, se le solicitará que se autentique con Google. Siga las instrucciones en pantalla para autorizar la aplicación. Esto generará un archivo token.json que almacena sus tokens de acceso.

Consideraciones de seguridad

Seguridad de credenciales : Tanto credentials.json como token.json contienen información confidencial y nunca deben compartirse ni enviarse al control de versiones. Ya están añadidos al archivo .gitignore .
Actualización de token : la aplicación actualiza automáticamente el token de acceso cuando expira.
Revocar acceso : si necesita revocar el acceso, elimine el archivo token.json y vaya a la configuración de seguridad de su cuenta de Google para eliminar la aplicación de sus aplicaciones autorizadas.

Conectarse a Claude para escritorio

Para utilizar este servidor con Claude for Desktop:

Edite su archivo de configuración de Claude Desktop:
- En macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
- En Windows: %APPDATA%\Claude\claude_desktop_config.json
Añade lo siguiente a tu configuración:

{
  "mcpServers": {
    "googledocs": {
      "command": "node",
      "args": ["/absolute/path/to/build/server.js"]
    }
  }
}

Reemplace /absolute/path/to/build/server.js con la ruta real a su archivo server.js compilado.

Reinicie Claude para escritorio.

Interfaz de usuario

El servidor MCP de Google Docs cuenta con una interfaz conversacional fácil de usar que:

Presenta la información del documento en un formato limpio y legible.
Utiliza respuestas en lenguaje natural en lugar de datos API sin procesar
Formatea fechas de forma legible para humanos
Proporciona preguntas de seguimiento útiles después de las acciones.
Nunca expone datos confidenciales como tokens OAuth

Este estilo de interfaz está diseñado para coincidir con otras integraciones de Claude MCP como Notion, proporcionando una experiencia de usuario consistente y agradable.

Desarrollo

Estructura del proyecto

google-docs-integration/
├── build/                # Compiled JavaScript files
├── src/                  # TypeScript source code
│   └── server.ts         # Main server implementation
├── .gitignore            # Git ignore file
├── credentials.json      # OAuth 2.0 credentials (not in version control)
├── package.json          # Project dependencies and scripts
├── README.md             # Project documentation
├── token.json            # OAuth tokens (not in version control)
└── tsconfig.json         # TypeScript configuration

Añadiendo nuevas funciones

Para agregar nuevas funciones al servidor MCP:

Modifique el archivo src/server.ts para implementar la nueva funcionalidad
Construya el proyecto con npm run build
Pruebe sus cambios ejecutando npm start

Recursos disponibles

googledocs://list : enumera todos los documentos de Google Docs en su unidad
googledocs://{docId} - Obtiene el contenido de un documento específico por ID

Herramientas disponibles

create-doc : crea un nuevo documento de Google con el título especificado y contenido opcional
update-doc : actualiza un documento de Google existente con contenido nuevo (agregar o reemplazar)
insert-text : inserta texto directamente en un documento sin Notion u otras integraciones
search-docs : busca documentos de Google Docs que contengan texto específico
delete-doc : elimina un documento de Google por ID

Indicaciones disponibles

create-doc-template : ayuda a crear un nuevo documento basado en un tema y estilo de escritura específicos
analyze-doc - Analiza el contenido de un documento y proporciona un resumen

Ejemplos de uso

A continuación se muestran algunos ejemplos de indicaciones que puedes usar con Claude una vez que el servidor esté conectado:

"Muéstrame una lista de todos mis documentos de Google"
Crea un nuevo documento de Google titulado "Notas de la reunión" con el contenido "Temas a tratar:...".
"Actualizar mi documento con ID '1abc123def456' para agregar esta sección al final: ..."
"Busca en Google Docs cualquier documento que contenga 'propuesta de proyecto'"
Eliminar el documento de Google con ID '1abc123def456'
"Crear un documento formal sobre el cambio climático"
Analizar el contenido del documento con ID '1abc123def456'

Solución de problemas

Si encuentra problemas de autenticación:

Elimina el archivo token.json en el directorio de tu proyecto
Ejecute el servidor nuevamente para activar un nuevo flujo de autenticación

Si tienes problemas con la API de Google Docs:

Asegúrate de que la API esté habilitada en tu Google Cloud Console
Comprueba que tus credenciales de OAuth tengan los alcances correctos

Contribuyendo

Bifurcar el repositorio
Crea una rama de funciones: git checkout -b feature/your-feature-name
Confirme sus cambios: git commit -am 'Add some feature'
Empujar a la rama: git push origin feature/your-feature-name
Enviar una solicitud de extracción

Licencia

Instituto Tecnológico de Massachusetts (MIT)

Variables de entorno

Cree un archivo .env en la raíz del proyecto (o exporte las variables en su shell) con las siguientes claves:

# OAuth 2.0 client credentials – **JSON string** of the credentials file
GOOGLE_DOCS_CREDENTIALS_JSON={...}

# OAuth token – **JSON string** returned by the OAuth consent flow
GOOGLE_DOCS_TOKEN_JSON={...}

Si se configuran estas variables, el servidor no intentará leer credentials.json o token.json desde el disco.

Google Docs MCP Server

Integrations