convez.ai
MCP ServerIntegração & APIsIntermediário
RafalWilinski

MCP Apple Notes

RafalWilinski/mcp-apple-notes

Busca semântica em Apple Notes direto no Claude via MCP

Ver no GitHub
InicialPluginScore · de 0 a 100

Servidor MCP que integra Apple Notes com Claude, permitindo busca semântica e RAG (Retrieval Augmented Generation) sobre suas anotações. Executa localmente com embeddings on-device, sem necessidade de APIs externas.

Instalação

$npx convez-ai RafalWilinski/mcp-apple-notes

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
420
Forks
56
Acompanhando
7
Saúde
28%
Último commit
há 1 ano
Versão
—
Issues abertas
21
Contribuidores
1

Casos de uso

  • Recuperar informações de notas durante conversas com Claude
  • Pesquisar anotações usando linguagem natural
  • Integrar conhecimento pessoal (Apple Notes) em assistentes de IA

Veredito

Solução técnica sólida para usuários macOS que querem conectar Apple Notes ao Claude. Execução 100% local com embeddings on-device é um diferencial, mas requer Bun e configuração manual no desktop app.

README

A tradução para o português deste README ainda está na fila.

MCP Apple Notes

MCP Apple Notes

A Model Context Protocol (MCP) server that enables semantic search and RAG (Retrieval Augmented Generation) over your Apple Notes. This allows AI assistants like Claude to search and reference your Apple Notes during conversations.

MCP Apple Notes

Features

  • 🔍 Semantic search over Apple Notes using all-MiniLM-L6-v2 on-device embeddings model
  • 📝 Full-text search capabilities
  • 📊 Vector storage using LanceDB
  • 🤖 MCP-compatible server for AI assistant integration
  • 🍎 Native Apple Notes integration via JXA
  • 🏃‍♂️ Fully local execution - no API keys needed

Prerequisites

Installation

  1. Clone the repository:
git clone https://github.com/RafalWilinski/mcp-apple-notes
cd mcp-apple-notes
  1. Install dependencies:
bun install

Usage

  1. Open Claude desktop app and go to Settings -> Developer -> Edit Config

Claude Desktop Settings

  1. Open the claude_desktop_config.json and add the following entry:
{
  "mcpServers": {
    "local-machine": {
      "command": "/Users/<YOUR_USER_NAME>/.bun/bin/bun",
      "args": ["/Users/<YOUR_USER_NAME>/apple-notes-mcp/index.ts"]
    }
  }
}

Important: Replace <YOUR_USER_NAME> with your actual username.

  1. Restart Claude desktop app. You should see this:

Claude MCP Connection Status

  1. Start by indexing your notes. Ask Claude to index your notes by saying something like: "Index my notes" or "Index my Apple Notes".

Troubleshooting

To see logs:

tail -n 50 -f ~/Library/Logs/Claude/mcp-server-local-machine.log
# or
tail -n 50 -f ~/Library/Logs/Claude/mcp.log

Todos

  • Apple notes are returned in the HTML format. We should turn them to Markdown and embed that
  • Chunk source content using recursive text splitter or markdown text splitter
  • Add an option to use custom embeddings model
  • More control over DB - purge, custom queries, etc.
  • Storing notes in Notes via Claude
Ver o original no GitHub

Bom para

Relacionados