> [!Caution]
> Not actively maintained. Use at your own risk!
📝 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:
bash git clone https://github.com/Siddhant-K-code/mcp-apple-notes.git cd mcp-apple-notes -
Install dependencies:
bash yarn install -
Build the project:
bash yarn build -
Start the server:
bash yarn start -
Configure Claude Desktop. Update your
claude_desktop_config.jsonwith: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
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:```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
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:```ts
{
"query": "meeting"
}
### 3. Content Review
Get the full content of a specific note:```ts
{
"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 implementationsrc/services/appleNotesManager.ts: Core note management functionalitysrc/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
