getTask
Retrieve specific tasks from the Godspeed task application by providing a task ID using the API-enabled MCP server.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes |
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>; }