asana-admin-mcp

MCP server para estructurar Asana — portfolio, custom field / dropdown, project, section Cubre el hueco que el conector estándar de Asana no cubre (ese se centra en task/read)

⚠️ Dashboard no es posible — y no es una limitación de este MCP

Asana no expone una API pública para Dashboard / chart / widget / project view tab en absoluto (hemos recorrido los 175 endpoints en la OpenAPI spec oficial — no hay ni uno)

La única forma automatizable es project_duplicate — la spec indica que al duplicar un project, Project Views (pestañas List / Board / Dashboard) siempre se copian y no se pueden desactivar → Configura el Dashboard en un "proyecto plantilla" y haz duplicate cada vez que necesites un proyecto nuevo

🟡 No comprobado: la spec dice que "Project Views" se copian, pero no aclara si los chart configurados en el Dashboard también se copian o solo se obtiene una pestaña vacía — no se puede verificar por API (no hay endpoint para leer chart), hay que mirarlo a ojo el smoke test del 2026-08-17 duplicó un proyecto sin chart, así que aún no responde a esta cuestión

Nota: Project Template no incluye el Dashboard (sigue siendo una feature request pendiente en el foro de Asana) Hay que usar duplicate, no template

Instalación

1. Consigue primero tu token de Asana (cada uno debe tener el suyo)

Sigue GET-TOKEN.md → guárdalo en ~/.asana_token

printf '%s' 'วาง_token_ตรงนี้' > ~/.asana_token && chmod 600 ~/.asana_token

el token está vinculado a permisos individuales no uses el de otra persona — el log de Asana mostrará el nombre del propietario del token

2. Instala el plugin (recomendado)

En Claude Code escribe 2 líneas:

/plugin marketplace add plakorp/asana-admin-mcp
/plugin install asana-admin@asana-admin-mcp

Claude Code clonará el repo + ejecutará npm ci por ti y registrará el MCP — no necesitas tocar ~/.claude.json Para actualizarlo más tarde, usa /plugin update

Necesitas Node 20+ en tu equipo (compruébalo con node -v)

Método 2 — instalación manual (si no quieres usar el plugin)

clona el repo y haz doble clic en ติดตั้ง-asana-admin-mcp.command El script pedirá el token, ejecutará npm install y escribirá ~/.claude.json por ti (con backup en cada ejecución)

No uses los 2 métodos a la vez — tendrás dos MCP llamados asana-admin duplicados

El token se lee primero de la variable de entorno ASANA_TOKEN; si no existe, se hace fallback a ~/.asana_token → el token nunca está en el repo ni necesita estar en ~/.claude.json

Herramientas (21)

Cada tool recibe un gid, no un nombre — usa asana_find para convertir nombre → gid primero

Descubrimiento

Portfolio

Custom field / dropdown

Asana no puede eliminar valores de dropdown — solo se puede usar enabled:false; las tareas que ya tenían ese valor seleccionado conservarán el valor original

Project / Section

No hay ninguna tool para eliminar project / portfolio / custom field a propósito — borrarlos no tiene vuelta atrás, hazlo en la web

Colores (válidos para portfolio / project / enum option)

none red orange yellow-orange yellow yellow-green green blue-green aqua blue indigo purple magenta hot-pink pink cool-gray

Pruebas

ASANA_TOKEN=$(cat ~/.asana_token) npm run smoke

Crea objetos reales en el primer workspace del token con nombres que empiecen por ZZ-mcp-smoke-* → comprueba todas las tools → borra todo tú mismo Si no se proporciona token, solo se ejecutará la primera mitad (server boot + list tools)

Notas de funcionamiento

• 429 → retry automático 3 veces según Retry-After

• los errores de Asana se devuelven como el mensaje real de la API (indica qué field falta / qué gid es incorrecto), no solo el status code

• los campos que no se envían no se tocan — un portfolio_update que solo envía name no limpia el color