AiDD MCP Server

Instructions

Input Schema

Input Schema (JSON Schema)

Implementation Reference

• src/index-aidd.ts:1139-1167 (handler)

  The main handler function for the 'status' tool. Checks if the user is signed in using the backend client's auth manager and returns formatted status information or connection instructions.
  private async handleStatus() { try { const authManager = (this.backendClient as any).authManager; const isSignedIn = authManager.isSignedIn(); if (isSignedIn) { const info = authManager.getUserInfo(); return { content: [{ type: 'text', text: `✅ Connected to AiDD\n\n📧 Email: ${info.email || 'Unknown'}\n💎 Subscription: ${info.subscription || 'FREE'}\n🔑 User ID: ${info.userId || 'Unknown'}\n\nReady to process your tasks!`, } as TextContent], }; } else { return { content: [{ type: 'text', text: '❌ Not connected to AiDD\n\nUse the connect tool to sign in.', } as TextContent], }; } } catch (error) { return { content: [{ type: 'text', text: `❌ Error checking status: ${error instanceof Error ? error.message : 'Unknown error'}`, } as TextContent], }; }
• src/index-aidd.ts:414-417 (registration)

  Registration of the 'status' tool in the getTools() method, including name, description, and input schema.
  name: 'status', description: 'Check authentication status and account information', inputSchema: { type: 'object', properties: {} }, },
• src/index-oauth-browser.ts:556-580 (handler)

  Inline handler for 'status' tool in the OAuth browser authentication server variant.
  case 'status': if (!this.authState.accessToken) { return { content: [{ type: 'text', text: '❌ Not authenticated\n\nUse the "connect" command to sign in to your AiDD account.' }] }; } const expiresIn = this.authState.expiresAt ? Math.floor((this.authState.expiresAt - Date.now()) / 1000 / 60) : 0; return { content: [{ type: 'text', text: `✅ Connected to AiDD\n\n` + `📧 Email: ${this.authState.email}\n` + `💎 Subscription: ${this.authState.subscription}\n` + `🔑 User ID: ${this.authState.userId}\n` + `⏰ Token expires in: ${expiresIn} minutes\n\n` + `Ready to process your Apple Notes!` }] };
• src/index-oauth-browser.ts:396-402 (registration)

  Tool registration in the OAuth browser server.
  name: 'status', description: 'Check current authentication status and subscription level', inputSchema: { type: 'object', properties: {} } },
• src/index-aidd.ts:416-1043 (registration)

  Input schema definition for the 'status' tool (empty object as it takes no parameters).
  inputSchema: { type: 'object', properties: {} }, }, { name: 'check_backend_health', description: 'Check AiDD backend service health and connectivity', inputSchema: { type: 'object', properties: {} }, }, ]; } private getResources(): Resource[] { return [ { uri: 'aidd://notes', name: 'Notes', description: 'All notes from your AiDD account', mimeType: 'application/json', }, { uri: 'aidd://action-items', name: 'Action Items', description: 'All action items from your AiDD account', mimeType: 'application/json', }, { uri: 'aidd://tasks', name: 'Tasks', description: 'All ADHD-optimized tasks from your AiDD account', mimeType: 'application/json', }, { uri: 'aidd://backend/health', name: 'Backend Health', description: 'AiDD backend service health status', mimeType: 'application/json', }, ]; } // ============================================================================= // NOTES MANAGEMENT HANDLERS // ============================================================================= private async handleListNotes(args: any) { try { const notes = await this.backendClient.listNotes(args); const response = ` 📝 **Notes Retrieved** **Total notes:** ${notes.length} ${notes.slice(0, 10).map((note: any, i: number) => ` ${i + 1}. **${note.title}** • ID: ${note.id} • Category: ${note.category || 'personal'} • Created: ${new Date(note.createdAt).toLocaleDateString()} ${note.tags && note.tags.length > 0 ? `• Tags: ${note.tags.join(', ')}` : ''} `).join('\n')} ${notes.length > 10 ? `\n... and ${notes.length - 10} more notes` : ''} `; return { content: [{ type: 'text', text: response, } as TextContent], }; } catch (error) { return { content: [{ type: 'text', text: `❌ Error listing notes: ${error instanceof Error ? error.message : 'Unknown error'}`, } as TextContent], }; } } private async handleReadNote(args: any) { try { const note = await this.backendClient.readNote(args.noteId); const response = ` 📄 **Note Details** **Title:** ${note.title} **ID:** ${note.id} **Category:** ${note.category || 'personal'} **Created:** ${new Date(note.createdAt).toLocaleDateString()} ${note.tags && note.tags.length > 0 ? `**Tags:** ${note.tags.join(', ')}` : ''} **Content:** ${note.content} `; return { content: [{ type: 'text', text: response, } as TextContent], }; } catch (error) { return { content: [{ type: 'text', text: `❌ Error reading note: ${error instanceof Error ? error.message : 'Unknown error'}`, } as TextContent], }; } } private async handleCreateNote(args: any) { try { const note = await this.backendClient.createNote(args); const response = ` ✅ **Note Created** **Title:** ${note.title} **ID:** ${note.id} **Category:** ${note.category || 'personal'} ${note.tags && note.tags.length > 0 ? `**Tags:** ${note.tags.join(', ')}` : ''} The note has been saved to your AiDD account. `; return { content: [{ type: 'text', text: response, } as TextContent], }; } catch (error) { return { content: [{ type: 'text', text: `❌ Error creating note: ${error instanceof Error ? error.message : 'Unknown error'}`, } as TextContent], }; } } private async handleImportAppleNotes(args: any) { const { folder, query, limit = 50, saveAs = 'notes' } = args; // Build AppleScript query let searchCondition = ''; if (query && query !== '*') { searchCondition = `whose body contains "${query}" or name contains "${query}"`; } const script = ` on run tell application "Notes" set output to "[" set noteCount to 0 set maxCount to ${limit} ${folder ? `set targetFolder to folder "${folder}" set allNotes to notes of targetFolder ${searchCondition}` : `set allNotes to every note ${searchCondition}` } repeat with aNote in allNotes if noteCount ≥ maxCount then exit repeat set noteTitle to name of aNote as string set noteId to id of aNote as string set noteBody to body of aNote as string -- Escape JSON special characters set noteTitle to my escapeJSON(noteTitle) set noteBody to my escapeJSON(noteBody) set noteId to my escapeJSON(noteId) if noteCount > 0 then set output to output & "," set output to output & "{\\"id\\":\\"" & noteId & "\\",\\"title\\":\\"" & noteTitle & "\\",\\"content\\":\\"" & noteBody & "\\"}" set noteCount to noteCount + 1 end repeat set output to output & "]" return output end tell end run on escapeJSON(str) set str to my replace(str, "\\\\", "\\\\\\\\") set str to my replace(str, "\\"", "\\\\\\"") set str to my replace(str, return, "\\\\n") set str to my replace(str, linefeed, "\\\\n") set str to my replace(str, tab, "\\\\t") return str end escapeJSON on replace(str, find, replacement) set text item delimiters to find set pieces to text items of str set text item delimiters to replacement set str to pieces as string set text item delimiters to "" return str end replace `; try { const result = await execAppleScript(script); const notes = JSON.parse(result); if (saveAs === 'action-items') { // Extract action items directly const actionItems = await this.backendClient.extractActionItems(notes); const response = ` 📥 **Apple Notes Imported & Converted to Action Items** **Summary:** • Notes imported: ${notes.length} ${folder ? `• From folder: ${folder}` : '• From: All folders'} ${query ? `• Search filter: "${query}"` : ''} • Action items extracted: ${actionItems.length} **Extracted Action Items:** ${actionItems.slice(0, 10).map((item: any, i: number) => ` ${i + 1}. **${item.title}** • Priority: ${item.priority} • Category: ${item.category} ${item.dueDate ? `• Due: ${item.dueDate}` : ''} `).join('\n')} ${actionItems.length > 10 ? `\n... and ${actionItems.length - 10} more items` : ''} Action items have been saved to your AiDD account. `; return { content: [{ type: 'text', text: response, } as TextContent], }; } else { // Save as notes const savedNotes = []; for (const note of notes) { try { const saved = await this.backendClient.createNote({ title: note.title, content: note.content, tags: [], category: 'personal', }); savedNotes.push(saved); } catch (error) { console.error(`Failed to save note: ${note.title}`, error); } } const response = ` 📥 **Apple Notes Imported & Saved** **Summary:** • Notes imported: ${notes.length} ${folder ? `• From folder: ${folder}` : '• From: All folders'} ${query ? `• Search filter: "${query}"` : ''} • Notes saved: ${savedNotes.length} **Saved Notes:** ${savedNotes.slice(0, 10).map((note: any, i: number) => ` ${i + 1}. **${note.title}** • ID: ${note.id} • Category: ${note.category} `).join('\n')} ${savedNotes.length > 10 ? `\n... and ${savedNotes.length - 10} more notes` : ''} Notes have been saved to your AiDD account. `; return { content: [{ type: 'text', text: response, } as TextContent], }; } } catch (error) { return { content: [{ type: 'text', text: `❌ Error importing notes: ${error instanceof Error ? error.message : 'Unknown error'}`, } as TextContent], }; } } // ============================================================================= // ACTION ITEMS MANAGEMENT HANDLERS // ============================================================================= private async handleListActionItems(args: any) { try { const actionItems = await this.backendClient.listActionItems(args); const response = ` 📋 **Action Items Retrieved** **Total action items:** ${actionItems.length} ${actionItems.slice(0, 10).map((item: any, i: number) => ` ${i + 1}. **${item.title}** • ID: ${item.id} • Priority: ${item.priority} • Category: ${item.category} ${item.dueDate ? `• Due: ${new Date(item.dueDate).toLocaleDateString()}` : ''} ${item.tags && item.tags.length > 0 ? `• Tags: ${item.tags.join(', ')}` : ''} `).join('\n')} ${actionItems.length > 10 ? `\n... and ${actionItems.length - 10} more items` : ''} `; return { content: [{ type: 'text', text: response, } as TextContent], }; } catch (error) { return { content: [{ type: 'text', text: `❌ Error listing action items: ${error instanceof Error ? error.message : 'Unknown error'}`, } as TextContent], }; } } private async handleReadActionItem(args: any) { try { const item = await this.backendClient.readActionItem(args.actionItemId); const response = ` 📋 **Action Item Details** **Title:** ${item.title} **ID:** ${item.id} **Priority:** ${item.priority} **Category:** ${item.category} ${item.dueDate ? `**Due Date:** ${new Date(item.dueDate).toLocaleDateString()}` : ''} ${item.tags && item.tags.length > 0 ? `**Tags:** ${item.tags.join(', ')}` : ''} **Description:** ${item.description || 'No description'} `; return { content: [{ type: 'text', text: response, } as TextContent], }; } catch (error) { return { content: [{ type: 'text', text: `❌ Error reading action item: ${error instanceof Error ? error.message : 'Unknown error'}`, } as TextContent], }; } } private async handleExtractActionItems(args: any) { try { const { source, noteIds, text, extractionMode = 'adhd-optimized' } = args; let notesToProcess: any[] = []; if (source === 'notes') { if (!noteIds || noteIds.length === 0) { // Get all notes const allNotes = await this.backendClient.listNotes({}); notesToProcess = allNotes; } else { // Get specific notes for (const noteId of noteIds) { const note = await this.backendClient.readNote(noteId); notesToProcess.push(note); } } } else if (source === 'text') { if (!text) { throw new Error('Text content is required when source is "text"'); } notesToProcess = [{ id: 'temp', title: 'User Provided Text', content: text, }]; } const actionItems = await this.backendClient.extractActionItems(notesToProcess); // Collect all action item IDs for potential follow-up operations const actionItemIds = actionItems.map((item: any) => item.id).filter(Boolean); const response = ` 🔍 **Action Items Extracted** **Summary:** • Source: ${source === 'notes' ? `${notesToProcess.length} notes` : 'provided text'} • Extraction mode: ${extractionMode} • Action items found: ${actionItems.length} **Extracted Action Items:** ${actionItems.slice(0, 10).map((item: any, i: number) => ` ${i + 1}. **${item.title}** • ID: ${item.id} • Priority: ${item.priority} • Category: ${item.category} • Confidence: ${(item.confidence * 100).toFixed(0)}% ${item.dueDate ? `• Due: ${item.dueDate}` : ''} ${item.tags && item.tags.length > 0 ? `• Tags: ${item.tags.join(', ')}` : ''} `).join('\n')} ${actionItems.length > 10 ? `\n... and ${actionItems.length - 10} more items` : ''} Action items have been saved to your AiDD account. **Action Item IDs (for convert_to_tasks):** ${JSON.stringify(actionItemIds)} `; return { content: [{ type: 'text', text: response, } as TextContent], }; } catch (error) { return { content: [{ type: 'text', text: `❌ Error extracting action items: ${error instanceof Error ? error.message : 'Unknown error'}`, } as TextContent], }; } } // ============================================================================= // TASKS MANAGEMENT HANDLERS // ============================================================================= private async handleListTasks(args: any) { try { const tasks = await this.backendClient.listTasks(args); const response = ` ✅ **Tasks Retrieved** **Total tasks:** ${tasks.length} ${tasks.slice(0, 10).map((task: any, i: number) => ` ${i + 1}. **${task.title}** • ID: ${task.id} ${task.score !== undefined ? `• Score: ${task.score}/100` : ''} ${task.estimatedTime ? `• Time: ${task.estimatedTime} min` : ''} ${task.energyRequired ? `• Energy: ${task.energyRequired}` : ''} ${task.dueDate ? `• Due: ${new Date(task.dueDate).toLocaleDateString()}` : ''} `).join('\n')} ${tasks.length > 10 ? `\n... and ${tasks.length - 10} more tasks` : ''} `; return { content: [{ type: 'text', text: response, } as TextContent], }; } catch (error) { return { content: [{ type: 'text', text: `❌ Error listing tasks: ${error instanceof Error ? error.message : 'Unknown error'}`, } as TextContent], }; } } private async handleReadTask(args: any) { try { const task = await this.backendClient.readTask(args.taskId); const response = ` ✅ **Task Details** **Title:** ${task.title} **ID:** ${task.id} ${task.score !== undefined ? `**Score:** ${task.score}/100` : ''} ${task.estimatedTime ? `**Estimated Time:** ${task.estimatedTime} minutes` : ''} ${task.energyRequired ? `**Energy Required:** ${task.energyRequired}` : ''} ${task.taskType ? `**Task Type:** ${task.taskType}` : ''} ${task.dueDate ? `**Due Date:** ${new Date(task.dueDate).toLocaleDateString()}` : ''} ${task.tags && task.tags.length > 0 ? `**Tags:** ${task.tags.join(', ')}` : ''} **Description:** ${task.description || 'No description'} ${task.dependsOnTaskOrders && task.dependsOnTaskOrders.length > 0 ? `**Dependencies:** Tasks ${task.dependsOnTaskOrders.join(', ')}` : ''} `; return { content: [{ type: 'text', text: response, } as TextContent], }; } catch (error) { return { content: [{ type: 'text', text: `❌ Error reading task: ${error instanceof Error ? error.message : 'Unknown error'}`, } as TextContent], }; } } private async handleConvertToTasks(args: any) { try { const { actionItemIds, breakdownMode = 'adhd-optimized' } = args; let actionItems: any[] = []; if (!actionItemIds || actionItemIds.length === 0) { // Convert all action items actionItems = await this.backendClient.listActionItems({}); } else { // Convert specific action items for (const id of actionItemIds) { const item = await this.backendClient.readActionItem(id); actionItems.push(item); } } const tasks = await this.backendClient.convertToTasks(actionItems); const response = ` ✨ **Tasks Created (ADHD-Optimized)** **Summary:** • Action items converted: ${actionItems.length} • Tasks created: ${tasks.length} • Breakdown mode: ${breakdownMode} • Average tasks per item: ${(tasks.length / actionItems.length).toFixed(1)} **Created Tasks:** ${tasks.slice(0, 15).map((task: any, i: number) => ` ${i + 1}. **${task.title}** • Time: ${task.estimatedTime} min • Energy: ${task.energyRequired} • Type: ${task.taskType} ${task.dependsOnTaskOrders && task.dependsOnTaskOrders.length > 0 ? `• Depends on: Task ${task.dependsOnTaskOrders.join(', ')}` : ''} `).join('\n')} ${tasks.length > 15 ? `\n... and ${tasks.length - 15} more tasks` : ''} **Task Breakdown:** • Quick wins: ${tasks.filter((t: any) => t.taskType === 'quick_win').length} • Focus required: ${tasks.filter((t: any) => t.taskType === 'focus_required').length} • Collaborative: ${tasks.filter((t: any) => t.taskType === 'collaborative').length} • Creative: ${tasks.filter((t: any) => t.taskType === 'creative').length} • Administrative: ${tasks.filter((t: any) => t.taskType === 'administrative').length} Tasks have been saved to your AiDD account. `; return { content: [{ type: 'text', text: response, } as TextContent], }; } catch (error) { return { content: [{ type: 'text', text: `❌ Error converting to tasks: ${error instanceof Error ? error.message : 'Unknown error'}`, } as TextContent], }; } } private async handleScoreTasks(args: any) { try { const { considerCurrentEnergy = true, timeOfDay = 'auto' } = args; // Get all tasks const tasks = await this.backendClient.listTasks({}); // Score tasks using backend AI const scoredTasks = await this.backendClient.scoreTasks(tasks); // Sort by score scoredTasks.sort((a: any, b: any) => b.score - a.score); const actualTimeOfDay = timeOfDay === 'auto' ? this.getTimeOfDay() : timeOfDay; const response = ` 🎯 **Tasks Scored & Prioritized** **Summary:** • Tasks scored: ${scoredTasks.length} • Time optimization: ${actualTimeOfDay} • Energy considered: ${considerCurrentEnergy ? 'Yes' : 'No'} **Top Priority Tasks (Next 2 Hours):** ${scoredTasks.slice(0, 5).map((task: any, i: number) => ` ${i + 1}. **${task.title}** (Score: ${task.score}/100) ${task.factors ? `• Urgency: ${task.factors.urgency}/10` : ''} ${task.factors ? `• Importance: ${task.factors.importance}/10` : ''} ${task.factors ? `• Effort: ${task.factors.effort}/10` : ''} ${task.factors ? `• ADHD Match: ${task.factors.adhd_compatibility}/10` : ''} ${task.recommendation ? `📝 ${task.recommendation}` : ''} `).join('\n')} **Suggested Schedule:** 🌅 **Morning (High Energy):** ${scoredTasks.filter((t: any) => t.factors && t.factors.effort >= 7).slice(0, 3).map((t: any) => ` • ${t.title}`).join('\n') || ' No high-energy tasks'} ☀️ **Afternoon (Medium Energy):** ${scoredTasks.filter((t: any) => t.factors && t.factors.effort >= 4 && t.factors.effort < 7).slice(0, 3).map((t: any) => ` • ${t.title}`).join('\n') || ' No medium-energy tasks'}