addTaskManager MCP Server

Instructions

Implementation Reference

• src/index.ts:967-983 (handler)

  The core handler function `createIdea` that executes the tool logic: constructs a ZenTaskticIdea record with Assess realmId=1, generates UUIDs, sets timestamps and optional collection reference, and returns a mock success response (in production would save to CloudKit).

  private async createIdea(ideaName: string, collectionRecordName?: string) {
    const now = Date.now();
    const ideaRecordName = `idea_ck_${uuidv4()}`;
    const idea: ZenTaskticIdea = {
      recordType: 'Ideas',
      recordName: ideaRecordName,
      fields: {
        ideaName: { value: ideaName },
        realmId: { value: REALM_ASSESS_ID }, // Ideas always start in Assess
        uniqueId: { value: uuidv4() },
        lastModified: { value: now },
        ...(collectionRecordName && { collection: { value: { recordName: collectionRecordName, action: 'NONE' } } }),
      }
    };
    // Mock save: console.log('Mock CloudKit: Creating Idea', idea);
    return { content: [{ type: 'text', text: `Idea "${ideaName}" captured in Assess realm with ID ${ideaRecordName}.` }] };
  }

• src/index.ts:296-305 (schema)

  Input schema definition for the assess_create_idea tool, specifying required 'ideaName' string and optional 'collectionRecordName'.

  name: 'assess_create_idea',
  description: 'Capture a new idea (always starts in Assess realm).',
  inputSchema: {
    type: 'object',
    properties: {
      ideaName: { type: 'string', description: 'Idea name/details (max 1500 chars)' },
      collectionRecordName: { type: 'string', description: 'Optional recordName of the parent collection.' }
    },
    required: ['ideaName']
  }

• src/index.ts:672-674 (registration)

  Tool registration in the CallToolRequestSchema switch statement: validates args and delegates to createIdea handler.

    this.validateArgs(args, ['ideaName']);
    return await this.createIdea(args.ideaName, args.collectionRecordName);
  case 'assess_edit_idea':

• src/index.ts:133-149 (schema)

  TypeScript interface defining the structure of Idea records for CloudKit/Core Data compatibility, used in the handler.

  export interface ZenTaskticIdea {
    recordName?: string;
    recordType: 'Ideas'; // Note: entity name is 'Ideas' in Core Data
    fields: {
      ideaName: { value: string }; // Max 1500 chars, combines original title & body
      realmId: { value: number }; // Integer 16, default 0 (usually REALM_ASSESS_ID)
      uniqueId: { value: string }; // UUID
      lastModified: { value: number }; // Timestamp
      
      // References (relationships in Core Data)
      collection?: { value: CKReference }; // Reference to Collections record
      realm?: { value: CKReference }; // Reference to Realms record
      tasks?: { value: CKReference[] }; // Tasks derived from this idea
      
      // removed createdAt, use lastModified or CloudKit system creationDate
    };
  }

• src/index.ts:296-306 (registration)

  Tool registration entry in the ListToolsRequestSchema response array, exposing the tool with name, description, and schema.

    name: 'assess_create_idea',
    description: 'Capture a new idea (always starts in Assess realm).',
    inputSchema: {
      type: 'object',
      properties: {
        ideaName: { type: 'string', description: 'Idea name/details (max 1500 chars)' },
        collectionRecordName: { type: 'string', description: 'Optional recordName of the parent collection.' }
      },
      required: ['ideaName']
    }
  },