Apple Notes MCP Server

@disco-trooper

リポジトリ

基本情報

カテゴリ

メモリとナレッジ

トランスポート

stdio

作者

disco-trooper

投稿者

disco_trooper

Apple Notes MCP Server について

概要はまだありません

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

Apple Notes MCP Server の設定

以下の設定を使って、このサーバーを MCP 対応クライアントに追加してください。

{
  "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 のツール

ツール一覧はまだありません

この掲載には表示できるツール一覧がまだありません。サーバーにツールがないという意味ではありません。対応機能はプロジェクトのドキュメントをご確認ください。

上のボタンで一時的なサンドボックスでこのサーバーを実行し、ツール一覧を取得できます。

概要

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.

よくある質問

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.

「メモリとナレッジ」の他のコンテンツ

Scento Perfume API (MCP server): free fragrance API, no key

Scento

Scento 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

AOCI-CODE

aoci-spec

Local MCP server and CLI that keeps a Git-versioned, model-written index of a codebase and its database schema, so coding agents start each task with the whole system in view.

1.7K

Neither MCP

stonianua

Project context your AI can query through MCP — with source evidence.

OpenLore

aakarim

Serve your docs to AI agents over SSH and MCP. Agents use ls, cat, grep, find, and pipes against a virtual filesystem backed by your documentation. Identity-scoped access, governed writing with human approval, and portab

priostack

ideaswave

Open-source Python SDK & MCP interface for Priostack Agent Context Network (ACN). Zero-setup, autonomous memory orchestration for AI agents.