local-only server

The server can only run on the client’s local machine because it depends on local resources.

Integrations

Allows reading from and interacting with Apple Notes database, including retrieving all notes, reading specific note content, and searching through notes
Integrates with the macOS file system to access Apple Notes database, requiring Full Disk Access permissions

Servidor de protocolo de contexto de modelo de Apple Notes para Claude Desktop.

Lea su base de datos local de Apple Notes y proporciónela a Claude Desktop.

Ahora Claude puede buscar tus notas más olvidadas y saber aún más sobre ti.

Nada podría salir mal.

Componentes

Recursos

El servidor implementa la capacidad de leer y escribir en sus Apple Notes.

Herramientas

El servidor proporciona múltiples indicaciones:

get-all-notes : obtener todas las notas.
read-note : obtiene el contenido completo de una nota específica.
search-notes : busca entre notas.

Características faltantes:

No se admiten notas cifradas (ZISPASSWORDPROTECTED)
No hay soporte para el filtrado de notas fijadas
No se gestiona el estado de sincronización en la nube
Recuperación de contenido adjunto faltante
No hay soporte para el estado de la lista de verificación (ZHASCHECKLIST)
No hay posibilidad de crear o editar notas

Inicio rápido

Instalar el servidor

Se recomienda utilizar uv para instalar el servidor localmente para Claude.

uvx apple-notes-mcp

O

uv pip install apple-notes-mcp

Agregue su configuración como se describe a continuación.

Escritorio de Claude

En MacOS: ~/Library/Application\ Support/Claude/claude_desktop_config.json En Windows: %APPDATA%/Claude/claude_desktop_config.json

Nota: Es posible que necesites usar la ruta directa a uv . Usa which uv para encontrar la ruta.

Configuración de servidores no publicados/desarrollo

"mcpServers": {
  "apple-notes-mcp": {
    "command": "uv",
    "args": [
      "--directory",
      "{project_dir}",
      "run",
      "apple-notes-mcp"
    ]
  }
}

Configuración de servidores publicados

"mcpServers": {
  "apple-notes-mcp": {
    "command": "uvx",
    "args": [
      "apple-notes-mcp"
    ]
  }
}

Permisos de disco de Mac OS

Necesitará otorgar acceso total al disco del servidor. Esto se debe a que la base de datos SQLite de Apple Notes está anidada en el sistema de archivos de macOS.

Es posible que en el futuro considere una solución AppleScript si esto me molesta más o si quiero comenzar a agregar/agregar a Apple Notes.

Desarrollo

Construcción y publicación

Para preparar el paquete para su distribución:

Sincronizar dependencias y actualizar el archivo de bloqueo:

uv sync

Distribuciones de paquetes de compilación:

uv build

Esto creará distribuciones de origen y de rueda en el directorio dist/ .

Publicar en PyPI:

uv publish

Nota: Deberás configurar las credenciales de PyPI a través de variables de entorno o indicadores de comando:

Token: --token o UV_PUBLISH_TOKEN
O nombre de usuario/contraseña: --username / UV_PUBLISH_USERNAME y --password / UV_PUBLISH_PASSWORD

Depuración

Dado que los servidores MCP se ejecutan en stdio, la depuración puede ser complicada. Para una experiencia óptima, recomendamos usar el Inspector MCP .

Puede iniciar el Inspector MCP a través de npm con este comando:

npx @modelcontextprotocol/inspector uv --directory {project_dir} run apple-notes-mcp

Al iniciarse, el Inspector mostrará una URL a la que podrá acceder en su navegador para comenzar a depurar.

Licencia

Este proyecto está licenciado bajo la Licencia MIT. Consulte el archivo de LICENCIA para más detalles.

Código fuente

El código fuente está disponible en GitHub .

Contribuyendo

Envíeme sus ideas y comentarios a través de Bluesky o abriendo un problema.

This server cannot be installed

-

security - not tested

A

license - permissive license

-

quality - not tested

Permite que la IA lea desde su base de datos local de Apple Notes (solo macOS)