📝 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

$3

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

$3

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.

$3

When the server starts successfully, you'll see:
`
Starting Apple Notes MCP server.
`

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

🛠️ Usage

$3

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

$3

Create notes during meetings or brainstorming sessions:

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

$3

Search for specific notes when you need them:

`ts
{
"query": "meeting"
}
`

$3

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 implementation
- src/services/appleNotesManager.ts: Core note management functionality
- src/utils/applescript.ts`: AppleScript integration utilities

$3

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