applescript-mcp

Instructions

Implementation Reference

• src/categories/notes.ts:198-222 (handler)

  Handler function that generates AppleScript code to list all notes or notes in a specific folder in Apple Notes.app.

  script: (args) => {
    const { folder = "" } = args;
    
    if (folder) {
      return `
        tell application "Notes"
          set folderList to folders whose name is "${folder}"
          if length of folderList > 0 then
            set targetFolder to item 1 of folderList
            set noteNames to name of notes of targetFolder
            return noteNames as string
          else
            return "Folder not found: ${folder}"
          end if
        end tell
      `;
    } else {
      return `
        tell application "Notes"
          set noteNames to name of notes
          return noteNames as string
        end tell
      `;
    }
  },

• src/categories/notes.ts:223-231 (schema)

  Input schema defining optional 'folder' parameter for listing notes from a specific folder.

  schema: {
    type: "object",
    properties: {
      folder: {
        type: "string",
        description: "Optional folder name to list notes from"
      }
    }
  }

• src/framework.ts:221-232 (registration)

  Registers the 'notes_list' tool by constructing the name from category 'notes' and script 'list', along with description and schema.

  this.server.setRequestHandler(ListToolsRequestSchema, async () => ({
    tools: this.categories.flatMap((category) =>
      category.scripts.map((script) => ({
        name: `${category.name}_${script.name}`, // Changed from dot to underscore
        description: `[${category.description}] ${script.description}`,
        inputSchema: script.schema || {
          type: "object",
          properties: {},
        },
      })),
    ),
  }));

• src/index.ts:35-35 (registration)

  Registers the notes category containing the 'list' script, which becomes the 'notes_list' tool.

  server.addCategory(notesCategory);