mcpField
M
MCP Apple Notes

MCP Apple Notes

Local
github.com/DingzeefsMemory & Knowledge2Updated 86w ago
Repository

About MCP Apple Notes

MCP Apple Notes provides semantic and full-text search over Apple Notes, along with note retrieval and creation. It is for macOS users who want to access their notes from an MCP client such as Cursor IDE.

Key features

  1. 01Semantic search with on-device embeddings
  2. 02Full-text and keyword search
  3. 03Vector storage with LanceDB
  4. 04List and retrieve notes
  5. 05Create notes

Use cases

  1. 01Find notes by meaning or keywords
  2. 02Retrieve a note by its title
  3. 03Index notes for semantic search
  4. 04Create notes from an MCP client

MCP support

Exposes Apple Notes listing, indexing, search, retrieval, and creation as tools for MCP clients. The README describes configuration with Cursor IDE.

#mcp-apple-notes#apple-notes#cursor-ide

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

No install method listed yet

We haven’t collected a package or remote endpoint for this server. Follow the instructions in the project README.

Repository

Tools

No tool list yet

Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.

Details

From the project README

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

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.