The Apple Notes MCP Server allows seamless interaction with Apple Notes using natural language.
Create Notes: Add new notes with titles, content, and optional tags
Search Notes: Find notes by title using a search query
Retrieve Content: Access the full content of a specific note by its title
iCloud Integration: Works directly with your iCloud Notes account
📝 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-notesInstall dependencies:
yarn installBuild the project:
yarn buildStart the server:
yarn startConfigure 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:
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:
2. Information Retrieval
Search for specific notes when you need them:
3. Content Review
Get the full content of a specific note:
⚡ 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
local-only server
The server can only run on the client's local machine because it depends on local resources.
Enables interaction with Apple Notes via natural language, supporting note creation, search, and retrieval with iCloud integration for seamless note management.
Related Resources
Related MCP Servers
- -securityAlicense-qualityAllows the AI to read from your local Apple Notes database (macOS only)Last updated -119MIT License
- -securityFlicense-qualityEnables semantic search and RAG (Retrieval Augmented Generation) over your Apple Notes.Last updated -292
- -securityFlicense-qualityA Model Context Protocol server that enables semantic search and retrieval of Apple Notes content, allowing AI assistants to access, search, and create notes using on-device embeddings.Last updated -2