📝 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:
```
{
  "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

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
```

Search Notes

Description: Search for notes by title

Parameters:

{
  query: string; // The search query
}

Example Response:

Meeting Notes
Shopping List
Ideas for Project

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

📝 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

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

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
```

Search Notes

Description: Search for notes by title

Parameters:

{
  query: string; // The search query
}

Example Response:

Meeting Notes
Shopping List
Ideas for Project

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