1. Acceder a Google Cloud Console mediante el navegador;
2. Crear un nuevo proyecto con un nombre descriptivo (por ejemplo, "gcalendar agent");
3. Cambiar al proyecto recién creado una vez finalizada la inicialización.

0. Si se solicita, hacer clic en "Configurar pantalla de consentimiento";
1. Ingresar el nombre de la aplicación (por ejemplo, "calendar mcp");
2. Especificar la dirección de correo electrónico autorizada;
3. Seleccionar "Audiencia externa" para las restricciones de tipo de usuario;
4. Proporcionar información de contacto utilizando el mismo correo electrónico;
5. Aceptar los requisitos de la Política de Datos del Usuario.

1. Ir a APIs y servicios → Biblioteca;
2. Buscar "Calendar API";
3. Seleccionar el primer resultado y habilitar el acceso a la API;
4. Verificar que el estado de la API muestre "Habilitada".

1. Acceder a la sección Credenciales en APIs y servicios;
2. Crear ID de cliente OAuth;
3. Seleccionar "Aplicación de escritorio" como tipo de aplicación;
4. Descargar el archivo de credenciales JSON generado;
5. Almacenar temporalmente el archivo en el escritorio para facilitar el acceso (opcional).

En Claude, copia y pega el siguiente prompt:

Create a new folder named projects in my Documents directory to store all MCP servers.
Then clone the repository using: git clone https://github.com/nspady/google-calendar-mcp.git into that folder.
After cloning, move the file gcp-oauth.keys.json from my Desktop into the cloned repo.

Claude creará automáticamente la carpeta projects, clonará el repositorio y moverá el archivo JSON de credenciales al repositorio.

• Abre tu carpeta Documents;
• Verifica que exista una nueva carpeta projects;
• Dentro, en el repositorio clonado, encuentra la nueva carpeta (por ejemplo, google-calendar-mcp). El archivo gcp-oauth.keys.json debe estar ubicado dentro del repositorio.

Ejecuta el siguiente prompt en Claude:

add next config block to claude config file
    "google-calendar": {
      "command": "npx",
      "args": ["@cocal/google-calendar-mcp"],
      "env": {
        "GOOGLE_OAUTH_CREDENTIALS": "/path/to/your/gcp-oauth.keys.json"
      }
    }

• Abre Configuración → atajo: Cmd + , en Mac o Ctrl + , en Windows;
• Ve a la pestaña Developer → haz clic en Edit Config;
• Abre el archivo claude_desktop_config.json con un editor de texto. El archivo JSON ahora debe mostrar el nuevo bloque de configuración con la ruta correcta a tu archivo de credenciales;
• Si es correcto, cierra la ventana de configuración.

• Sal completamente de Claude (Mac: Cmd + Q, Windows: Alt + F4);
• Reinicia la aplicación;
• Al iniciar, serás redirigido a una página de autenticación de Google:
  • Selecciona la misma cuenta de Google utilizada para el proyecto;
  • Cuando se solicite, haz clic en Permitir para otorgar acceso;
  • Una vez que veas autenticación exitosa, cierra la pestaña.

En tu Terminal (Mac) o Línea de Comandos (Windows), comienza desde el directorio raíz (por defecto) y navega hasta la carpeta donde almacenarás todos los directorios de Agentes de IA futuros.

• Para acceder a una carpeta, utiliza el comando cd folder_name, por ejemplo:

cd Documents

Para crear una nueva carpeta, utiliza el comando mkdir new_folder_name, por ejemplo:

mkdir projects

Y navega a esta nueva carpeta con el comando cd command:

cd projects

Utiliza el comando git clone link para clonar el repositorio de GitHub:

git clone https://github.com/nspady/google-calendar-mcp.git

Accede al repositorio recién creado usando el comando cd:

cd google-calendar-mcp

Ahora es necesario mover el archivo con las credenciales a la carpeta del agente de IA (google_calendar_mcp). Esto se puede hacer manualmente moviendo el icono del archivo a la carpeta abierta en el explorador de archivos. O bien, utilizar Terminal/Línea de Comandos y copiar el archivo con el comando cp path/to/file_name ., por ejemplo:

cp ~/Desktop/gsp-oauth.keys.json .

El punto (.) al final indica que el destino es el directorio actual.

Se puede verificar si el archivo JSON se movió correctamente a la carpeta usando el comando ls en la Terminal y buscando el nombre del archivo en la lista.

Después de mover el archivo, elimínelo de su ubicación original (por ejemplo, Escritorio).

En la Terminal/Línea de Comandos utilice

npm install

Este comando descarga todos los paquetes y dependencias requeridos.

Continúe trabajando en la Terminal/Línea de Comandos y ejecute

npm start

Este comando ejecuta el script de inicio predeterminado definido en el archivo package.json del proyecto, que normalmente inicia la aplicación o el servidor; en este caso, inicia el flujo de autenticación.

1. Se abre automáticamente una ventana del navegador;
2. Seleccione la cuenta de Google correspondiente;
3. Conceda permisos de acceso al calendario;
4. Confirme el mensaje "Autenticación exitosa";
5. Cierre la ventana del navegador.

Integración con Claude Desktop

• Copie el bloque de configuración:

    "google-calendar": {
      "command": "node",
      "args": [
        "/path/to/build/index.js"
      ]
    }

• Acceda al archivo de configuración de Claude mediante Command/Ctrl + , → "Developer" → "Edit Config";
• Abra el archivo de configuración claude_desktop_config.json con un editor de texto;
• Añada la nueva configuración como siguiente bloque después de las configuraciones existentes y antes de las dos últimas llaves de cierre;
• Asegúrese de que la sintaxis JSON sea correcta, con el cierre adecuado de llaves y comas después de cada bloque de configuración, excepto el último.

En la Terminal/Línea de Comandos ejecute

pwd

Copie la ruta completa del directorio e insértela antes de "/build" en el archivo de configuración.

Guarde el archivo de configuración con Command/Ctrl + S.

1. Reinicie completamente Claude Desktop;
2. Verifique que el nuevo servidor aparezca en las herramientas disponibles.