广告合作
MCP.so
登录
A

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.

常见问题

1

Why do I get "Note not found"?

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

2

Why is the first search slow?

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

3

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

Set `READONLY_MODE=false` in your `.env` file.

4

Why are some notes missing from search results?

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

5

Why do I see JXA errors?

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

评论

记忆与知识 分类下的更多 MCP 服务器

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

PLUR

plur-ai

AI 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

Snipara

alopez3006

MCP connector for Snipara, the Project Brain for AI coding agents

1

The Cloud

Teka

The Cloud is the AI-native workspace that gives every AI — Claude, ChatGPT, Gemini, and other Frontier & Free or Local models — shared memory and real agents. Not cloud computing: thecloud.so is one workspace where your

agentleFS

agentleFS

One permissioned folder your team and your AI agents both log into.

广告合作