addTaskManager MCP Server

Instructions

Implementation Reference

• src/index.ts:587-591 (registration)

  Tool registration including name, description, and input schema (empty object)
  { name: 'get_collections', description: 'Get all collections.', inputSchema: { type: 'object', properties: {} } },
• src/index.ts:1381-1411 (handler)

  Primary MCP tool handler for 'get_collections'. Dispatches to CloudKitService in production mode or returns mock data in development. Formats results as text response.
  private async getCollections() { return this.withCloudKitOrMock( 'getCollections', async () => { // CloudKit production implementation const collections = await this.cloudKitService.getCollections(); let response = `All collections:\n`; if (collections.length === 0) { response += 'No collections found. Create some to organize your tasks! 📋'; } else { response += collections.map((collection: any) => { const name = collection.fields?.collectionName?.value || 'Unnamed Collection'; return `- ${name} (${collection.recordName})`; }).join('\n'); } return { content: [{ type: 'text', text: response }] }; }, async () => { // Mock implementation const mockCollections = [ { recordName: 'collection_1', collectionName: 'Work Projects' }, { recordName: 'collection_2', collectionName: 'Personal Goals' }, { recordName: 'collection_3', collectionName: 'Done' } ]; return { content: [{ type: 'text', text: `All collections:\n${mockCollections.map(c => `- ${c.collectionName} (${c.recordName})`).join('\n')}` }] }; } ); }
• src/index.ts:758-759 (handler)

  Dispatch from MCP CallToolRequestSchema switch statement to the getCollections handler method
  return await this.getCollections(); case 'get_tasks_by_context':
• src/services/CloudKitService.ts:436-440 (helper)

  CloudKitService helper method queried by MCP handler. Performs sorted query on 'Collections' record type.
  async getCollections(): Promise<any[]> { return this.queryRecords('Collections', { sortBy: [{ fieldName: 'collectionName', ascending: true }] }); }
• src/index.ts:165-179 (schema)

  TypeScript interface defining the structure of Collection records from CloudKit/CoreData model.
  interface ZenTaskticCollection { recordName?: string; recordType: 'Collections'; fields: { collectionName: { value: string }; // Collection name uniqueId: { value: string }; // UUID, max 58 chars creationDate?: { value: number }; // Timestamp lastModified: { value: number }; // Timestamp // References (relationships in Core Data) ideas?: { value: CKReference[] }; // List of references to Ideas records projects?: { value: CKReference[] }; // List of references to Projects records tasks?: { value: CKReference[] }; // List of references to Task records }; }