Siddhant-K-code/mcp-apple-notes

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