MCP Server for Asana

Instructions

Implementation Reference

• src/asana-client-wrapper.ts:619-622 (handler)

  Core handler implementation: wrapper method that calls the Asana SDK's ProjectStatusesApi to fetch all status updates for a project.

  async getProjectStatusesForProject(projectId: string, opts: any = {}) {
    const response = await this.projectStatuses.getProjectStatusesForProject(projectId, opts);
    return response.data;
  }

• src/tool-handler.ts:222-228 (handler)

  Tool dispatch handler: switch case that invokes the AsanaClientWrapper method with destructured arguments and formats the response.

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

• src/tools/project-status-tools.ts:22-49 (schema)

  Tool schema definition: specifies name, description, and input schema for validation.

  export const getProjectStatusesForProjectTool: Tool = {
    name: "asana_get_project_statuses",
    description: "Get all status updates for a project",
    inputSchema: {
      type: "object",
      properties: {
        project_gid: {
          type: "string",
          description: "The project GID to get statuses for"
        },
        limit: {
          type: "number",
          description: "Results per page (1-100)",
          minimum: 1,
          maximum: 100
        },
        offset: {
          type: "string",
          description: "Pagination offset token"
        },
        opt_fields: {
          type: "string",
          description: "Comma-separated list of optional fields to include"
        }
      },
      required: ["project_gid"]
    }
  };

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

  Tool registration: includes the tool in the exported 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:21-25 (registration)

  Import registration: imports the tool definition for use in the handler.

    getProjectStatusTool,
    getProjectStatusesForProjectTool,
    createProjectStatusTool,
    deleteProjectStatusTool
  } from './tools/project-status-tools.js';