godspeed-mcp

Implementation Reference

• src/index.ts:68-85 (registration)

  Registration of the MCP 'getTask' tool, including input schema and thin wrapper handler that delegates to GodspeedAPI.getTask and formats the response.

  server.tool(
      "getTask",
      {
          id: z.string()
      },
      async ({ id }) => {
          try {
              const result = await godspeedApi.getTask(id);
              return {
                  content: [{ type: "text", text: JSON.stringify(result, null, 2) }]
              };
          } catch (error) {
              return {
                  content: [{ type: "text", text: `Error: ${error instanceof Error ? error.message : String(error)}` }]
              };
          }
      }
  );

• src/godspeed.ts:151-174 (handler)

  Core handler logic for retrieving a task by ID via HTTP GET to the Godspeed API endpoint /tasks/{id}, with authentication and error handling.

  async getTask(id: string): Promise<ApiResponse<Task>> {
      try {
          if (!id) {
              throw new Error('Task ID is required');
          }
  
          const headers = this.getAuthHeaders();
  
          const response = await fetch(`${API_BASE_URL}/tasks/${id}`, {
              method: 'GET',
              headers,
          });
  
          const data = await response.json();
  
          if (!response.ok) {
              throw new Error(data.error || 'Failed to get task');
          }
  
          return data;
      } catch (error) {
          throw new Error(`Get task error: ${error instanceof Error ? error.message : String(error)}`);
      }
  }

• src/index.ts:70-72 (schema)

  Zod input schema for the 'getTask' tool, requiring a string 'id' parameter.

  {
      id: z.string()
  },

• src/types.ts:6-23 (schema)

  TypeScript interface defining the Task object returned by the getTask tool.

  export interface Task {
      id?: string;
      title: string;
      list_id: string;
      location?: string;
      notes?: string;
      due_at?: Date;
      timeless_due_at?: string;
      starts_at?: Date;
      timeless_starts_at?: string;
      duration_minutes?: number;
      label_names?: string[];
      label_ids?: string[];
      metadata?: Record<string, any>;
      completed?: boolean;
      created_at?: Date;
      updated_at?: Date;
  }

• src/types.ts:76-82 (schema)

  TypeScript interface for the API response wrapper used in getTask return type.

  export interface ApiResponse<T> {
      data: T;
      success: boolean;
      error?: string;
      lists?: Record<string, TaskList>;
      labels?: Record<string, Label>;
  }