MCP.so
Sign In
A

Apple Notes Mcp

@disco-trooper

Repository

About Apple Notes Mcp

No overview available yet

#macos#mcp#semantic-search#apple-notes#rag

Basic information

Category

Memory & Knowledge

Transports

stdio

Publisher

disco-trooper

Submitted by

disco_trooper

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "apple-notes": {
      "command": "npx",
      "args": [
        "-y",
        "@disco_trooper/apple-notes-mcp"
      ],
      "env": {
        "EMBEDDING_PROVIDER": "local",
        "EMBEDDING_MODEL": "Xenova/all-MiniLM-L6-v2"
      }
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is Apple Notes Mcp?

Apple Notes Mcp is a Model Context Protocol server that integrates with macOS Apple Notes via JXA (JavaScript for Automation). It provides semantic search, hybrid search, and full CRUD operations, allowing Claude and other MCP clients to read, create, update, delete, and manage Apple Notes through natural language commands. It is intended for macOS users who want AI-assisted note management.

How to use Apple Notes Mcp?

Install globally via npm (npm install -g @disco_trooper/apple-notes-mcp) or clone and build from source with Bun. Run bun run setup to run the setup wizard, which configures embedding providers, API keys, indexing preferences, and optionally adds the server to Claude Code configuration. After setup, tools such as search-notes, create-note, update-note, delete-note, move-note, index-notes, and others are available via MCP clients like Claude Code.

Key features of Apple Notes Mcp

  • Semantic search finds notes by meaning, not keywords.
  • Hybrid search combines vector and keyword search.
  • Full CRUD: create, read, update, delete, and move notes.
  • Incremental indexing re-embeds only changed notes.
  • Dual embedding support: local HuggingFace or OpenRouter API.
  • Claude Code integration works with the Claude Code CLI.

Use cases of Apple Notes Mcp

  • Search for notes by conceptual meaning (e.g., "meeting notes from last week").
  • Create new notes in specific folders via natural language.
  • Retrieve full content of a note by its title.
  • Move notes between folders (e.g., archive old projects).
  • Re-index notes after manual edits to keep search results current.

FAQ from Apple Notes Mcp

Why do I get "Note not found"?

Use the full path format Folder/Note Title when multiple notes share the same name.

Why is the first search slow?

Local embeddings download the model on first use (~200 MB). Subsequent searches run at normal speed.

How do I enable write operations when "READONLY_MODE is enabled"?

Set READONLY_MODE=false in your .env file.

Why are some notes missing from search results?

Run index-notes to update the search index. Use mode: full if incremental indexing misses changes.

Why do I see JXA errors?

Ensure Apple Notes is running and contains at least one note. Grant automation permissions when prompted by macOS.

Comments

More Memory & Knowledge MCP servers

Semantic Scholar MCP Server

YUZongmin

A FastMCP server implementation for the Semantic Scholar API, providing comprehensive access to academic paper data, author information, and citation networks.

158

Memory Bank MCP Server

alioshr

A Model Context Protocol (MCP) server implementation for remote memory bank management, inspired by Cline Memory Bank.

913

Dash Api Docs Mcp Server

Kapeli

MCP server for Dash, the macOS API documentation browser

167

Ultimate Google Docs & Drive MCP Server

a-bonus

The Ultimate Google Docs, Sheets, Drive, Gmail, & Google Calendar MCP Server. This MCP (primarily for use in Claude Desktop) gains full access to your google suite and lets claude do its thing.

605

Mcp Knowledge Graph

shaneholloman

MCP server enabling persistent memory for Claude through a local knowledge graph - fork focused on local development

871