MCP Apple Notes

by Dingzeefs

Integrations

  • Provides semantic search and retrieval capabilities for Apple Notes, allowing users to list, search, retrieve, and create notes in their Apple Notes app.

  • Required for Apple Notes integration, leveraging native macOS functionality to access and manipulate notes.

MCP Apple Notes

A Model Context Protocol (MCP) server for semantic search and retrieval over Apple Notes.

Features

  • 🔍 Semantic search using on-device embeddings model
  • 📝 Full-text search capabilities
  • 💾 Vector storage with LanceDB
  • 🍎 Native Apple Notes integration

Prerequisites

  • macOS (required for Apple Notes integration)
  • Bun JavaScript runtime

Installation

  1. Clone this repository:
git clone https://github.com/Dingzeefs/mcp-apple-notes.git cd mcp-apple-notes
  1. Install dependencies:
bun install

Usage

Configuring in Cursor IDE

  1. Open Cursor IDE
  2. Go to Settings → Features → MCP
  3. Add a new MCP server with the following configuration:
    • Name: Apple Notes
    • Type: command
    • Command: /path/to/bun /path/to/mcp-apple-notes/index.ts

    Replace /path/to/bun with the actual path to your Bun executable (find it using which bun) and /path/to/mcp-apple-notes with the actual path to this repository.

  4. Restart Cursor IDE

Using the MCP Server

Once configured, you can use the following tools in your conversations with Claude:

  • list-notes: Lists all your Apple Notes titles
  • index-notes: Indexes your notes for semantic search (do this first)
  • get-note: Retrieves a specific note by title
  • search-notes: Searches your notes using semantic or keyword search
  • create-note: Creates a new note with specified title and content

Troubleshooting

If you encounter issues:

  1. Check that the server is running by looking at the MCP server status in Cursor
  2. Verify that the paths in your MCP server configuration are correct
  3. Try running the command directly in your terminal to see any error messages
  4. Make sure Apple Notes is accessible and permissions are granted

License

MIT

-
security - not tested
F
license - not found
-
quality - not tested

local-only server

The server can only run on the client's local machine because it depends on local resources.

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

  1. Features
    1. Prerequisites
      1. Installation
        1. Usage
          1. Configuring in Cursor IDE
          2. Using the MCP Server
        2. Troubleshooting
          1. License

            Related MCP Servers

            • A
              security
              A
              license
              A
              quality
              Enables interaction with Apple Notes via natural language, supporting note creation, search, and retrieval with iCloud integration for seamless note management.
              Last updated -
              3
              2
              TypeScript
              MIT License
              • Apple
            • -
              security
              F
              license
              -
              quality
              A Model Context Protocol server that enables semantic search and RAG over your Apple Notes, allowing AI assistants like Claude to search and reference your notes during conversations.
              Last updated -
              6
              TypeScript
              • Apple
            • A
              security
              A
              license
              A
              quality
              A Model Context Protocol server that enables AI assistants to interact with the HackMD API for managing notes, including creating, reading, updating, and deleting notes.
              Last updated -
              12
              40
              20
              TypeScript
              MIT License
            • -
              security
              A
              license
              -
              quality
              A Model Context Protocol server that allows AI assistants like Claude to read notes from the Bear note-taking app in a safe, read-only mode.
              Last updated -
              2
              JavaScript
              MIT License
              • Apple

            View all related MCP servers

            ID: oey0kokhxb