Why do I get "Note not found"?
Use the full path format `Folder/Note Title` when multiple notes share the same name.
A
Apple Notes MCP Server
@disco-trooper
Basic information
About Apple Notes MCP Server
No overview available yet
Apple Notes MCP Server 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"
}
}
}
}Apple Notes MCP Server tools
Tool list not available yet
This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.
Fetch the live tool list by running this server in a temporary sandbox using the button above.
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.
Frequently asked questions
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.
More Memory & Knowledge MCP servers
ctxfile
ctxfileLocal-first MCP server that snapshots your project's working state into one context object. Open-core, privacy-first.
2
Tempreon
TempreonPerson-owned, portable AI memory served over MCP. Your knowledge, preferences, and decisions — captured in one assistant, available in all of them.
PLUR
plur-aiAI agents start every session with amnesia — you re-explain the project, repeat your preferences, and correct the same mistakes over and over. PLUR gives them a memory that persists. Your agent's corrections, preference
226
Context7 MCP - Up-to-date Docs For Any Cursor Prompt
upstashContext7 Platform -- Up-to-date code documentation for LLMs and AI code editors
58.7K
Scento Perfume API (MCP server): free fragrance API, no key
ScentoScento Perfume API is a free fragrance API and perfume notes database for developers and AI agents. Search 1,500+ perfumes and 400+ ingredients, compare scents, find similar perfumes, map scent families and build occasio
Comments