MCP Server for Asana

Instructions

Implementation Reference

• src/tool-handler.ts:368-396 (handler)

  Handler implementation for the 'asana_create_project' tool. Processes input arguments, normalizes members and followers arrays into Asana API format, and delegates to AsanaClientWrapper.createProjectForWorkspace.

  case "asana_create_project": {
    const { workspace_id, ...projectData } = args;
    
    // Extragem opt_fields pentru opțiuni
    const { opt_fields, ...restData } = projectData;
    
    // Pregătim datele pentru proiect
    const data = {
      ...restData
    };
    
    // Verificăm dacă avem team_id și îl păstrăm, în asana-client-wrapper
    // va fi redenumit automat în team
    
    // Conversia array-urilor în formatul așteptat de API
    if (data.members && Array.isArray(data.members)) {
      data.members = data.members.map((id: string) => ({ gid: id }));
    }
    
    if (data.followers && Array.isArray(data.followers)) {
      data.followers = data.followers.map((id: string) => ({ gid: id }));
    }
    
    const response = await asanaClient.createProjectForWorkspace(workspace_id || undefined, data, { opt_fields });
    
    return {
      content: [{ type: "text", text: JSON.stringify(response) }],
    };
  }

• src/tools/project-tools.ts:125-207 (schema)

  Input schema definition for the 'asana_create_project' tool, specifying parameters like workspace_id, name, team_id, public, etc.

  export const createProjectForWorkspaceTool: Tool = {
    name: "asana_create_project",
    description: "Create a new project in a workspace",
    inputSchema: {
      type: "object",
      properties: {
        workspace_id: {
          type: "string",
          description: "The workspace ID to create the project in (optional if DEFAULT_WORKSPACE_ID is set)"
        },
        name: {
          type: "string",
          description: "Name of the project to create"
        },
        team_id: {
          type: "string",
          description: "REQUIRED for organization workspaces: The team GID to share the project with"
        },
        public: {
          type: "boolean",
          description: "Whether the project is public to the organization",
          default: false
        },
        archived: {
          type: "boolean",
          description: "Whether the project is archived",
          default: false
        },
        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: "list"
        },
        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"
        }
      },
      required: ["name"]
    }
  };

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

  Registration of the tool in the main tools array export. The createProjectForWorkspaceTool (named 'asana_create_project') is included at position corresponding to line 68.

  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/asana-client-wrapper.ts:1176-1224 (helper)

  Core API wrapper method called by the tool handler. Prepares request data (renames team_id to team, handles default workspace), constructs the API body with workspace, and calls Asana SDK's createProject.

  async createProjectForWorkspace(workspaceId: string | undefined, data: any, opts: any = {}) {
    try {
      // Use default workspace if not specified and available
      if (!workspaceId && this.defaultWorkspaceId) {
        workspaceId = this.defaultWorkspaceId;
      }
      
      if (!workspaceId) {
        throw new Error("No workspace specified and no default workspace ID set");
      }
      
      // Pregătim datele pentru cerere
      const requestData = { ...data };
      
      // Redenumim team_id în team dacă există
      if (requestData.team_id) {
        requestData.team = requestData.team_id;
        delete requestData.team_id;
      }
      
      // Asana API are nevoie de parametrii corecți
      const body = {
        data: {
          // Includem workspace direct
          workspace: workspaceId,
          // Includem toate celelalte date dar fără workspace sau workspace_id
          // deoarece sunt deja transmise prin parametrul workspaceId
          ...requestData
        }
      };
      
      // Eliminăm parametrii redundanți dacă există
      delete body.data.workspace_id;
      delete body.data.workspace; // Evităm duplicarea - am pus deja workspaceId ca workspace
      
      // Folosim metoda standard createProject
      const response = await this.projects.createProject(body, opts);
      return response.data;
    } catch (error: any) {
      console.error(`Error creating project for workspace: ${error}`);
      
      // Adăugăm mai multe detalii despre eroare pentru debugging
      if (error.response && error.response.body) {
        console.error(`Response error details: ${JSON.stringify(error.response.body, null, 2)}`);
      }
      
      throw error;
    }
  }