🚀 Apple Notes MCP Server

The Apple Notes MCP Server is a Model Context Protocol (MCP) server that enables seamless interaction with Apple Notes using natural language. You can quickly create, search, and retrieve notes with Claude or other AI assistants! 🎉

✨ Features

• Create Notes: Rapidly generate new notes with support for titles, content, and tags 📝
• Search Notes: Find notes through a powerful search function 🔍
• Retrieve Content: Obtain the full content of any note by its title 📖
• iCloud Integration: Connect directly to your iCloud Notes account ☁️

🚀 Quick Start

Prerequisites

1. A macOS system with the Apple Notes app configured
2. Node.js (version 20.0.0 or higher)
3. Yarn package manager

Installation

1. Clone the repository:

   git clone https://github.com/Siddhant-K-code/mcp-apple-notes.git
   cd mcp-apple-notes
   

2. Install dependencies:

   yarn install
   

3. Build the project:

   yarn build
   

4. Start the server:

   yarn start
   

5. Configure Claude Desktop. Update your claude_desktop_config.json file and add:

   {
     "mcpServers": {
       "apple-notes": {
         "command": "yarn",
         "args": ["start"],
         "cwd": "/path/to/mcp-apple-notes"
       }
     }
   }
   

   ⚠️ Important Note

   Replace /path/to/mcp-apple-notes with the actual path of your cloned repository. You may need to authorize the script to access Apple Notes when running the command for the first time.

MCP Server Initialization

When the server starts successfully, you'll see:

Starting the Apple Notes MCP Server.

At this point, the server is ready to handle your note operations! 🎉

💻 Usage Examples

Available Tools

1. Create Notes

   • Description: Create a new note in Apple Notes
   • Parameters:

     {
       title: string;      // Note title
       content: string;    // Note content
       tags?: string[];   // Optional, note tags
     }
     

   • Example response: Generating content for your new note...

2. Search Notes

   • Description: Find notes by keywords or phrases
   • Parameters:

     {
       query: string;
     }
     

   • Example response: Return a list of matching notes

3. Retrieve Content

   • Description: Get the content of a note by its title
   • Parameters:

     {
       title: string;
     }
     

   • Example response: Return the content of the note with the specified title

Basic Usage

Create a Note Quickly

# Create a new note
create-note --title "Daily Plan" --content "Today's work arrangements are as follows: ..."

Information Retrieval

# Search for notes
search-notes --query "Meeting Minutes"

# Retrieve content by title
retrieve-content --title "Project Summary"

🔧 Technical Details

This project is built with TypeScript and Node.js, integrating AppleScript for underlying operations. The code repository is hosted on GitHub and comes with detailed documentation.

📄 License

This project is licensed under the MIT License. Please refer to the LICENSE file for specific details.

Conclusion

Welcome to use the Apple Notes MCP Server to seamlessly interact with your note data using natural language and boost your work efficiency!