addTaskManager MCP Server

Instructions

Implementation Reference

• src/index.ts:307-317 (registration)

  Tool registration including name, description, and input schema definition.
  { name: 'assess_create_collection', description: 'Create a new collection in Assess realm.', inputSchema: { type: 'object', properties: { collectionName: { type: 'string', description: 'Collection name' } }, required: ['collectionName'] } },
• src/index.ts:1326-1330 (handler)

  The main handler function that executes the tool. Currently a mock implementation that generates a record name and returns a success message. In production, this would use CloudKitService.saveRecord().
  private async createCollection(collectionName: string) { const recordName = `collection_${uuidv4()}`; // Mock collection creation via CloudKit return { content: [{ type: 'text', text: `Collection "${collectionName}" created with recordName: ${recordName}` }] }; }
• src/index.ts:165-179 (schema)

  TypeScript interface defining the structure of a Collections record for CloudKit, used in create operations.
  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 }; }
• src/index.ts:677-679 (handler)

  Dispatch handler in the main tool switch statement that validates arguments and calls the createCollection method.
  case 'assess_create_collection': this.validateArgs(args, ['collectionName']); return await this.createCollection(args.collectionName);
• src/services/CloudKitService.ts:436-440 (helper)

  Supporting method in CloudKitService for querying collections, which would be used alongside create operations in a full implementation.
  async getCollections(): Promise<any[]> { return this.queryRecords('Collections', { sortBy: [{ fieldName: 'collectionName', ascending: true }] }); }