MCP Server for Asana

Instructions

Implementation Reference

• src/tool-handler.ts:398-444 (handler)

  The handler case for 'asana_update_project' that processes input arguments, removes fields requiring separate tools (members, followers, etc.), calls the Asana client's updateProject method, and returns the JSON response or a warning message.

  case "asana_update_project": {
    const { project_id, ...projectData } = args;
    
    // Extragem opt_fields pentru opțiuni
    const { opt_fields, ...restData } = projectData;
    
    // Câmpuri problematice care necesită API-uri separate
    const problematicFields = ['members', 'followers', 'public', 'html_notes', 'start_on'];
    let hasProblematicFields = false;
    
    // Verificăm dacă există câmpuri problematice în datele de actualizare
    for (const field of problematicFields) {
      if (field in restData) {
        // Înlăturăm câmpul problematic din datele trimise către API
        delete restData[field];
        hasProblematicFields = true;
      }
    }
    
    // Pregătim datele pentru actualizare
    const data = {
      ...restData
    };
    
    const response = await asanaClient.updateProject(project_id, data, { opt_fields });
    
    // Avertizare pentru utilizator dacă au fost înlăturate câmpuri problematice
    if (hasProblematicFields) {
      return {
        content: [
          { 
            type: "text", 
            text: "Unele câmpuri nu pot fi actualizate direct prin updateProject și necesită API-uri separate:\n" +
                  "- Pentru a actualiza membrii, folosește asana_add_members_for_project\n" +
                  "- Pentru a actualiza followeri, folosește asana_add_followers_for_project\n" +
                  "- Câmpurile public, html_notes și start_on au de asemenea limitări\n\n" +
                  "Proiectul a fost actualizat cu succes pentru celelalte câmpuri. Iată răspunsul:\n" + 
                  JSON.stringify(response) 
          }
        ],
      };
    }
    
    return {
      content: [{ type: "text", text: JSON.stringify(response) }],
    };
  }

• src/tools/project-tools.ts:209-284 (schema)

  The Tool schema definition for 'asana_update_project', specifying the input parameters, their types, descriptions, and required fields.

  export const updateProjectTool: Tool = {
    name: "asana_update_project",
    description: "Update details of an existing project",
    inputSchema: {
      type: "object",
      properties: {
        project_id: {
          type: "string",
          description: "The project ID to update"
        },
        name: {
          type: "string",
          description: "Updated name of the project"
        },
        public: {
          type: "boolean",
          description: "Whether the project is public to the organization"
        },
        archived: {
          type: "boolean",
          description: "Whether the project is archived"
        },
        color: {
          type: "string",
          description: "Color of the project (light-green, light-orange, light-blue, etc.)"
        },
        members: {
          type: "array",
          items: {
            type: "string"
          },
          description: "Array of user GIDs that are members of this project"
        },
        followers: {
          type: "array",
          items: {
            type: "string"
          },
          description: "Array of user GIDs that are followers of this project"
        },
        project_brief: {
          type: "string",
          description: "HTML-formatted string containing the description for the project brief"
        },
        layout: {
          type: "string",
          description: "The layout of the project (board, list, timeline, or calendar)"
        },
        default_view: {
          type: "string",
          description: "The default view of the project (list, board, calendar, timeline, or gantt)"
        },
        due_on: {
          type: "string",
          description: "The date on which this project is due (YYYY-MM-DD format)"
        },
        start_on: {
          type: "string",
          description: "The day on which work for this project begins (YYYY-MM-DD format)"
        },
        notes: {
          type: "string",
          description: "Free-form textual information associated with the project"
        },
        html_notes: {
          type: "string",
          description: "HTML-formatted notes for the project"
        },
        opt_fields: {
          type: "string",
          description: "Comma-separated list of optional fields to include in the response"
        }
      },
      required: ["project_id"]
    }
  };

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

  Registers 'updateProjectTool' (line 69) in the main exported tools array for MCP tool discovery.

  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:296-299 (helper)

  Validation helper that ensures 'project_id' is a valid Asana GID before executing the tool.

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