📝 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

macOS with Apple Notes app configured
Node.js (version 20.0.0 or higher)
Yarn package manager

Installation

Clone the repository:

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

Install dependencies:
```
yarn install
```
Build the project:
```
yarn build
```
Start the server:
```
yarn start
```
Configure Claude Desktop. Update your claude_desktop_config.json with:

*Configuration content*
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:
     ```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
     ```

1. **Search Notes**

   - Description: Search for notes by title
   - Parameters:
     ```typescript
     {
       query: string; // The search query
     }
     ```
   - Example Response:
     ```
     Meeting Notes
     Shopping List
     Ideas for Project
     ```

1. **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

Create notes during meetings or brainstorming sessions:

```ts
{
"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

MCP Apple Notes