Apple Notes MCP Server

Implementation Reference

• src/index.ts:36-64 (handler)

  MCP tool handler for 'create-note': calls AppleNotesManager.createNote and returns formatted success or error response.

  async ({ title, content, tags = [] }: CreateNoteParams) => {
    try {
      const note = notesManager.createNote(title, content, tags);
      if (!note) {
        return {
          content: [{
            type: "text",
            text: "Failed to create note. Please check your Apple Notes configuration."
          }],
          isError: true
        };
      }
  
      return {
        content: [{
          type: "text",
          text: `✅ Note created successfully: "${note.title}"`
        }]
      };
    } catch (error) {
      return {
        content: [{
          type: "text",
          text: `Error creating note: ${error instanceof Error ? error.message : 'Unknown error'}`
        }],
        isError: true
      };
    }
  }

• src/index.ts:18-22 (schema)

  Input schema for 'create-note' tool using Zod validators.

  const createNoteSchema = {
    title: z.string().min(1, "Title is required"),
    content: z.string().min(1, "Content is required"),
    tags: z.array(z.string()).optional()
  };

• src/index.ts:34-65 (registration)

  Registration of the 'create-note' tool on the MCP server.

    "create-note",
    createNoteSchema,
    async ({ title, content, tags = [] }: CreateNoteParams) => {
      try {
        const note = notesManager.createNote(title, content, tags);
        if (!note) {
          return {
            content: [{
              type: "text",
              text: "Failed to create note. Please check your Apple Notes configuration."
            }],
            isError: true
          };
        }
  
        return {
          content: [{
            type: "text",
            text: `✅ Note created successfully: "${note.title}"`
          }]
        };
      } catch (error) {
        return {
          content: [{
            type: "text",
            text: `Error creating note: ${error instanceof Error ? error.message : 'Unknown error'}`
          }],
          isError: true
        };
      }
    }
  );

• src/services/appleNotesManager.ts:35-59 (helper)

  Core helper method in AppleNotesManager that executes AppleScript to create the note in Apple Notes app.

  createNote(title: string, content: string, tags: string[] = []): Note | null {
    const formattedContent = formatContent(content);
    const script = `
      tell application "Notes"
        tell account "${this.ICLOUD_ACCOUNT}"
          make new note with properties {name:"${title}", body:"${formattedContent}"}
        end tell
      end tell
    `;
  
    const result = runAppleScript(script);
    if (!result.success) {
      console.error('Failed to create note:', result.error);
      return null;
    }
  
    return {
      id: Date.now().toString(),
      title,
      content,
      tags,
      created: new Date(),
      modified: new Date()
    };
  }

• src/services/appleNotesManager.ts:9-23 (helper)

  Helper function to format note content for AppleScript compatibility.

  const formatContent = (content: string): string => {
    if (!content) return '';
  
    // Define replacement patterns for text formatting
    const replacements: [string, RegExp][] = [
      ['\n', /\n/g],
      ['\t', /\t/g],
      ['"', /"/g], // Escape quotes for AppleScript
    ];
  
    return replacements.reduce(
      (text, [char, pattern]) => text.replace(pattern, char === '"' ? '\\"' : '<br>'),
      content
    );
  };