Apple Notes MCP Server

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: ```bash git clone https://github.com/Siddhant-K-code/mcp-apple-notes.git cd mcp-apple-notes ```

2. Install dependencies: ```bash yarn install ```

3. Build the project: ```bash yarn build ```

4. Start the server: ```bash yarn start ```

5. Configure Claude Desktop. Update your `claude_desktop_config.json` with: ```json { "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

Usage

Available Tools

1. **Create Note** - Description: Creates a new note in Apple Notes - Parameters: ```typescript { 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: ```typescript { 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: ```typescript { title: string; // The exact title of the note } ``` - Example Response: ``` [Full content of the note] ```

Example Use Cases

1. Quick Note Taking

2. Information Retrieval

3. Content Review

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

• `src/index.ts`: Main server implementation

• `src/services/appleNotesManager.ts`: Core note management functionality

• `src/utils/applescript.ts`: AppleScript integration utilities

Development Container

• TypeScript Node.js environment

• Prettier for code formatting

• Automatic dependency installation

License