asana_get_subtasks_for_task

Retrieve subtasks for any Asana task to track progress, assign responsibilities, and manage dependencies within projects.

Instructions

Get the list of subtasks for a specific task

Input Schema

TableJSON Schema

Name	Required	Description
`task_id`	Yes	ID of the task to get subtasks for
`opt_fields`	No	Optional fields for subtasks (e.g. 'name,notes,assignee,due_on,completed')
`limit`	No	Maximum number of results per page (1-100)
`offset`	No	Pagination token from previous response
`auto_paginate`	No	If true, automatically gets all pages and combines results

Implementation Reference

src/tool-handler.ts:360-366 (handler)

MCP tool handler switch case that destructures input arguments (task_id and opts), calls AsanaClientWrapper.getSubtasksForTask(), and returns the JSON-stringified response.

case "asana_get_subtasks_for_task": {
  const { task_id, ...opts } = args;
  const response = await asanaClient.getSubtasksForTask(task_id, opts);
  return {
    content: [{ type: "text", text: JSON.stringify(response) }],
  };
}

src/asana-client-wrapper.ts:604-612 (helper)

Core implementation in AsanaClientWrapper that calls the Asana SDK TasksApi.getSubtasksForTask(taskId, opts) and returns the data, with basic error handling.

async getSubtasksForTask(taskId: string, opts: any = {}) {
  try {
    const response = await this.tasks.getSubtasksForTask(taskId, opts);
    return response.data;
  } catch (error) {
    console.error("Error in getSubtasksForTask:", error);
    throw error;
  }
}

src/tools/task-tools.ts:577-607 (schema)

Tool schema definition including name, description, and inputSchema with required task_id and optional pagination/fields parameters.

export const getSubtasksForTaskTool: Tool = {
  name: "asana_get_subtasks_for_task",
  description: "Get the list of subtasks for a specific task",
  inputSchema: {
    type: "object",
    properties: {
      task_id: {
        type: "string",
        description: "ID of the task to get subtasks for"
      },
      opt_fields: {
        type: "string",
        description: "Optional fields for subtasks (e.g. 'name,notes,assignee,due_on,completed')"
      },
      limit: {
        type: "number",
        description: "Maximum number of results per page (1-100)"
      },
      offset: {
        type: "string",
        description: "Pagination token from previous response"
      },
      auto_paginate: {
        type: "boolean",
        description: "If true, automatically gets all pages and combines results",
        default: false
      }
    },
    required: ["task_id"]
  }
};

src/tool-handler.ts:61-103 (registration)

Tool registration in the exported tools array that includes getSubtasksForTaskTool (imported from task-tools.ts), making it available to the MCP server.

export const tools: Tool[] = [
  listWorkspacesTool,
  searchProjectsTool,
  getProjectTool,
  getProjectTaskCountsTool,
  getProjectSectionsTool,
  createSectionForProjectTool,
  createProjectForWorkspaceTool,
  updateProjectTool,
  reorderSectionsTool,
  getProjectStatusTool,
  getProjectStatusesForProjectTool,
  createProjectStatusTool,
  deleteProjectStatusTool,
  searchTasksTool,
  getTaskTool,
  createTaskTool,
  updateTaskTool,
  createSubtaskTool,
  getMultipleTasksByGidTool,
  addTaskToSectionTool,
  getTasksForSectionTool,
  getProjectHierarchyTool,
  getSubtasksForTaskTool,
  getTasksForProjectTool,
  getTasksForTagTool,
  getTagsForWorkspaceTool,
  addTagsToTaskTool,
  addTaskDependenciesTool,
  addTaskDependentsTool,
  setParentForTaskTool,
  addFollowersToTaskTool,
  getStoriesForTaskTool,
  createTaskStoryTool,
  getTeamsForUserTool,
  getTeamsForWorkspaceTool,
  addMembersForProjectTool,
  addFollowersForProjectTool,
  getUsersForWorkspaceTool,
  getAttachmentsForObjectTool,
  uploadAttachmentForObjectTool,
  downloadAttachmentTool
];

MCP Server for Asana