📝 Apple Notes MCP Server

Apple Notes MCP Server is a Model Context Protocol server that enables seamless interaction with Apple Notes through natural language. Create, search, and retrieve notes effortlessly using Claude or other AI assistants! 🎉

🎯 Features

• Create Notes: Quickly create new notes with titles, content, and tags 📝
• Search Notes: Find notes using powerful search capabilities 🔍
• Retrieve Content: Get the full content of any note by its title 📖
• iCloud Integration: Works directly with your iCloud Notes account ☁️

🚀 Getting Started

Prerequisites

1. macOS with 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 with:

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

   Note: Replace /path/to/mcp-apple-notes with the actual path to your cloned repository. You may need to authorize the script to access Apple Notes when first running commands.

MCP Server Initialization

When the server starts successfully, you'll see:

Starting Apple Notes MCP server.

The server is now ready to handle your note operations! 🎉

🛠️ Usage

Available Tools

1. Create Note

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

     {
       title: string;      // The title of the note
       content: string;    // The content of the note
       tags?: string[];    // Optional tags for the note
     }

   • Example Response:

     Note created: My New Note
     

2. Search Notes

   • Description: Search for notes by title
   • Parameters:

     {
       query: string; // The search query
     }

   • Example Response:

     Meeting Notes
     Shopping List
     Ideas for Project
     

3. Get Note Content

   • Description: Retrieve the full content of a specific note
   • Parameters:

     {
       title: string; // The exact title of the note
     }

   • Example Response:

     [Full content of the note]
     

📚 Example Use Cases

1. Quick Note Taking

Create notes during meetings or brainstorming sessions:

{
"title": "Team Meeting Notes",
"content": "Discussion points:\n1. Project timeline\n2. Resource allocation",
"tags": ["meetings", "work"]
}

2. Information Retrieval

Search for specific notes when you need them:

{
"query": "meeting"
}

3. Content Review

Get the full content of a specific note:

{
"title": "Team Meeting Notes"
}

⚡ Tips for Best Results

• Ensure your Apple Notes app is properly configured with iCloud
• Use descriptive titles for better searchability
• Include relevant tags when creating notes for better organization

🔧 Development

The project uses TypeScript and follows modern ES modules patterns. Key files:

• src/index.ts: Main server implementation
• src/services/appleNotesManager.ts: Core note management functionality
• src/utils/applescript.ts: AppleScript integration utilities

Development Container

A development container configuration is provided for VS Code users, offering:

• TypeScript Node.js environment
• Prettier for code formatting
• Automatic dependency installation

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

---

Made with ❤️ for Apple Notes users