MCP Server for Asana

Instructions

Implementation Reference

• src/asana-client-wrapper.ts:704-771 (handler)

  Core handler implementation in AsanaClientWrapper that fetches users from a workspace using Asana SDK, with full pagination support (limit, offset, auto_paginate), default workspace handling, and opt_fields management.
  async getUsersForWorkspace(workspaceId: string | undefined, 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"); } // Extract pagination parameters const { auto_paginate = false, max_pages = 10, limit, offset, opt_fields, ...otherOpts } = opts; // Build search parameters const searchParams: any = { ...otherOpts }; // Add default opt_fields if not specified if (!opt_fields) { searchParams.opt_fields = "name,email"; } else { searchParams.opt_fields = opt_fields; } // Add pagination parameters if provided if (limit !== undefined) { // Ensure limit is between 1 and 100 searchParams.limit = Math.min(Math.max(1, Number(limit)), 100); } if (offset) searchParams.offset = offset; // Use the paginated results handler for more reliable pagination return await this.handlePaginatedResults( // Initial fetch function () => this.users.getUsersForWorkspace(workspaceId, searchParams), // Next page fetch function (nextOffset) => this.users.getUsersForWorkspace(workspaceId, { ...searchParams, offset: nextOffset }), // Pagination options { auto_paginate, max_pages } ); } catch (error: any) { console.error(`Error getting users for workspace ${workspaceId}: ${error.message}`); // Add detailed error handling for common issues if (error.message?.includes('Not Found')) { throw new Error(`Workspace with ID ${workspaceId} not found or inaccessible.`); } if (error.message?.includes('Bad Request')) { if (opts.limit && (opts.limit < 1 || opts.limit > 100)) { throw new Error(`Invalid limit parameter: ${opts.limit}. Limit must be between 1 and 100.`); } throw new Error(`Error retrieving users for workspace: ${error.message}. Check that all parameters are valid.`); } throw error; } }
• src/tool-handler.ts:494-500 (handler)

  Tool dispatch handler case that destructures arguments and calls the AsanaClientWrapper.getUsersForWorkspace method.
  case "asana_list_workspace_users": { const { workspace_id, ...opts } = args; const response = await asanaClient.getUsersForWorkspace(workspace_id || undefined, opts); return { content: [{ type: "text", text: JSON.stringify(response) }], }; }
• src/tools/user-tools.ts:41-78 (schema)

  Tool schema definition including input schema with support for workspace_id, pagination parameters (limit, offset, auto_paginate, max_pages), and opt_fields.
  export const getUsersForWorkspaceTool: Tool = { name: "asana_list_workspace_users", description: "Get users in a workspace", inputSchema: { type: "object", properties: { workspace_id: { type: "string", description: "The workspace ID to get users for (optional if DEFAULT_WORKSPACE_ID is set)" }, opt_fields: { type: "string", description: "Comma-separated list of optional fields to include (e.g., 'photo,resource_type'). Fields 'name' and 'email' are included by default." }, limit: { type: "number", description: "Maximum number of results to return per page (1-100). Helps prevent timeouts and ensures more reliable responses.", minimum: 1, maximum: 100 }, offset: { type: "string", description: "Pagination token from previous response. Must be the exact token returned in a previous response's next_page.offset field." }, auto_paginate: { type: "boolean", description: "If true, automatically fetches all pages and combines results (limited by max_pages)", default: false }, max_pages: { type: "number", description: "Maximum number of pages to fetch when auto_paginate is true", default: 10 } }, required: [] } };
• src/tool-handler.ts:61-103 (registration)

  Registration of the tool in the main tools array export 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:51-54 (registration)

  Import of the getUsersForWorkspaceTool (named 'asana_list_workspace_users') from user-tools.js.
  getTeamsForUserTool, getTeamsForWorkspaceTool, getUsersForWorkspaceTool } from './tools/user-tools.js';