שרת ה-MCP של Apple Notes, הכלים שלו נספרו בריצה חיה על Mac אמיתי.

• כלים

  7, נספרו בריצה חיה

• אישורי גישה

  אין, רק הרשאת Automation [4][5]

• ערוץ תקשורת

  stdio, רץ על ה-Mac שלכם [4]

• מתחזק

  Dhravya Shah, המאגר בארכיון [1][3]

• הורדות

  204 בשבוע האחרון [2]

• רישיון

  MIT [1][3]

אימות

איך שרת ה-MCP הזה אומת.

השיטה

התקנו את bun דרך Homebrew, הפעלנו את השרת עם bunx --no-cache apple-mcp@latest על גבי stdio, בלי משתני סביבה ובלי שום אישור גישה, והשלמנו את לחיצת היד של MCP: הוא ענה בשם Apple MCP tools בגרסה 1.0.0, ועם גרסת פרוטוקול 2024-11-05 למרות שהלקוח שלנו ביקש 2025-06-18, שדרוג לאחור שכדאי להכיר. אחר כך קראנו ל-tools/list, שענה עם 7 כלים, אחד לכל אפליקציה של Apple, והטבלה שלמטה היא התשובה הזו, מילה במילה. ביצענו גם קריאת כלי אמיתית אחת, notes עם operation בערך list. היא ארכה 120.3 שניות וחזרה במראה של הצלחה, isError שקרי והטקסט No notes exist., אבל ה-stderr של אותה ריצה הדפיס מתחתיה את הכישלון עצמו, שגיאת AppleEvent timed out מול Notes, והפונקציה getAllNotes של החבילה הופכת כל כישלון כזה לרשימה ריקה. לכן איננו סופרים אותה כקריאה מוצלחת: הכלים נספרו בריצה חיה, כל שגיאה בעמוד הזה היא פלט אמיתי, וקריאה שבאמת קוראת את הפתקים שלכם עדיין ממתינה להרשאת ה-Automation של macOS שאתם מאשרים על ה-Mac שלכם. שחזרנו את אותה שגיאה בדיוק עם פקודת osascript חשופה ועם חבילת Notes שנייה ולא קשורה על אותו Mac ובאותו זמן, כשהמסך פתוח והתצוגה ערה, כך שהמצב שייך למכונה ולא לחבילה מסוימת.

Resolving dependencies
Resolved, downloaded and extracted [2]
Saved lockfile
Starting apple-mcp server...
Attempting to eagerly load modules...
- Contacts module loaded successfully
- Notes module loaded successfully
- Message module loaded successfully
- Mail module loaded successfully
- Reminders module loaded successfully
- Calendar module loaded successfully
- Maps module loaded successfully
All modules loaded successfully, using eager loading mode
Initializing server in standard mode...
Setting up MCP server transport...
Initializing transport...
Setting up stdout filter...
Connecting transport to server...
Server connected successfully!

tools/call notes {"operation": "list"}

No notes exist.
132:137: execution error: Notes got an error: AppleEvent timed out. (-1712)

שורות אמיתיות מהתוצאה שנלכדה: מספיק כדי להוכיח שהקריאה נענתה.

כלים

הכלים, כפי שנספרו מהשרת הרץ.

השרת ענה ל-tools/list עם 7 כלים בתאריך 2026-08-03. השמות, התיאורים והפרמטרים למטה הם המילים שלו עצמו, מועתקים מהתשובה הזו וללא עריכה.

פרמטרים המסומנים ב-* הם חובה.

התקנה

הגדרות שעובדות, אחת לכל אפליקציה.

העתיקו את הבלוק של האפליקציה שלכם. כל אחד מהם הוא ההגדרה המדויקת שאיתה אימתנו את השרת.

{
  "mcpServers": {
    "apple-mcp": {
      "command": "bunx",
      "args": [
        "--no-cache",
        "apple-mcp@latest"
      ]
    }
  }
}

claude mcp add apple-mcp -- bunx --no-cache apple-mcp@latest

{
  "mcpServers": {
    "apple-mcp": {
      "command": "bunx",
      "args": [
        "--no-cache",
        "apple-mcp@latest"
      ]
    }
  }
}

Name        Apple Notes
Command     bunx
Arguments   --no-cache apple-mcp@latest

בלי טרמינל

איך מגדירים את שרת ה-MCP‏ Apple Notes בלי טרמינל.

אם מעולם לא פתחתם את הטרמינל ואין לכם כוונה להתחיל, זה המסלול שלכם, עם חריג אחד והוגן: השרת הזה עולה דרך bun, ש-Mac לא מגיע איתו, והתקנת bun היא פקודה אחת. Routines היא אפליקציית Mac שמריצה שרתי MCP בשבילכם: ממלאים שלושה שדות פעם אחת, והכלים של השרת זמינים ל-AI שלכם בצ׳אט ובשגרות מתוזמנות.

1. 01

   התקינו את Routines

   הורידו את האפליקציה מ-getroutines.ai/download, גררו אותה ל-Applications והתחברו.

2. 02

   התקינו את bun פעם אחת

   זה השלב היחיד שדורש טרמינל, ועושים אותו פעם אחת. פתחו את Terminal והריצו brew install oven-sh/bun/bun, וכך תקבלו את הפקודה bunx שאיתה השרת עולה. ה-README של החבילה ממליץ על bunx ולא על npx, ו-bunx הוא מה שהרצנו.

3. 03

   פתחו את הגדרות ה-MCP

   לחצו על החשבון שלכם בתחתית סרגל הצד ובחרו Settings. פתחו את הקטע Assistant, אחר כך את הלשונית Connections, גללו אל MCP Servers ולחצו על Add MCP Server.

4. 04

   בחרו Command (stdio)‎ ומלאו שלושה שדות

   העבירו את הטופס ל-Command (stdio): השרת הזה הוא פקודה שה-Mac שלכם מריץ, לא כתובת אינטרנט. Name: Apple Notes. Command: bunx. Arguments: ‎--no-cache apple-mcp@latest. השאירו את Environment Variables ריק, השרת הזה לא צריך משתנים.

5. 05

   בדקו, ואז הוסיפו

   לחצו Test Connection: Routines מפעילה את השרת ומדווחת כמה כלים היא מצאה, שבעה עבור השרת הזה, אחד לכל אפליקציה של Apple. ההפעלה הראשונה גם מורידה את החבילה, אז תנו לה רגע. אחר כך לחצו Add Server.

6. 06

   אשרו את בקשת ההרשאה של macOS, ואז השתמשו בו

   בפעם הראשונה שכלי באמת מגיע ל-Notes או ל-Reminders, macOS שואל אם Routines רשאית לשלוט באפליקציה הזו. אשרו, ותוכלו לשנות את דעתכם בהמשך ב-System Settings, אחר כך Privacy and Security, אחר כך Automation. הכלים עובדים בצ׳אט מיד, וכדי לתת לשגרה מתוזמנת להשתמש בהם, פתחו את השגרה, מצאו את הכרטיס Tools & connections וסמנו את השרת תחת Apps.

רעיונות לשגרות

שגרות ששווה לתזמן.

אחרי שהשרת מחובר, שגרה מתוזמנת יכולה להשתמש בכלים שלו גם כשאתם לא מול המסך. העתיקו פרומפט, הדביקו אותו ב-Routines ובחרו שעה. הפרומפטים כתובים באנגלית בכוונה, מדביקים אותם בדיוק כפי שהם.

פתרון תקלות

השגיאות שנתקלנו בהן, ומה פתר אותן.

שגיאות אמיתיות שנלכדו בריצת האימות, מודפסות בדיוק כפי שהשרת החזיר אותן.

Error getting all notes: Command failed: osascript -e 
tell application "Notes"
    set notesList to {}
    set noteCount to 0

    -- Get all notes from all folders
    set allNotes to notes

    repeat with i from 1 to (count of allNotes)
        if noteCount >= 50 then exit repeat

        try
            set currentNote to item i of allNotes
            set noteName to name of currentNote
            set noteContent to plaintext of currentNote

            -- Limit content for preview
            if (length of noteContent) > 200 then
                set noteContent to (characters 1 thru 200 of noteContent) as string
                set noteContent to noteContent & "..."
            end if

            set noteInfo to {name:noteName, content:noteContent}
            set notesList to notesList & {noteInfo}
            set noteCount to noteCount + 1
        on error
            -- Skip problematic notes
        end try
    end repeat

    return notesList
end tell 
132:137: execution error: Notes got an error: AppleEvent timed out. (-1712)

Unknown tool: notess

Error: Invalid arguments for notes tool

No matching reminders found

שאלות נפוצות

שאלות שאנשים שואלים.

מקורות

כל טענה חיצונית, עם קבלה.

כל מה שבעמוד הזה שלא ראינו בעצמנו בריצה מקושר כאן, עם התאריך שבו קראנו אותו. לגבי השאר, הריצה עצמה היא הקבלה.

1. [1]

   npm registry: apple-mcpנקרא בתאריך 2026-08-03

   Latest version 1.0.0, published 2025-08-11; license MIT; npm maintainer dhravya.

2. [2]

   npm downloads API: last weekנקרא בתאריך 2026-08-03

   204 downloads for the week 2026-07-27 to 2026-08-02.

3. [3]

   GitHub: supermemoryai/apple-mcpנקרא בתאריך 2026-08-03

   3,128 stars, 282 forks, archived true, last push 2025-08-11, license MIT, per the GitHub API. The older Dhravya/apple-mcp URL redirects to this same repository.

4. [4]

   apple-mcp README (main)נקרא בתאריך 2026-08-03

   Source for the bunx --no-cache apple-mcp@latest invocation and the client config blocks; it also documents a Smithery installer and a one-click Claude Desktop install, neither of which we tested.

5. [5]

   apple-mcp source: utils/notes.tsנקרא בתאריך 2026-08-03

   getAllNotes() catches any error, logs it to stderr and returns an empty array, which is how an AppleScript timeout becomes "No notes exist."; the same file tells the reader to enable the app under System Settings, Privacy and Security, Automation.

6. [6]

   npm registry: apple-notes-mcpנקרא בתאריך 2026-08-03

   The Notes only alternative: latest version 2.6.12, published 2026-08-01, license MIT, 51 published versions since 2025-12-27.

7. [7]

   npm downloads API: last week, apple-notes-mcpנקרא בתאריך 2026-08-03

   1,283 downloads for the week 2026-07-27 to 2026-08-02, against 204 for apple-mcp in the same week.

8. [8]

   GitHub: sweetrb/apple-notes-mcpנקרא בתאריך 2026-08-03

   85 stars, 10 forks, archived false, last push 2026-08-02, created 2025-12-27, per the GitHub API.

9. [9]

   modelcontextprotocol.io: Connect to local MCP serversנקרא בתאריך 2026-08-03

   The claude_desktop_config.json shape and where the file lives.

10. [10]

    Claude Code docs: MCPנקרא בתאריך 2026-08-03

    The claude mcp add syntax for local stdio servers.

11. [11]

    Cursor docs: Model Context Protocolנקרא בתאריך 2026-08-03

    The mcp.json shape and file locations.

12. [12]

    Routines: Connectorsנקרא בתאריך 2026-08-03

    How Routines runs one-click OAuth connectors and any MCP server.

העמוד הזה מתאר את Apple Notes כפי שהתנהג בריצה מתוארכת אחת על Mac אחד. גרסאות משתנות: אם משהו כאן כבר לא תואם למה שאתם רואים, תאריך הלכידה בראש העמוד אומר בן כמה הצילום.