applescript-mcp

Instructions

Implementation Reference

• src/categories/notes.ts:113-122 (handler)

  The handler function that takes input arguments, generates formatted HTML content, and returns AppleScript to create a new note in the Apple Notes application.
  script: (args) => { const { title = "New Note", content = "", format = {} } = args; const htmlContent = generateNoteHtml(args); return ` tell application "Notes" make new note with properties {body:"${htmlContent}", name:"${title}"} end tell `; },
• src/categories/notes.ts:123-166 (schema)

  Input schema defining the parameters for the notes_create tool: title (required), content (required), and optional format object with booleans for various markdown conversions.
  schema: { type: "object", properties: { title: { type: "string", description: "Title of the note" }, content: { type: "string", description: "Content of the note, can include markdown-like syntax for formatting" }, format: { type: "object", description: "Formatting options for the note content", properties: { headings: { type: "boolean", description: "Enable heading formatting (# Heading)" }, bold: { type: "boolean", description: "Enable bold formatting (**text**)" }, italic: { type: "boolean", description: "Enable italic formatting (*text*)" }, underline: { type: "boolean", description: "Enable underline formatting (~text~)" }, links: { type: "boolean", description: "Enable link formatting ([text](url))" }, lists: { type: "boolean", description: "Enable list formatting (- item or 1. item)" } } } }, required: ["title", "content"] }
• src/categories/notes.ts:8-104 (helper)

  Supporting function that processes note content with optional markdown-to-HTML conversion based on format flags (headings, bold, italic, etc.). Used by the notes_create handler.
  function generateNoteHtml(args: any): string { const { title = "New Note", content = "", format = { headings: false, bold: false, italic: false, underline: false, links: false, lists: false } } = args; // Process content based on format options let processedContent = content; // If content contains markdown-like syntax and formatting is enabled, convert it if (format.headings) { // Convert # Heading to <h1>Heading</h1>, ## Heading to <h2>Heading</h2>, etc. processedContent = processedContent.replace(/^# (.+)$/gm, '<h1>$1</h1>'); processedContent = processedContent.replace(/^## (.+)$/gm, '<h2>$1</h2>'); processedContent = processedContent.replace(/^### (.+)$/gm, '<h3>$1</h3>'); } if (format.bold) { // Convert **text** or __text__ to <b>text</b> processedContent = processedContent.replace(/\*\*(.+?)\*\*/g, '<b>$1</b>'); processedContent = processedContent.replace(/__(.+?)__/g, '<b>$1</b>'); } if (format.italic) { // Convert *text* or _text_ to <i>text</i> processedContent = processedContent.replace(/\*(.+?)\*/g, '<i>$1</i>'); processedContent = processedContent.replace(/_(.+?)_/g, '<i>$1</i>'); } if (format.underline) { // Convert ~text~ to <u>text</u> processedContent = processedContent.replace(/~(.+?)~/g, '<u>$1</u>'); } if (format.links) { // Convert [text](url) to <a href="url">text</a> processedContent = processedContent.replace(/\[(.+?)\]\((.+?)\)/g, '<a href="$2">$1</a>'); } if (format.lists) { // Handle unordered lists // Look for lines starting with - or * and convert to <li> items const listItems = processedContent.match(/^[*-] (.+)$/gm); if (listItems) { let listHtml = '<ul>'; for (const item of listItems) { const content = item.replace(/^[*-] /, ''); listHtml += `<li>${content}</li>`; } listHtml += '</ul>'; // Replace the original list items with the HTML list for (const item of listItems) { processedContent = processedContent.replace(item, ''); } processedContent = processedContent.replace(/\n+/g, '\n') + listHtml; } // Handle ordered lists (1. Item) const orderedItems = processedContent.match(/^\d+\. (.+)$/gm); if (orderedItems) { let listHtml = '<ol>'; for (const item of orderedItems) { const content = item.replace(/^\d+\. /, ''); listHtml += `<li>${content}</li>`; } listHtml += '</ol>'; // Replace the original list items with the HTML list for (const item of orderedItems) { processedContent = processedContent.replace(item, ''); } processedContent = processedContent.replace(/\n+/g, '\n') + listHtml; } } // Wrap paragraphs in <p> tags if they aren't already wrapped in HTML tags const paragraphs = processedContent.split('\n\n'); processedContent = paragraphs .map((p: string) => { if (p.trim() && !p.trim().startsWith('<')) { return `<p>${p}</p>`; } return p; }) .join('\n'); return processedContent; }
• src/index.ts:24-36 (registration)

  Registers the notesCategory (containing notes_create tool) with the AppleScriptFramework server alongside other categories.
  console.error("[INFO] Registering categories..."); server.addCategory(systemCategory); server.addCategory(calendarCategory); server.addCategory(finderCategory); server.addCategory(clipboardCategory); server.addCategory(notificationsCategory); server.addCategory(itermCategory); server.addCategory(mailCategory); server.addCategory(pagesCategory); server.addCategory(shortcutsCategory); server.addCategory(messagesCategory); server.addCategory(notesCategory); console.error(`[INFO] Registered ${11} categories successfully`);
• src/framework.ts:222-225 (registration)

  In the listTools handler, constructs the tool name 'notes_create' by combining category 'notes' and script 'create' with underscore.
  tools: this.categories.flatMap((category) => category.scripts.map((script) => ({ name: `${category.name}_${script.name}`, // Changed from dot to underscore description: `[${category.description}] ${script.description}`,