Mcp Apple Notes

> [!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

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

1. Install dependencies:

``bash yarn install ``

1. Build the project:

``bash yarn build ``

1. Start the server:

``bash yarn start ``

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

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

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:

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

Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: Siddhant-K-code
• Source: Siddhant-K-code/mcp-apple-notes
• License: MIT

Install and usage instructions live in the source repository linked above.