MCP Server for Asana

Instructions

Implementation Reference

• src/tools/project-tools.ts:64-81 (schema)

  Tool schema definition including name, description, and input schema for asana_get_project_task_counts

  export const getProjectTaskCountsTool: Tool = {
    name: "asana_get_project_task_counts",
    description: "Get the number of tasks in a project",
    inputSchema: {
      type: "object",
      properties: {
        project_id: {
          type: "string",
          description: "The project ID to get task counts for"
        },
        opt_fields: {
          type: "string",
          description: "Comma-separated list of optional fields to include"
        }
      },
      required: ["project_id"]
    }
  };

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

  Registration of all tools including getProjectTaskCountsTool in the tools array used by 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
  ];

• src/tool-handler.ts:206-212 (handler)

  Dispatch handler case in tool_handler switch that extracts parameters and calls AsanaClientWrapper.getProjectTaskCounts

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

• src/asana-client-wrapper.ts:431-445 (handler)

  Core implementation of getProjectTaskCounts in AsanaClientWrapper, calling Asana SDK's getTaskCountsForProject with appropriate opt_fields

  async getProjectTaskCounts(projectId: string, opts: any = {}) {
    // Ensure we always include essential opt_fields for task counts
    // See: https://developers.asana.com/reference/gettaskcountsforproject
    const options = {
      opt_fields: 'num_tasks,num_incomplete_tasks,num_completed_tasks,num_milestones,num_incomplete_milestones,num_completed_milestones'
    };
    
    // If caller provided specific opt_fields, use those instead
    if (opts.opt_fields) {
      options.opt_fields = opts.opt_fields;
    }
    
    const response = await this.projects.getTaskCountsForProject(projectId, options);
    return response.data;
  }

• src/utils/validation.ts:266-270 (helper)

  Validation logic for project_id parameter in validateProjectParameters function

  case 'asana_get_project_task_counts':
  case 'asana_get_project_sections':
    result = validateGid(params.project_id, 'project_id');
    if (!result.valid) errors.push(...result.errors);
    break;