{ "markdown": "# Apple Notes MCP Server\n\n> Powerful tools for automating Apple Notes using Model Context Protocol (MCP)\n\n**mcp-name: io.github.henilcalagiya/mcp-apple-notes**\n\n[![PyPI version](https://badge.fury.io/py/mcp-apple-notes.svg)](https://pypi.org/project/mcp-apple-notes/)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n[![Python 3.10+](https://img.shields.io/badge/python-3.10+-blue.svg)](https://www.python.org/downloads/)\n\n## Overview\n\nApple Notes MCP Server provides seamless integration of Apple Notes with any MCP-compatible client. It enables full note automation — including creating, reading, updating, and deleting notes — through a simple and secure AppleScript API layer.\n\n## Features\n\n* **Full CRUD support** for Apple Notes (Create, Read, Update, Delete)\n* **Works with Continue.dev, Claude Desktop, Perplexity, and other MCP clients**\n* **Native AppleScript integration** for reliable macOS automation\n* **Comprehensive tools** for Apple Notes automation\n* **Automatic installation** via `uvx` or manual setup\n* **FastMCP implementation** with modern decorator-based API\n\n## Requirements\n\n* **macOS** - Required for AppleScript support\n* **Python 3.10+** - Required for MCP SDK compatibility\n* **Apple Notes application** - Must be installed and accessible\n* **MCP-compatible client** (e.g., Continue.dev, Claude Desktop)\n\n## Quick Start\n\n### Step 1: Install uv (if not already installed)\n\n**macOS/Linux:**\n```bash\ncurl -LsSf https://astral.sh/uv/install.sh | sh\n```\n\n**Windows (PowerShell):**\n```powershell\npowershell -c \"irm https://astral.sh/uv/install.ps1 | iex\"\n```\n\n**Alternative (pip):**\n```bash\npip install uv\n```\n\n### Step 2: Add MCP Configuration\n\nAdd this configuration to your MCP client:\n\n**For Perplexity, Cursor, Continue.dev, Claude Desktop:**\n```json\n{\n \"mcpServers\": {\n \"apple-notes\": {\n \"command\": \"uvx\",\n \"args\": [\"mcp-apple-notes@latest\"]\n }\n }\n}\n```\n\n**🎉 That's it!** Your MCP client will automatically install and run the package when needed.\n\n> **Note:** Ensure your MCP client has permission to access Apple Notes and execute AppleScript commands in System Preferences → Security & Privacy → Privacy → Accessibility.\n\n## Available Tools\n\n### **Note Management (6 tools)**\n- `create_note` - Create notes with HTML content\n- `read_note` - Read notes by ID with verification\n- `update_note` - Update notes by ID with HTML content\n- `delete_note` - Delete notes by ID with verification\n- `move_note` - Move notes between folders\n- `list_all_notes` - List all notes across all folders\n\n### **Folder Management (5 tools)**\n- `create_folder` - Create folders with path support\n- `read_folder` - Read folder details by ID\n- `rename_folder` - Rename folders by ID\n- `delete_folder` - Delete folders by ID\n- `move_folder` - Move folders between locations\n\n### **Search & Structure (3 tools)**\n- `search_notes` - Search notes by keywords\n- `list_folder_with_structure` - Show folder hierarchy\n- `list_notes_with_structure` - Show folders + notes hierarchy\n\n\n\n## Content Support\n\n**HTML Formatting**: ``, ``, `


`, `