El catálogo/Asana
Asana
app.asana
Asana project management — manage tasks, projects, workspaces, sections, and users.
Versión2.0.0
Categoríaproject-management
AutenticaciónClave de API
Herramientas18
Transportestdio
LicenciaMIT
02
Herramientas
18 herramientas que el agente puede llamar.
Todas se declaran con parámetros tipados y devuelven resultados estructurados, así que el anfitrión puede renderizarlas en vez de narrarlas.
- add-followersAdd followers to an Asana task (POST /tasks/{taskId}/addFollowers). Returns the updated task. Params: taskId (required), followers (required — array of user GIDs).
- add-tag-to-taskAdd a tag to an Asana task (POST /tasks/{taskId}/addTag). Returns an empty object on success. Params: taskId (required), tagId (required).
- add-task-to-sectionAdd a task to a section in an Asana project (POST /sections/{sectionId}/addTask). Returns an empty object on success. Params: sectionId (required), taskId (required).
- create-sectionCreate a new section in an Asana project (POST /projects/{projectId}/sections). Returns the created section. Params: projectId (required), name (required).
- create-tagCreate a new tag in an Asana workspace (POST /tags). Returns the created tag. Params: name (required), workspaceId (required), color? (optional — e.g. "dark-pink", "dark-green", "none").
- create-taskCreate a new Asana task (POST /tasks). Returns the created task. Params: name (required — task title), projects? (array of project GIDs), workspace? (workspace GID — required if projects is not set), notes? (task description), assignee? (user GID or email).
- delete-taskDelete an Asana task by GID (DELETE /tasks/{taskId}). Returns an empty object on success. Params: taskId (required).
- get-projectGet a single Asana project by GID (GET /projects/{projectId}). Returns the project with gid, name, notes, owner, workspace, etc. Params: projectId (required).
- get-taskGet a single Asana task by GID (GET /tasks/{taskId}). Returns the task with gid, name, notes, assignee, completed, due_on, projects, etc. Params: taskId (required).
- get-userGet the currently authenticated Asana user (GET /users/me). Returns the user with gid, name, email, and workspaces.
- list-projectsList projects in an Asana workspace (GET /projects?workspace={workspaceId}). Returns an array of projects with gid, name, and resource_type. Params: workspaceId (required).
- list-sectionsList sections in an Asana project (GET /projects/{projectId}/sections). Returns an array of sections with gid and name. Params: projectId (required).
- list-tagsList tags in an Asana workspace (GET /tags?workspace={workspaceId}). Returns an array of tags with gid, name, and color. Params: workspaceId (required).
- list-tasksList tasks in an Asana project (GET /tasks?project={projectId}). Returns an array of tasks with gid, name, and resource_type. Params: projectId (required).
- list-teamsList teams in an Asana organization (GET /organizations/{workspaceId}/teams). Returns an array of teams with gid and name. Params: workspaceId (required — must be an organization workspace).
- list-workspacesList all Asana workspaces accessible to the authenticated user (GET /workspaces). Returns an array of workspaces with gid, name, and is_organization.
- search-tasksSearch tasks in an Asana workspace (GET /workspaces/{workspaceId}/tasks/search). Returns matching tasks. Params: workspaceId (required), text? (search string), completed? (boolean), assignee? (user GID or "me"), projectId? (filter by project GID), sectionId? (filter by section GID), isSubtask? (boolean).
- update-taskUpdate an existing Asana task (PUT /tasks/{taskId}). Returns the updated task. Params: taskId (required), name? (new title), completed? (boolean), notes? (new description).
03
Autenticación y permisos
Qué pide.
Declarado en el manifiesto y por adelantado. La aplicación no puede alcanzar nada que no haya pedido aquí.
Secretos de usuario
ACCESS_TOKEN
Seguir leyendo
El manifiesto y el código de Asana están en el monorepo, junto al resto de aplicaciones.