MCP Server for Asana

Instructions

Implementation Reference

• src/asana-client-wrapper.ts:635-648 (handler)

  Core handler function that fetches multiple tasks in parallel using Promise.all on individual getTask calls, with limit check for max 25 tasks.

  async getMultipleTasksByGid(taskIds: any, opts: any = {}) {
    const taskIdsArray = this.ensureArray(taskIds);
    
    if (taskIdsArray.length > 25) {
      throw new Error("Maximum of 25 task IDs allowed");
    }
  
    // Use Promise.all to fetch tasks in parallel
    const tasks = await Promise.all(
      taskIdsArray.map(taskId => this.getTask(taskId, opts))
    );
  
    return tasks;
  }

• src/tool-handler.ts:286-296 (handler)

  Tool dispatching handler that normalizes task_ids input (array or comma-separated string) and delegates to AsanaClientWrapper.getMultipleTasksByGid.

  case "asana_get_multiple_tasks_by_gid": {
    const { task_ids, ...opts } = args;
    // Handle both array and string input
    const taskIdList = Array.isArray(task_ids)
      ? task_ids
      : task_ids.split(',').map((id: string) => id.trim()).filter((id: string) => id.length > 0);
    const response = await asanaClient.getMultipleTasksByGid(taskIdList, opts);
    return {
      content: [{ type: "text", text: JSON.stringify(response) }],
    };
  }

• src/tools/task-tools.ts:402-431 (schema)

  Input schema definition for the tool, supporting task_ids as array (max 25 items) or comma-separated string, with optional opt_fields.

  export const getMultipleTasksByGidTool: Tool = {
    name: "asana_get_multiple_tasks_by_gid",
    description: "Get detailed information about multiple tasks by their GIDs (maximum 25 tasks)",
    inputSchema: {
      type: "object",
      properties: {
        task_ids: {
          oneOf: [
            {
              type: "array",
              items: {
                type: "string"
              },
              maxItems: 25
            },
            {
              type: "string",
              description: "Comma-separated list of task GIDs (max 25)"
            }
          ],
          description: "Array or comma-separated string of task GIDs to retrieve (max 25)"
        },
        opt_fields: {
          type: "string",
          description: "Comma-separated list of optional fields to include"
        }
      },
      required: ["task_ids"]
    }
  };

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

  Registration of all tools including getMultipleTasksByGidTool in the main tools array exported for MCP.

  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
  ];