Gtasks MCP
Resumen
Descripción del creador (original en inglés)
Manage Google Tasks via MCP: list, search, create, update, move, and clear tasks.
Los tres pilares de PopNx MCP
Estos tres nunca se combinan en una sola puntuación: las opiniones, las mediciones y la popularidad son cosas distintas.
- Opinión de usuariosiAún no hay reseñasLas reseñas se abrirán junto con las cuentas en una etapa posterior
- Nuestras revisiones básicasi1 de 1 superadasRevisado con información pública; el código aún no se ha escaneado
- UsoiMuy nuevo↓ 130/sem · ★ –
Qué puedes hacer con él
Todavía no escribimos un resumen sencillo para este. Abajo están los datos que leímos del registro.
- Conexión: Se ejecuta en tu computadora
- Transporte: stdio
- Categoría: Búsqueda y memoria de IA
- Debes completar: GOOGLE_CLIENT_ID, GOOGLE_CLIENT_SECRET, GOOGLE_REFRESH_TOKEN
Instalación
Elige la app de IA que usas y copia la configuración.
Antes de instalar
- Revisiones básicas: 1 de 1 superadas
- Se ejecuta en tu computadora con los permisos de tu usuario (archivos, red, apps).
- Debes completar tú:
GOOGLE_CLIENT_ID,GOOGLE_CLIENT_SECRET,GOOGLE_REFRESH_TOKEN
Los valores marcados como secretos son llaves de tu cuenta. Nunca los compartas ni los pegues en un chat.
Necesitas
- npmNode.js instalado (para el comando npx)
¿Qué app usas?
Elige tu app arriba. La recordamos, así que la próxima vez el botón dirá “Instalar en …”.
Abre Claude Desktop → Settings → Developer → Edit Config y pega esto en claude_desktop_config.json
{
"mcpServers": {
"gtasks": {
"command": "npx",
"args": [
"-y",
"@alvincrave/gtasks-mcp"
],
"env": {
"GOOGLE_CLIENT_ID": "your-value",
"GOOGLE_CLIENT_SECRET": "your-value",
"GOOGLE_REFRESH_TOKEN": "your-value"
}
}
}
}Ejecuta esto en tu terminal
claude mcp add gtasks --env GOOGLE_CLIENT_ID=your-value --env GOOGLE_CLIENT_SECRET=your-value --env GOOGLE_REFRESH_TOKEN=your-value -- npx -y @alvincrave/gtasks-mcpCompleta los valores vacíos antes de ejecutarlo.
O copia la configuración tú
Pégalo en .cursor/mcp.json de tu proyecto, o en ~/.cursor/mcp.json
{
"mcpServers": {
"gtasks": {
"command": "npx",
"args": [
"-y",
"@alvincrave/gtasks-mcp"
],
"env": {
"GOOGLE_CLIENT_ID": "your-value",
"GOOGLE_CLIENT_SECRET": "your-value",
"GOOGLE_REFRESH_TOKEN": "your-value"
}
}
}
}Tu navegador te pide permiso para abrir la app; luego la app muestra la configuración y te pide confirmar. Los valores de las claves quedan vacíos para que los completes tú.
O copia la configuración tú
Pégalo en .vscode/mcp.json de tu proyecto
{
"servers": {
"gtasks": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@alvincrave/gtasks-mcp"
],
"env": {
"GOOGLE_CLIENT_ID": "your-value",
"GOOGLE_CLIENT_SECRET": "your-value",
"GOOGLE_REFRESH_TOKEN": "your-value"
}
}
}
}Tu navegador te pide permiso para abrir la app; luego la app muestra la configuración y te pide confirmar. Los valores de las claves quedan vacíos para que los completes tú.
Este se ejecuta en tu computadora, y ChatGPT solo puede conectarse a servidores en internet. Elige otra app.
Tu elección se guarda en una cookie en este dispositivo; no necesitas cuenta.
Valores que debes completar
- Google OAuth client ID
- Google OAuth client secret
- Google OAuth refresh token with Tasks scope
Esta configuración se genera a partir de la ficha del creador en el registro. Si el README dice otra cosa, sigue el README.
Qué puede hacer
Se ejecuta en tu computadora; la lista de herramientas aparece en tu app de IA después de instalarlo.
Revisiones básicasi
Revisamos información que cualquiera puede ver; no hemos leído el código. Las revisiones que no aplican no se cuentan. · Revisado el 8 nov 2026
- ✓ Superada
El creador coincide con el repo
El nombre en el registro se verificó con la cuenta de GitHub alvinjchoi, dueña del repo
- … Aún sin revisar
Sigue en mantenimiento
Todavía no hemos leído este repo en GitHub
- … Aún sin revisar
Tiene licencia
Todavía no hemos leído este repo en GitHub
- – No aplica
El endpoint responde
Este se ejecuta en tu computadora; no hay endpoint en internet
- – No aplica
Inicio de sesión con OAuth
Se ejecuta en tu computadora y usa ajustes locales en su lugar
- … Aún sin revisar
Sin instrucciones ocultas en las descripciones de herramientas
Se ejecuta en tu computadora; solo podemos leer listas de herramientas de endpoints en internet
Comparado con otros en Búsqueda y memoria de IAi
- Más estrellas que el 0% de los otros 5722 servidores de esta categoría
- Publicado en el registro más recientemente que el 23% de los otros 5722 servidores de esta categoría
- Revisiones básicas iguales o mejores que el 100% de los otros 5722 servidores de esta categoría
Comparado con todos los servidores activos de esta categoría en el registro. Las estrellas solo cuentan cuando quien lo publica es dueño del repo.
Preguntas frecuentes
¿Es seguro Gtasks MCP?
Superó 1 de 1 revisiones básicas aplicables. No hemos leído el código. Antes de agregar una clave o un token, revisa qué acceso pide el servidor y usa una clave que tenga solo los permisos que necesitas.
¿Qué claves o códigos necesita?
Debes completar: GOOGLE_CLIENT_ID, GOOGLE_CLIENT_SECRET, GOOGLE_REFRESH_TOKEN
¿Se ejecuta en mi computadora o en la nube?
Se ejecuta en tu computadora. Tu app de IA lo inicia cuando hace falta, y los datos no pasan por los servidores del creador (a menos que el propio servidor llame a un servicio en línea).
¿Sigue en mantenimiento?
El repo de GitHub cambió por última vez –, y la última versión (0.2.0) llegó al registro hace 4 meses.
¿Qué apps pueden usarlo?
Las apps compatibles con MCP, como Claude Desktop, Claude Code, Cursor y VS Code. También necesitas Node.js en tu computadora.
¿Qué puedo usar en su lugar?
En la misma categoría: Context7, Codebase Memory, Exa
Alternativas
Servidores de la misma categoría hechos por otros creadores, ordenados por estrellas.
Cómo leer una tarjeta:↓ Descargas por semanai★ Estrellas de GitHubiTres pilares: reseñas · revisiones · usoiActualizado = fecha en que se publicó la última versión en el registroi
Codebase Memory
Codebase knowledge graph for AI agents — 162 languages, sub-ms queries, 99% fewer tokens.
Exa
Connect AI agents to Exa for web search, content fetching, and multi-step research.
README del creador
Abrir el README
Copiado tal cual del repo del creador. PopNx MCP no lo ha revisado ni lo respalda. Se quitaron HTML, imágenes y scripts. Los enlaces llevan fuera de este sitio.
Google Tasks MCP Server
A Model Context Protocol (MCP) server for Google Tasks. Manage task lists and tasks through natural language in Claude Desktop and other MCP clients.
Forked from zcaceres/gtasks-mcp with stronger auth options, multi-list support, pagination, and hierarchy tools.
Registry name: io.github.alvinjchoi/gtasks-mcp npm: @alvincrave/gtasks-mcp
Features
- List and search tasks (optionally scoped to one task list)
- Paginate through all tasks (no silent 100-task cap)
- Create, update, delete, and clear completed tasks
- Discover task lists (
list_task_lists) - View parent/child hierarchy (
list_with_tree) - Reorder, nest, or move tasks across lists (
move) - OAuth2 auth via env vars, credential files, or interactive
auth - Docker support
Installation
Recommended (Claude Desktop / any MCP client) — runs the latest published npm package:
npx -y @alvincrave/gtasks-mcp
Or install globally:
npm install -g @alvincrave/gtasks-mcp
From source
git clone https://github.com/alvinjchoi/gtasks-mcp.git
cd gtasks-mcp npm install npm run build
Setup
Option A — Environment variables (Claude Desktop)
- Create a Google Cloud project and enable the Google Tasks API.
- Create OAuth 2.0 Desktop credentials and obtain a refresh token (OAuth Playground with scope
https://www.googleapis.com/auth/tasksworks). - Configure Claude Desktop (
~/Library/Application Support/Claude/claude_desktop_config.jsonon macOS):
{
"mcpServers": { "gtasks": { "command": "npx", "args": ["-y", "@alvincrave/gtasks-mcp"], "env": { "GOOGLE_CLIENT_ID": "your_client_id_here", "GOOGLE_CLIENT_SECRET": "your_client_secret_here", "GOOGLE_REFRESH_TOKEN": "your_refresh_token_here" } } } }
Option B — Credential files (local / shared with other Google MCP servers)
- Download your OAuth client JSON (
gcp-oauth.keys.json). - Authenticate once:
export GTASKS_CREDENTIALS_PATH=/path/to/gcp-oauth.keys.json
export GTASKS_TOKEN_PATH=/path/to/.gtasks-server-credentials.json node dist/index.js auth
- Run the server with the same env vars set (or place
gcp-oauth.keys.jsonin the project root and use the defaults).
Aliases also accepted:
| Purpose | Preferred | Alias |
|---|---|---|
| OAuth client keys | GTASKS_CREDENTIALS_PATH | GOOGLE_OAUTH_KEYS_PATH |
| Saved tokens | GTASKS_TOKEN_PATH | GOOGLE_TASKS_CREDENTIALS_PATH |
Option C — Home config file
Create ~/.gtasks-credentials.json:
{
"clientId": "your_client_id", "clientSecret": "your_client_secret", "refreshToken": "your_refresh_token" }
Tools
| Tool | Description |
|---|---|
search | Search tasks by title/notes. Optional taskListId. |
list | List tasks (all lists, or one via taskListId). Fully paginated. |
list_task_lists | List task list names and IDs. |
list_with_tree | Tree view for one list (parent/child, position order). |
move | Reorder, nest/un-nest, or move across lists. |
create | Create a task (title required; optional notes/due/taskListId). |
update | Patch a task (only provided fields change). |
delete | Delete a task. |
clear | Clear completed tasks from a list. |
Usage examples
show my task lists
list tasks in list search for tasks containing "meeting" create a task named "Prepare presentation" due 2026-07-20 show the task tree for list move task under parent mark task completed
Docker
docker build -t gtasks-mcp .
docker run -i \ -e GOOGLE_CLIENT_ID=your_client_id \ -e GOOGLE_CLIENT_SECRET=your_client_secret \ -e GOOGLE_REFRESH_TOKEN=your_refresh_token \ gtasks-mcp
Development
npm install
npm run build npm start
Auth check / interactive login:
npm run build
node dist/index.js auth
Security Notes
- Treat refresh tokens like passwords
- Prefer env vars or ignored credential files — never commit them
- Rotate credentials if they leak
Contributors
- ArtyMcLabin — pagination,
taskListIdfiltering,list_task_lists,list_with_tree,move, and file-based auth (#1) - zcaceres — original Google Tasks MCP server
- alvinjchoi — fork maintenance, Smithery/npm packaging
See CONTRIBUTORS.md.
License
MIT