MCP Server for Asana

Instructions

Implementation Reference

• src/tool-handler.ts:336-342 (handler)

  MCP tool handler case that destructures input parameters (section_id, task_id, opts) and delegates execution to AsanaClientWrapper.addTaskToSection method.

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

• src/asana-client-wrapper.ts:811-845 (handler)

  Core execution logic: constructs request data with task GID and insert_before:null, calls Asana SectionsApi.addTaskForSection or fallback direct HTTP POST to /sections/{sectionId}/addTask endpoint.

  async addTaskToSection(sectionId: string, taskId: string, opts: any = {}) {
    const data = {
      data: {
        task: taskId,
        insert_before: null
      }
    };
    try {
      const response = await this.sections.addTaskForSection(sectionId, data, opts);
      return response.data;
    } catch (error) {
      console.error("Error in addTaskToSection:", error);
      // Dacă obținem eroare, încercăm metoda alternativă folosind callApi direct
      try {
        const client = Asana.ApiClient.instance;
        const response = await client.callApi(
          `/sections/${sectionId}/addTask`,
          'POST',
          { section_gid: sectionId },
          {},
          {},
          {},
          { data: { task: taskId, insert_before: null } },
          ['token'],
          ['application/json'],
          ['application/json'],
          'Blob'
        );
        return response.data;
      } catch (fallbackError) {
        console.error("Error in fallback method:", fallbackError);
        throw fallbackError;
      }
    }
  }

• src/tools/task-tools.ts:433-454 (schema)

  Tool schema definition including name, description, and inputSchema specifying required section_id and task_id parameters.

  export const addTaskToSectionTool: Tool = {
    name: "asana_add_task_to_section",
    description: "Add a task to a specific section in a project",
    inputSchema: {
      type: "object",
      properties: {
        section_id: {
          type: "string",
          description: "The section ID to add the task to"
        },
        task_id: {
          type: "string",
          description: "The task ID to add to the section"
        },
        opt_fields: {
          type: "string",
          description: "Comma-separated list of optional fields to include"
        }
      },
      required: ["section_id", "task_id"]
    }
  };

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

  Tool registration: imports addTaskToSectionTool from task-tools.ts (line 33) and includes it in the exported tools array used for MCP tool registration.

  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:338-344 (helper)

  Input validation helper: ensures task_id and section_id are valid Asana GIDs in validateSectionParameters.

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