asana_get_tasks_for_section

Retrieve all tasks from a specific project section in Asana, with options to filter by completion date, include custom fields, and manage pagination for large task lists.

Instructions

Get all tasks from a specific section in a project

Input Schema

TableJSON Schema

Name	Required	Description
`section_id`	Yes	The section ID to get tasks from
`opt_fields`	No	Comma-separated list of optional fields to include (e.g., 'name,gid,completed,assignee,notes,subtasks')
`completed_since`	No	Only return tasks that are either incomplete or that have been completed since this time (ISO 8601 format)
`limit`	No	Number of results to return per page (1-100)
`offset`	No	Pagination token from previous response. Required for paginated requests
`auto_paginate`	No	If true, automatically gets all pages of results (limited by max_pages)
`max_pages`	No	Maximum pages to fetch when auto_paginate is true

Implementation Reference

src/tool-handler.ts:344-350 (handler)

MCP tool handler case that extracts section_id and options, calls AsanaClientWrapper.getTasksForSection, and returns JSON response.

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

src/asana-client-wrapper.ts:847-856 (handler)

Core Asana API wrapper method that calls the Asana SDK's getTasksForSection with section ID and options, handling basic error logging.

// Metodă nouă pentru a obține task-urile dintr-o secțiune
async getTasksForSection(sectionId: string, opts: any = {}) {
  try {
    const response = await this.tasks.getTasksForSection(sectionId, opts);
    return response.data;
  } catch (error) {
    console.error("Error in getTasksForSection:", error);
    throw error;
  }
}

src/tools/task-tools.ts:456-495 (schema)

Tool schema definition including name, description, and detailed input schema with pagination support.

export const getTasksForSectionTool: Tool = {
  name: "asana_get_tasks_for_section",
  description: "Get all tasks from a specific section in a project",
  inputSchema: {
    type: "object",
    properties: {
      section_id: {
        type: "string",
        description: "The section ID to get tasks from"
      },
      opt_fields: {
        type: "string",
        description: "Comma-separated list of optional fields to include (e.g., 'name,gid,completed,assignee,notes,subtasks')"
      },
      completed_since: {
        type: "string",
        description: "Only return tasks that are either incomplete or that have been completed since this time (ISO 8601 format)"
      },
      limit: {
        type: "number",
        description: "Number of results to return per page (1-100)"
      },
      offset: {
        type: "string",
        description: "Pagination token from previous response. Required for paginated requests"
      },
      auto_paginate: {
        type: "boolean",
        description: "If true, automatically gets all pages of results (limited by max_pages)",
        default: false
      },
      max_pages: {
        type: "number",
        description: "Maximum pages to fetch when auto_paginate is true",
        default: 10
      }
    },
    required: ["section_id"]
  }
};

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

Registration of the tool in the main tools array exported for 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
];

src/utils/validation.ts:346-349 (helper)

Input validation helper that checks section_id is a valid Asana GID.

case 'asana_get_tasks_for_section':
  result = validateGid(params.section_id, 'section_id');
  if (!result.valid) errors.push(...result.errors);
  break;

MCP Server for Asana