MCP Server for Asana

Instructions

Implementation Reference

• src/asana-client-wrapper.ts:70-113 (handler)

  Core implementation of the asana_list_workspaces tool logic in AsanaClientWrapper class. Handles default workspace fallback and full pagination of workspaces via Asana API.
  async listWorkspaces(opts: any = {}) { try { // If DEFAULT_WORKSPACE_ID is set, only return that workspace if (this.defaultWorkspaceId) { console.error(`Using default workspace ID: ${this.defaultWorkspaceId}`); const response = await this.workspaces.getWorkspace(this.defaultWorkspaceId, opts); return [response.data]; // Return as an array with a single workspace } // Extract pagination parameters const { auto_paginate = false, max_pages = 10, limit, offset, ...otherOpts } = opts; // Build search parameters const searchParams: any = { ...otherOpts }; // Add pagination parameters 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.workspaces.getWorkspaces(searchParams), // Next page fetch function (nextOffset) => this.workspaces.getWorkspaces({ ...searchParams, offset: nextOffset }), // Pagination options { auto_paginate, max_pages } ); } catch (error: any) { console.error(`Error listing workspaces: ${error.message}`); throw error; } }
• src/tool-handler.ts:138-143 (handler)

  Tool handler dispatch case that invokes AsanaClientWrapper.listWorkspaces and formats the response.
  case "asana_list_workspaces": { const response = await asanaClient.listWorkspaces(args); return { content: [{ type: "text", text: JSON.stringify(response) }], }; }
• src/tools/workspace-tools.ts:3-15 (schema)

  Defines the input schema, name, and description for the asana_list_workspaces tool.
  export const listWorkspacesTool: Tool = { name: "asana_list_workspaces", description: "List all available workspaces in Asana. If DEFAULT_WORKSPACE_ID is set, only returns that workspace.", inputSchema: { type: "object", properties: { opt_fields: { type: "string", description: "Comma-separated list of optional fields to include" } } } };
• src/tool-handler.ts:61-62 (registration)

  Registers the listWorkspacesTool in the central tools array used for MCP tool exposure.
  export const tools: Tool[] = [ listWorkspacesTool,
• src/asana-client-wrapper.ts:53-68 (helper)

  Helper method used by listWorkspaces for handling pagination of Asana API responses.
  private async handlePaginatedResults<T>( initialFetch: () => Promise<PaginatedResponse<T>>, nextPageFetch: (offset: string) => Promise<PaginatedResponse<T>>, options: PaginationOptions = {} ): Promise<T[]> { try { // Fetch the initial page const initialResponse = await initialFetch(); // Use the pagination utility to handle additional pages if needed return await handlePagination(initialResponse, nextPageFetch, options); } catch (error: any) { console.error(`Error in paginated request: ${error.message}`); throw error; } }