Google Task MCP

Un servidor MCP local y un plugin de Codex para listar, crear, actualizar, completar, descompletar y eliminar tareas de Google. Utiliza OAuth 2.0 y solicita solo el ámbito de Google Tasks:

https://www.googleapis.com/auth/tasks

Requisitos

• Node.js 20 o más reciente

• Un proyecto de Google Cloud

• Codex u otro cliente MCP que admita servidores STDIO locales

Related MCP server: Google Tasks MCP Server

Configuración de Google Cloud

1. En Google Cloud Console, crea o selecciona un proyecto.

2. Habilita la Google Tasks API en APIs y Servicios → Biblioteca.

3. Configura la pantalla de consentimiento de OAuth. Añádete como usuario de prueba mientras la aplicación esté en pruebas.

4. Crea un ID de cliente de OAuth de tipo Aplicación de escritorio. Añade http://127.0.0.1:53682/oauth2callback como URI de redireccionamiento autorizado si la configuración del cliente permite la gestión de URI de redireccionamiento.

Instalar dependencias

npm install
npm run check

Configurar credenciales

Establece las siguientes variables en el entorno que lanza Codex. .env.example documenta los valores requeridos; el servidor intencionalmente no carga .env automáticamente.

GOOGLE_TASKS_CLIENT_ID
GOOGLE_TASKS_CLIENT_SECRET
GOOGLE_TASKS_REDIRECT_URI=http://127.0.0.1:53682/oauth2callback

Opcionalmente, establece GOOGLE_TASKS_TOKEN_PATH para elegir dónde se almacena el token OAuth local.

Usar como plugin de Codex

El repositorio ya incluye .codex-plugin/plugin.json y .mcp.json. Instálalo a través de un mercado de plugins local de Codex, luego reinicia Codex para que se carguen el servidor STDIO incluido y las definiciones de herramientas.

Para desarrollo sin empaquetado, configura el servidor directamente en Codex usando:

command: node
args: <absolute-repository-path>/server/index.js

Después de que Codex se conecte, llama a google_tasks_get_authorization_url, abre la URL devuelta, aprueba el acceso y llama a google_tasks_complete_authorization.

El token de actualización se almacena localmente en %APPDATA%\\google-task-mcp\\token.json por defecto. Establece GOOGLE_TASKS_TOKEN_PATH para elegir una ruta local diferente. Elimina ese archivo para desconectar la cuenta.

Herramientas y seguridad

El servidor proporciona herramientas para listar listas de tareas y tareas, crear y actualizar tareas, completar o descompletar una tarea, y eliminar una tarea. La eliminación se rechaza a menos que confirm esté establecido en true; los llamadores deben mostrar primero la tarea exacta que se va a eliminar. Otros cambios se aplican inmediatamente a Google Tasks.

La autorización OAuth requiere que el listener de devolución de llamada de loopback permanezca en ejecución. La devolución de llamada del navegador muestra una página simple de éxito o error y nunca expone tokens en la URL ni en la salida de la herramienta.

Pruebas locales

Ejecuta npm run check para una verificación de sintaxis. Las llamadas a la API/OAuth requieren credenciales configuradas y una autorización interactiva del navegador.

Privacidad

Las credenciales OAuth y los datos de las tareas permanecen en la máquina local, excepto las solicitudes enviadas directamente a las APIs de Google. Nunca hagas commit de .env ni del archivo de token generado. Ambos están excluidos por .gitignore.

Licencia

Publicado bajo la MIT License.